Nginx中的stub_status和sub_filter指令分别有何妙用？（深入解析Nginx高级功能，提升服务性能）

赵其鑫 • 2024年 10月 28日 13:05:23 • 中间件

Nginx 是一款强大且灵活的 Web 服务器和反向代理软件，提供了众多高级功能来优化服务性能和安全性。本文将重点介绍 stub_status 和 sub_filter 这两个指令的用途和配置方法。

stub_status 指令用于启动一个简单的 HTTP 端点，提供关于 Nginx 工作状态的信息，包括活动连接数、等待连接数、总请求数等统计指标。这对于监控服务器的运行状况非常有用。

要在 Nginx 中启用 stub_status，通常在其 location 块中加入：

location /status {
    stub_status on;
    access_log off;
}

这样，通过访问 <nginx_ip>:<port>/status，就可以看到服务器的状态报告。注意应限制对该端点的访问，避免公开敏感信息给未经授权的用户。

为了增加安全性，可以限制访问此端点的 IP 地址：

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

现在，只有本地主机可以访问状态信息。

sub_filter 指令允许你在 Nginx 层面动态修改发送到客户端的 HTML 内容。这在不需要修改应用程序代码的情况下，就能实现在响应文本中的模式替换，比如插入广告、修复 HTML 错误、替换图片路径等。

假设你想将所有出现的 ‘old-url.com’ 替换成 ‘new-url.com’:

location / {
    sub_filter 'old-url.com' 'new-url.com';
    sub_filter_once off;  # 保证全文扫描，而非仅首次出现
}

需要注意的是，sub_filter 的效率不如在源代码层面做改动，尤其是在大规模使用或复杂替换逻辑时，可能会影响性能。因此，应在必要时谨慎使用，并考虑其替代方案。

有时候，sub_filter 可以配合 map 和 if 指令来实现更复杂的逻辑，比如条件性的替换或基于变量的模式匹配。

map $http_host $domain {
    default "";
    "~*^old-site.com$" "new-site.com";
}

location / {
    sub_filter $domain $domain;
}

这里，仅在请求来源于旧域名时才进行替换。

stub_status 和 sub_filter 分别提供了监控和服务内容的动态修改能力，增强了 Nginx 的灵活性和功能性。正确运用这两个特性，可以显著提升网站的维护效率和用户体验。然而，要注意配置的性能影响和安全性考量，避免引入新的风险或降低服务稳定性。