本文共 1149 字，大约阅读时间需要 3 分钟。

场景

在实际应用中，了解服务器运行状态和性能指标至关重要。这不仅有助于定位问题，还能优化资源分配，提升整体效率。Nginx作为高性能的HTTP服务器，提供了丰富的监控功能，其中一个是stub状态，这对于开发和运维人员来说非常有用。

stub状态模块的作用是快速返回服务器内部状态信息，这对于开发测试和状态监控都非常有帮助。通过stub状态，可以轻松获取服务器的版本信息、配置参数以及运行状态等关键数据。

实现

启用 Nginx stub 状态

要使用stub状态模块，首先需要在Nginx配置文件中启用相应的代码块。具体操作如下：

在Nginx的配置文件中找到`location /stub_status`的位置，添加stub_status模块：

location /stub_status {  
    stub_status;  
    allow 127.0.0.1;  
    deny all;  
    # 可以根据需要设置IP限制

完成后，restart Nginx服务，新的stub状态接口将在线上运行。

完整配置示例

以下是一个完整的Nginx配置示例，展示了如何在实际项目中应用stub状态模块：

server {  
    listen 80;  
    server_name 127.0.0.1;  
    charset koi8-r;  
    access_log logs/host.access.log main;  
    location / {  
        root D:/test/;  
        try_files $uri $uri/ /index.html;  
        index index.html index.htm;  
    }  
    location /stub_status {  
        stub_status;  
        allow 127.0.0.1;  
        deny all;  
        # 可以根据需要设置IP限制  
    }  
    error_page 500 502 503 504 /50x.html;  
    location = /50x.html {  
        root html;  
    }

在这个配置中，stub_status模块被成功添加到Nginx的处理逻辑中。通过访问`http://127.0.0.1/stub_status`，可以看到服务器的详细状态信息。

需要注意的是，默认情况下stub状态模块只允许127.0.0.1访问，其他IP地址会被拒绝。如果需要扩展访问权限，可以在`allow`指令中指定具体的IP地址。