Linux 上为 Nginx 启用 stub_status 模块需先确认模块已内置(通过 nginx -V | grep with-http_stub_status_module 验证),再在 server 块中配置 location /nginx-status { stub_status on; access_log off; allow 127.0.0.1; deny all; },最后 nginx -t 校验并 systemctl reload nginx 生效。

Linux 上为 Nginx 启用 stub_status 模块,核心在于确认该模块已编译进 Nginx(默认多数发行版预编译版本已包含),然后正确配置 location 并开放访问控制。它不需额外安装,但必须启用并安全暴露。
确认 stub_status 模块是否可用
该模块是 Nginx 的标准 HTTP 模块(--with-http_stub_status_module),通常随官方包一同编译,无需单独安装。验证方式:
- 运行
nginx -V 2>&1 | grep -o with-http_stub_status_module,若输出该字符串,说明已内置; - 或执行
nginx -V查看完整 configure 参数,确认含--with-http_stub_status_module; - 若无输出或报错“unknown directive ‘stub_status’”,可能是精简版(如某些 Alpine 或自编译未启用)——此时需重新编译 Nginx。
在 server 块中配置 stub_status location
在你的站点配置(如 /etc/nginx/conf.d/default.conf 或 /etc/nginx/sites-enabled/xxx)中添加一个专用 location:
- 推荐放在
server块内、监听 80 或 443 的上下文中; - 示例配置:
location /nginx-status {
stub_status on;
access_log off;
allow 127.0.0.1; # 仅允许本地访问
allow 192.168.1.100; # 可选:加信任内网 IP
deny all; # 拒绝其余所有
}注意:stub_status on 是必需指令(Nginx 1.9.2+ 支持更简洁写法,旧版需保留 on);access_log off 避免日志刷屏;allow/deny 必须显式设置,否则默认拒绝(尤其开启 auth_basic 时易被忽略)。
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI,零 GUI 开销。
测试配置并重载 Nginx
配置完成后务必验证语法和重启服务:
- 运行
nginx -t检查配置是否合法; - 若通过,执行
systemctl reload nginx(或nginx -s reload)生效; - 本地测试:
curl http://localhost/nginx-status应返回类似:
Active connections: 2 server accepts handled request 10 10 10 Reading: 0 Writing: 1 Waiting: 1
三行数字分别表示:已接受连接数、已处理连接数、已处理请求总数;最后一行是当前各状态连接数。
安全注意事项与常见问题
stub_status 泄露实时连接与请求统计,不可公开暴露:
- 切勿使用
allow all或省略访问控制; - 避免放在 root location 或未鉴权的公网路径下;
- 若需远程监控,建议配合反向代理 + Basic Auth 或防火墙白名单(如 iptables/nftables 限制源 IP);
- 某些云环境(如 Docker 容器)需确保端口映射未意外暴露该路径;
- 如果返回 404,检查 location 路径是否拼写一致(大小写敏感)、是否在正确的 server 块中、Nginx 是否已重载。

















