跳转到内容

Header Rewrite ​

在 experimental.http_rewrite.header_rewrite 中设置头部规则。phase 为 request 或 response,匹配规则按数组顺序执行。

添加一个请求头 ​

json
{
  "experimental": {
    "http_rewrite": {
      "enabled": true,
      "header_rewrite": [
        {
          "name": "Mark debug traffic",
          "pattern": "^https://api\\.example\\.test/",
          "phase": "request",
          "operation": "add",
          "header": "X-Debug",
          "value": "B-box"
        }
      ]
    }
  }
}

将域名换成目标服务,并配置该域名的 MITM。预期发给上游的请求包含 X-Debug: B-box。想修改返回客户端的响应,就把 phase 改为 response。

四种操作 ​

operation字段效果
addheader、value追加一项,保留重复字段
deleteheader删除该字段
replaceheader、value只替换已存在字段,不自动新增
replace_regexheader、regex、replacement按正则替换已有字段值

覆盖或新增一个普通字段,可以先 delete 再 add,避免重复头。只用 replace,字段原本不存在时不会出现新值。

删除后设置确定的值 ​

下面是 header_rewrite 数组中的两条规则,依次执行:

json
[
  {
    "pattern": "^https?://api\\.example\\.test/",
    "phase": "response",
    "operation": "delete",
    "header": "Cache-Control"
  },
  {
    "pattern": "^https?://api\\.example\\.test/",
    "phase": "response",
    "operation": "add",
    "header": "Cache-Control",
    "value": "no-store"
  }
]

预期响应只使用新设定的 Cache-Control 值。缓存策略还可能受客户端自身行为影响。

正则替换字段值 ​

下面是一条规则对象,放入 header_rewrite 数组:

json
{
  "pattern": "^https?://api\\.example\\.test/",
  "phase": "request",
  "operation": "replace_regex",
  "header": "User-Agent",
  "regex": "DemoApp/[0-9.]+",
  "replacement": "DemoApp/2.0"
}

Host 与受保护的字段 ​

请求 Host 只允许 replace / replace_regex。要改变实际请求目的地,通常使用 URL Rewrite 或 Map Remote;单独修改 Host 不能等同于切换网络目标。

以下分帧与升级字段由引擎管理,不允许手动改写:Content-Length、Transfer-Encoding、Trailer、Connection、Proxy-Connection、Upgrade。改变正文后,引擎会重算相应长度和元数据。

重复响应头由 HTTP 转发保留。脚本需要处理重复头时,可开启 full_headers。

B-box 中文指南 · 基于实际源码整理