启用 Stub Status 模块需在 configure 阶段显式添加 --with-http_stub_status_module 参数，安装后用 nginx -V | grep 检查；配置中须在 server 块内设 location /nginx_status { stub_status on; } 并限制访问。

编译安装 Nginx 时启用 Stub Status 模块，关键是在 configure 阶段显式添加 --with-http_stub_status_module 参数，该模块不默认开启，必须手动指定才能编译进二进制文件。

确认是否已启用该模块

安装完成后，运行以下命令检查：

• nginx -V 2>&1 | grep with-http_stub_status_module
• 如果有输出，说明模块已编译成功；无输出则未启用，需重新编译

编译时加入 Stub Status 支持

在执行 ./configure 时，确保参数中包含该模块。例如：

Nginx Hosting

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

下载

• ./configure --prefix=/usr/local/nginx --with-http_ssl_module --with-http_stub_status_module
• 其他常用模块（如 realip、gzip）可一并添加，但 --with-http_stub_status_module 不可省略
• OpenResty 或 Alpine 官方镜像等精简版常默认不带此模块，务必单独验证

配置 location 启用状态页

模块编译成功后，还需在 Nginx 配置中启用功能：

• 只能放在 server 块内，不能写在 http 或 upstream 块顶层
• 示例配置：
  

  location /nginx_status {<br>
    stub_status on;<br>
    access_log off;<br>
    allow 127.0.0.1;<br>
    deny all;<br>
  }

• 务必限制访问来源（如仅允许本地或内网），禁止公网暴露

验证状态页是否生效

重载配置后，用 curl 测试：

• curl http://127.0.0.1/nginx_status
• 正常返回类似：
  

  Active connections: 3<br>
  server accepts handled requests<br>
   12345 12345 67890<br>
  Reading: 0 Writing: 1 Waiting: 2

• 若提示 unknown directive "stub_status"，说明模块未编译，不是配置问题