nginx 强大的 sub filter

码龄2年

关注

原创最新推荐文章于 2026-07-17 08:00:00 发布 1.5k 阅读 GEO检测

避坑指南：Nginx代理Nuget时sub_filter失效的5种解决方法（含Gzip场景）本文深入剖析了使用Nginx反向代理Nuget服务时，sub_filter指令失效的五大常见原因，并提供了针对性的解决方案。重点讨论了上游启用Gzip压缩导致替换失败的核心问题，给出了强制获取明文或代理层解压两种配置策略，确保域名替换生效，实现透明的镜像加速。阅读详情

Nginx 的 sub_filter 是一个用来在响应内容中进行字符串替换的指令。它是 ngx_http_sub_module 模块的一部分，该模块允许你在服务器返回给客户端的响应中替换字符串。sub_filter 可以在 server、location 或 if 块中使用。

以下是一些使用 sub_filter 的示例和解释：

基本语法

sub_filter string replacement;

string：要替换的原始字符串。
replacement：用于替换原始字符串的新字符串。

示例配置

http {
    include       mime.types;
    default_type  application/octet-stream;

    server {
        listen       80;
        server_name  example.com;

        location / {
            proxy_pass http://backend_server;

            # 开启 sub_filter 模块
            sub_filter 'original_text' 'replacement_text';

            # 设置 sub_filter 替换所有匹配项
            sub_filter_once off;

            # 设置 sub_filter 的内容类型（可选）
            sub_filter_types text/html text/css;
        }
    }
}

解释

sub_filter 'original_text' 'replacement_text';：这行配置告诉 Nginx 在响应内容中找到 'original_text' 并将其替换为 'replacement_text'。
sub_filter_once off;：默认情况下，sub_filter 只会替换第一个匹配项。通过设置 sub_filter_once off;，你可以让 Nginx 替换所有匹配项。
sub_filter_types text/html text/css;：定义要应用 sub_filter 的 MIME 类型。默认是 text/html。