讲师中心 微信公众号
AI工具推荐 视频效率加速

Nginx 怎么在 Virtual Host 中配置状态监控 stub_status 模块采集指标

浅枫小哥_8614

浅枫小哥_8614

发布时间:2026-08-15 09:34:01

|

768人浏览过

|

来源于php中文网

原创

Nginx的stub_status模块无法按域名统计,仅提供worker进程级全局指标;可在server块中配置location=/nginx-status安全暴露整体状态,推荐用nginx-module-vts实现原生vhost维度监控。

nginx 怎么在 virtual host 中配置状态监控 stub_status 模块采集指标

Nginx 的 stub_status 模块不能真正“绑定到某个 Virtual Host 并只统计该域名的流量”,因为它统计的是整个 worker 进程级别的全局指标,与 server_name 或 $host 无关。但你可以在某个 server 块中安全暴露 /nginx-status 接口,用于监控该 Nginx 实例的整体运行状态——这是生产中最常用、最稳妥的做法。


✅ 在 Virtual Host 中启用 stub_status 接口

只需在目标 server 块内添加一个专用 location,例如:

server {
    listen 80;
    server_name example.com;

    # 其他业务配置(root、proxy_pass 等)...

    location = /nginx-status {
        stub_status on;
        access_log off;
        allow 127.0.0.1;
        allow 10.10.20.50;  # 监控服务器 IP
        deny all;
    }
}
  • 使用 = 精确匹配路径,避免被其他 location 规则覆盖
  • access_log off 防止状态页访问刷爆日志
  • allow/deny 必须成对出现,严禁留空或写 allow all
  • 重启生效:nginx -s reload

访问 http://example.com/nginx-status 即可看到三行文本输出,例如:

Nginx Hosting
Nginx Hosting

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

下载
Active connections: 42
server accepts handled requests
123456 123456 654321
Reading: 0 Writing: 3 Waiting: 39

? 各字段含义要清楚

  • Active connections:当前所有活跃连接总数(含 Reading/Writing/Waiting)
  • accepts:Nginx 启动以来接受的 TCP 连接总数
  • handled:成功处理并关闭的连接数(等于或略小于 accepts)
  • requests:实际处理的 HTTP 请求总数(一个连接可发多个请求)
  • Reading:正在读取请求头的连接数
  • Writing:正在向客户端发送响应的连接数
  • Waiting:keep-alive 空闲连接数(仅当 keepalive_timeout 启用时非零)

这些值全部是进程级累加值,不是按域名切分的。


⚠️ 为什么不能按域名独立统计?

  • stub_status 是模块级功能,不识别 server_name、$host 或任何变量
  • 所有 server 块共享同一个 worker 进程的共享内存统计数据
  • 即使你在多个 server 块里都配了 /nginx-status,返回的数据也完全一样

所以:
❌ 无法通过修改 server 块配置让 stub_status 只统计某个域名
✅ 但可以为不同域名部署独立 Nginx 实例(监听不同端口或用户),各自启用 stub_status


? 更实用的替代方案(推荐)

如果确实需要按域名维度监控:

  • 优先选用 nginx-module-vts
    它原生支持 vhost_traffic_status on;,自动按 server_name 统计请求数、响应码、响应时间等,并提供 JSON 和 HTML 页面。配置简单,适合生产环境。

  • 结合 access_log + 脚本聚合
    开启 log_format 记录 $host $request_time $status,再用 awk 或 Python 按域名提取趋势数据(适合离线分析或低频统计)。

  • 拆实例隔离
    关键业务单独跑一个 Nginx 实例(不同 pid、conf、user),彻底物理隔离指标来源。


? 安全提醒(必须做)

  • 切勿将 /nginx-status 暴露在公网,它不支持认证,仅靠 IP 白名单防护
  • 不要用 /status、/nginx_status 等常见路径,改用 _nxs、/healthz 等非标准路径降低扫描风险
  • 若需人工查看,建议走反向代理 + auth_basic(如 auth_basic "Nginx Status")加固

不复杂但容易忽略。

热门AI工具

更多
咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

403

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3447

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

6145

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

561

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1476

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3958

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

122

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

477

2026.01.13

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

40

2026.10.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn