http_sub_module

# http_sub_module
可以根据条件来替换response body中的关键字，可以用来打码，修改响应内容等，比如网站突然改了域名，那么就以旧域名为关键字替换为新的域名，或者关于某某的内容需要隐藏我们就替换为`■`等等。

`I'm ■■!`

比如将本站使用的项目MrDoc的首页替换为本站的IP。

只需要在相应的nginx配置文件中添加sub_filter_*相关配置即可：

```
  location / {
    proxy_pass http://10.1.2.3:10000;
    proxy_buffering off;
    proxy_set_header Host $http_host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    # 避免后端返回gzip内容,会导致无法替换，应该与下面的more_clear_headers一同使用
    proxy_set_header Accept-Encoding '';
    # 避免浏览器解析nginx返回的数据错误"net::ERROR_CONTENT_DECODING_FAILED 200"
    more_clear_headers 'Content-Encoding';
    # 替换的响应类型，*好为全部
    sub_filter_types *;
    # 只替换content-type为text/css中的内容
    # sub_filter_types text/css;
    # 替换的关键字以及替换后的内容
    sub_filter 'wiki.ihoiwan.com:3002'  'wiki.ihoiwan.com:3002';
    # 替换一次即结束？off为全部替换
    sub_filter_once off;
  }
```

# 问题
在使用模块时可能会遇到下面的报错：

![](/media/202206/2022-06-17_154817_855033.png)

此时我们看到资源的响应中`Content-Encoding: gzip`，那么极有可能是因为浏览器拿到的数据实际上不是gzip压缩后的数据，不需要用gzip解压后decode而是元数据，浏览器直接decode即可。

![](/media/202206/2022-06-17_155811_426507.png)

这时候就要增加另一个模块`headers-more-nginx-module`的配置：`more_clear_headers 'Content-Encoding';`，用来清掉`Response Header`中的`Content-Encoding`，让浏览器正确的知道nginx返回的是元数据而不是压缩后的数据。

如此就能解决响应数据编码不一致的问题。