nginx-module-vts
Nginx 虛擬主機流量狀態模組
nginx-module-vts 是什麼?
這是一個 Nginx 虛擬主機流量狀態模組,提供即時監控與顯示各虛擬主機的流量統計數據。
nginx-module-vts 概覽
這是什麼
nginx-module-vts 是一個開放原始碼的 Nginx 模組,提供虛擬主機的流量狀態資訊。它會顯示伺服器、上游伺服器與快取的當前狀態,功能類似 Nginx Plus 的即時活動監控。該模組能以 JSON、HTML、JSONP 或 Prometheus 格式輸出資料,並內建 HTML 儀表板。採用 BSD-2-Clause 授權,歸類於監控類別。
主要功能
- 提供每個虛擬主機的即時流量統計,包括請求次數、傳入/傳出位元組,以及回應狀態碼細分(1xx–5xx、快取命中/未命中等)。
- 透過
vhost_traffic_status_filter指令,支援依自訂鍵值(例如國家、使用者代理、儲存空間)過濾流量。 - 使用
vhost_traffic_status_limit及相關指令,可對伺服器、過濾器或上游伺服器進行流量限制。 - 透過查詢字串端點(
/status/control)提供即時控制功能,可重設或刪除流量區域。 - 支援多種輸出格式:JSON、HTML(內建儀表板)、JSONP 與 Prometheus。
- 包含請求延遲分佈的直方圖區間,並可設定平均計算方法。
- 可使用 gcc 的
-fprofile選項搭配設定檔引導最佳化(PGO)進行編譯。
使用情境
- 監控 Nginx 伺服器上個別虛擬主機的流量。
- 使用 GeoIP 資料計算各國家的流量。
- 追蹤每個儲存空間或使用者代理的流量。
- 詳細分析 HTTP 狀態碼(例如統計每個伺服器的 4xx/5xx 錯誤)。
- 動態 DNS 的流量統計。
- 將狀態頁面的流量排除在統計資料之外。
- 使用傾印功能在 Nginx 重新載入或重啟後維持統計資料的持久性。
快速開始
- 複製儲存庫:
shell> git clone git://github.com/vozlt/nginx-module-vts.git2. 將模組加入 Nginx 建置設定:--add-module=/path/to/nginx-module-vts3. 建置並安裝 Nginx 二進位檔。4. 在 Nginx 設定檔中,於http區塊啟用vhost_traffic_status_zone;,並設定狀態顯示的位置:location /status { vhost_traffic_status_display; vhost_traffic_status_display_format html;}
授權與價格
授權為 BSD-2-Clause。此模組為開放原始碼且免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。