在 nginx 源码编译时添加 stub_status 模块,需要在执行 ./configure 命令时加入 --with-http_stub_status_module 参数。该模块是 nginx 的内置模块,默认已包含在源码包中,只需在配置阶段显式启用即可生成支持监控状态的 nginx 二进制文件。

如何验证模块是否成功编译进 Nginx
编译完成后,可以通过运行 nginx -V 命令来查看当前 Nginx 二进制文件的详细配置信息。如果输出结果中包含 --with-http_stub_status_module,则说明模块已成功集成。这一步骤至关重要,因为即使编译通过,若未正确链接该模块,Nginx 也无法提供状态页面服务。

./configure --prefix=/usr/local/nginx --with-http_stub_status_module make sudo make install nginx -V
上述代码展示了完整的编译流程。首先使用 ./configure 指定安装路径并启用 stub_status 模块,接着执行 make 进行编译,最后通过 sudo make install 完成安装。编译结束后,nginx -V 的输出将确认模块的存在。预期结果是终端打印出包含 --with-http_stub_status_module 的配置字符串,且无报错信息。
如何在 Nginx 配置文件中启用 stub_status 页面
模块编译成功后,还需要在 Nginx 的配置文件(如 nginx.conf)中定义一个 location 块来暴露状态接口。通常将该位置设置为 /status,并使用 stub_status 指令开启功能。为了安全起见,建议限制访问来源,仅允许内网或特定 IP 访问该接口。

server {
listen 80;
server_name example.com;
location /status {
stub_status;
allow 192.168.1.0/24;
deny all;
}
}这段配置片段展示了一个典型的服务器块设置。在 location /status 中,stub_status 指令激活了状态报告功能。同时,allow 和 deny 指令用于控制访问权限,确保只有来自 192.168.1.0/24 网段的请求能够获取数据,其他所有请求将被拒绝。重启 Nginx 后,访问 http://example.com/status 即可看到当前的连接统计信息,包括活跃连接数、总接受连接数等关键指标。
stub_status 返回的具体数据字段含义是什么
当访问配置的 /status 接口时,Nginx 会返回一段纯文本格式的状态信息。这些数据对于监控系统负载和排查问题非常有用。主要包含三个部分:Active connections(活跃连接数)、Server accepts handled requests(服务器处理情况)以及 Reading/Writing/Waiting(连接状态分布)。
具体而言,Active connections 表示当前处于活跃状态的客户端连接总数。Server accepts 是自启动以来总共处理的 TCP 握手次数,handled 是成功处理的连接数,若两者不一致可能意味着有连接被丢弃。requests 则是总共处理的 HTTP 请求数量。下方的 Reading 表示正在读取客户端请求头的连接数,Writing 表示正在向客户端发送响应数据的连接数,Waiting 表示保持长连接且正在等待下一个请求的空闲连接数。这些数值实时反映 Nginx 的运行状态,帮助管理员判断是否存在连接积压或性能瓶颈。


















