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 重新載入或重啟後維持統計資料的持久性。

快速開始

  1. 複製儲存庫: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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/vozltnginx-module-vts.svg)](https://yunodb.com/tools/vozltnginx-module-vts?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/vozltnginx-module-vts?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/vozltnginx-module-vts.svg" alt="Featured on YunoDB" height="20"></a>