nginx如何添加http_stub_status_module模块

http_stub_status_module 是 Nginx 的一个内置模块，用于提供基本的 Nginx 状态信息。通过启用该模块，用户可以监控 Nginx 的运行状态，包括活跃连接数、请求处理情况等。本文将详细介绍如何在 Nginx 中添加和启用 http_stub_status_module 模块。

1. 检查是否已启用 http_stub_status_module

在开始之前，首先需要确认当前 Nginx 是否已经启用了 http_stub_status_module 模块。可以通过以下命令查看：

nginx -V 2>&1 | grep -- 'http_stub_status_module'

如果输出中包含 --with-http_stub_status_module，则表示该模块已经启用。如果没有输出，则需要手动添加该模块。

2. 重新编译 Nginx 以添加 http_stub_status_module

如果 http_stub_status_module 模块未启用，则需要重新编译 Nginx 并添加该模块。以下是具体步骤：

2.1 下载 Nginx 源码

首先，确保你已经下载了与当前安装版本相同的 Nginx 源码。可以从 Nginx 官方网站 下载。

wget http://nginx.org/download/nginx-1.20.1.tar.gz
tar -zxvf nginx-1.20.1.tar.gz
cd nginx-1.20.1

2.2 配置编译选项

在编译之前，需要配置 Nginx 的编译选项。可以通过以下命令查看当前 Nginx 的编译选项：

nginx -V

复制输出的配置选项，并在重新配置时添加 --with-http_stub_status_module 选项。例如：

./configure --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib64/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --http-client-body-temp-path=/var/cache/nginx/client_temp --http-proxy-temp-path=/var/cache/nginx/proxy_temp --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp --http-scgi-temp-path=/var/cache/nginx/scgi_temp --user=nginx --group=nginx --with-compat --with-file-aio --with-threads --with-http_addition_module --with-http_auth_request_module --with-http_dav_module --with-http_flv_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_mp4_module --with-http_random_index_module --with-http_realip_module --with-http_secure_link_module --with-http_slice_module --with-http_ssl_module --with-http_stub_status_module --with-http_sub_module --with-http_v2_module --with-mail --with-mail_ssl_module --with-stream --with-stream_realip_module --with-stream_ssl_module --with-stream_ssl_preread_module --with-cc-opt='-O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector-strong --param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic -fPIC' --with-ld-opt='-Wl,-z,relro -Wl,-z,now -pie'

2.3 编译并安装 Nginx

配置完成后，使用以下命令编译并安装 Nginx：

make
sudo make install

2.4 替换旧的 Nginx 二进制文件

编译完成后，新的 Nginx 二进制文件将生成在 objs/ 目录下。可以使用以下命令替换旧的 Nginx 二进制文件：

sudo cp objs/nginx /usr/sbin/nginx

2.5 重启 Nginx

最后，重启 Nginx 以应用更改：

sudo systemctl restart nginx

3. 配置 http_stub_status_module

在 Nginx 配置文件中添加以下内容以启用 http_stub_status_module：

server {
    listen 80;
    server_name localhost;

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

此配置将在 http://localhost/nginx_status 提供一个状态页面，仅允许本地访问。

4. 验证 http_stub_status_module 是否正常工作

通过浏览器或命令行访问 http://localhost/nginx_status，如果看到类似以下的输出，则表示 http_stub_status_module 已成功启用：

Active connections: 1 
server accepts handled requests
 10 10 20 
Reading: 0 Writing: 1 Waiting: 0 

5. 总结

通过以上步骤，你可以成功在 Nginx 中添加并启用 http_stub_status_module 模块。该模块提供了基本的 Nginx 状态信息，有助于监控和调试 Nginx 的运行情况。