实战演示 Nginx 结合 VTS 模块实现基于 server_name 维度的流量监控与展示-Nginx-PHP中文网

VTS模块是实现server_name维度Nginx流量监控与可视化的关键方案：支持按域名统计请求量、状态码、流量、响应时间等指标，提供JSON/API和HTML页面，需启用vhost_traffic_status_filter_by_host on并正确配置server_name。

实战演示 nginx 结合 vts 模块实现基于 server_name 维度的流量监控与展示

要实现基于 server_name 维度的 Nginx 流量监控与可视化展示，核心是使用 Nginx VTS（Virtual Host Traffic Status）模块，它能按虚拟主机（即每个 server 块的 server_name）统计请求量、响应状态码、流量带宽、连接数等关键指标，并提供 JSON 接口和内置 HTML 页面。

一、编译安装支持 VTS 的 Nginx

VTS 不是官方模块，需在编译 Nginx 时手动添加。推荐使用主流稳定版本（如 Nginx 1.20+），并确保系统已安装编译依赖（gcc、make、pcre-devel、zlib-devel、openssl-devel）。

操作步骤：

克隆 VTS 模块源码：git clone https://github.com/vozlt/nginx-module-vts.git
下载对应 Nginx 源码（如 nginx-1.22.1.tar.gz），解压后进入目录
执行配置命令（路径按实际调整）：
./configure --add-module=/path/to/nginx-module-vts --with-http_ssl_module --with-http_gzip_static_module
运行 make && sudo make install

验证是否加载成功：nginx -V 2>&1 | grep -o vts 应输出 vts。

二、Nginx 配置启用 VTS 并按 server_name 区分统计

在 http 块中启用 VTS 模块，并为每个 server 块设置唯一且有意义的 server_name（如 api.example.com、www.example.com）。VTS 默认即按 server_name 自动聚合数据，无需额外标记。

示例配置片段：

http {
    vhost_traffic_status_zone;  # 必须声明，启用统计区
    vhost_traffic_status_filter_by_host on;  # 关键：开启按 host（即 server_name）过滤
<pre class="brush:php;toolbar:false;">server {
    listen 80;
    server_name api.example.com;
    location / {
        proxy_pass http://backend_api;
    }
}

server {
    listen 80;
    server_name www.example.com;
    location / {
        root /var/www/html;
    }
}

# 暴露监控页面和 API（建议加访问控制）
server {
    listen 127.0.0.1:8080;
    location /status {
        vhost_traffic_status_display;
        vhost_traffic_status_display_format html;  # 或 json
    }
    location /status/format/json {
        vhost_traffic_status_display;
        vhost_traffic_status_display_format json;
    }
}

}

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

注意：vhost_traffic_status_filter_by_host on 是实现 server_name 维度统计的关键开关；若关闭，所有 server 将合并为一个默认组。

三、访问监控数据与解读 server_name 维度指标

重启 Nginx 后，可通过以下地址查看：

HTML 页面：http://127.0.0.1:8080/status —— 直观表格，每行对应一个 server_name，显示总计数、实时 QPS、2xx/4xx/5xx 分布、接收/发送字节数等
JSON 接口：http://127.0.0.1:8080/status/format/json —— 返回结构化数据，serverZones 字段下以 server_name 为 key，值为该域名全部指标对象

JSON 示例节选：

"serverZones": {
  "api.example.com": {
    "requestCounter": 12489,
    "inBytes": 32456789,
    "outBytes": 189045672,
    "responses": { "1xx": 0, "2xx": 11234, "3xx": 45, "4xx": 876, "5xx": 34 },
    "requestMsecCounter": 12489,
    "requestMsec": 145.6
  },
  "www.example.com": { ... }
}

该结构天然支持按域名做聚合分析、告警阈值设定或对接 Grafana（通过 Prometheus Exporter 或直接调用 JSON）。