Nginx反向代理OpenProject时sub_filter替换不生效如何解决

从你贴的nginx -V输出看，已经编译了--with-http_sub_module，模块本身不存在缺失问题，配置不生效是以下几个典型错误导致的：

• 后端返回压缩响应，sub_filter直接跳过处理
  这是最常见的诱因：ngx_http_sub_module不会自动解压gzip/brotli压缩的响应内容，只要OpenProject返回的响应带Content-Encoding: gzip头，替换逻辑就完全不会执行，debug日志也不会记录任何替换操作。
  修复：在location块中添加配置，告诉后端不要返回压缩内容：

  proxy_set_header Accept-Encoding "";
  

• sub_filter默认生效范围太窄
  默认规则下sub_filter只会替换text/html类型的响应，OpenProject的JS、CSS、JSON接口响应里也可能存在硬编码的绝对URL，这部分内容默认不会被处理。
  修复：添加配置放开MIME类型限制：

  sub_filter_types *;
  

• 替换规则配置不合理
  你当前开了sub_filter_once on，只会替换响应中第一个匹配到的字符串，遇到多个硬编码URL就会漏替换；同时单条匹配规则很容易漏过带端口、带不同路径前缀的内部URL变体。
  修复：关闭单次替换，按需补全匹配规则：

  sub_filter_once off;
  # 可并列写多条替换规则适配不同的内部URL格式
  sub_filter 'http://<internal-host>' 'https://<external-url>';
  

• 反向代理头配置错误（根源问题）
  你当前传给后端的Host头是内部主机地址，OpenProject本身原生支持反向代理部署，只要传对代理头，应用会直接生成正确的外部访问URL，完全不需要依赖sub_filter做字符串替换。
  把原有proxy_set_header Host <internal host>;替换为以下配置：

  proxy_set_header Host <external-domain>;
  proxy_set_header X-Forwarded-Proto https;
  proxy_set_header X-Forwarded-Host <external-domain>;
  proxy_set_header X-Forwarded-Port 443;
  proxy_redirect off;
  

修正后可直接使用的配置参考 #

location /openproject/ {
    # 基础代理配置
    proxy_set_header Host <your-external-domain>;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto https;
    proxy_set_header X-Forwarded-Host <your-external-domain>;
    proxy_set_header X-Forwarded-Port 443;
    proxy_pass http://<your-internal-host>/openproject/;
    proxy_redirect off;

    # sub_filter兜底替换配置
    proxy_set_header Accept-Encoding "";
    sub_filter_types *;
    sub_filter_once off;
    sub_filter_last_modified on;
    sub_filter 'http://<your-internal-host>' 'https://<your-external-domain>';
}

配置修改完成后先执行nginx -t校验语法，确认无误后执行nginx -s reload重载配置即可生效。

内容的提问来源于stack exchange，提问作者baradhili