stub_status无法按域名独立统计,因其仅提供worker进程级全局指标;可行方案包括:①为各域名部署独立Nginx实例;②结合access_log与脚本按$host聚合;③推荐使用nginx-module-vts模块实现原生域名维度监控。

要在 Nginx 中为基于域名的虚拟主机(server 块)单独开启 stub_status 监控,实现按域名统计独立连接与请求流量,需注意:stub_status 不支持直接绑定到某个 server 块并仅统计该域名的请求。它是模块级功能,统计的是当前 worker 进程处理的所有请求。但可通过合理配置,让每个域名“独占”一个 location 或端口,并结合反向代理/隔离部署等方式,逼近“独立监控”目标。
理解 stub_status 的作用范围
stub_status 是 Nginx 的内置状态模块(需编译时启用 --with-http_stub_status_module),它只提供当前 worker 进程的实时汇总指标:
- Active connections:当前活跃连接数
- accepts / handled / requests:累计接受、成功处理、实际处理的 HTTP 请求总数
- Reading / Writing / Waiting:当前各阶段连接数(Waiting 通常对应 keepalive 空闲连接)
这些值不是按 server 或 location 切分的,而是整个 worker 共享。因此,多个域名共用同一 worker 时,无法直接从 stub_status 区分 A 域名和 B 域名的请求数。
实现“按域名独立监控”的可行方案
虽不能原生隔离,但以下方法可满足运维中常见的独立观测需求:
- 为每个关键域名部署独立 Nginx 实例:使用不同 user、pid 文件、配置目录和监听端口(如 8081、8082),各自启用 stub_status。这是最彻底的隔离方式,适合核心业务或资源可控环境。
-
用 location + auth_basic 限制 stub_status 访问,并配合日志+脚本聚合:在每个 server 块内定义专用 status location(如
location = /status),并通过allow/deny控制访问;再结合 access_log 的$host和$request字段,用 logrotate + awk/Python 按域名提取请求频次、响应码等趋势数据。 -
借助第三方模块如 nginx-module-vts(Nginx Virtual Host Traffic Status):该模块扩展了 stub_status,支持按 server、upstream、cache 等维度统计,并提供 JSON 接口和 Dashboard。只需在 server 块中配置
vhost_traffic_status on;即可自动采集各域名指标,推荐用于生产环境精细化监控。
正确配置 stub_status(基础示例)
若仍需启用基础 stub_status,务必限制访问权限,避免暴露敏感信息:
server {
listen 80;
server_name example.com;
<pre class="brush:php;toolbar:false;">location = /nginx-status {
stub_status on;
allow 127.0.0.1; # 仅允许本地访问
allow 192.168.10.0/24; # 或指定运维网段
deny all;
}
# 其他业务配置...
}
访问 http://example.com/nginx-status 将返回纯文本状态页。注意:stub_status 不支持 HTTPS 下的 SNI 多域名共存时的精确归属——它始终反映后端 worker 的整体负载。
替代建议:优先使用 vts 模块
对于需要真实按域名拆分监控的场景,强烈建议替换为 nginx-module-vts:
- 编译进 Nginx 或作为动态模块加载
- 全局开启:
vhost_traffic_status_zone;(放在 http 块) - 每个 server 块自动纳入统计,无需额外配置
- 访问
/status可查看所有 server 的 requests、in_bytes、out_bytes、responses 等明细 - 支持 Prometheus exporter,便于接入 Grafana
这样既能保留原有虚拟主机结构,又能获得真正按域名粒度的实时流量视图。










