HTTP 请求标头 - ZeroNews 文档

在流量转发前后自动注入、修改或删除指定的 HTTP Header，无需变动本地业务代码。仅支持 HTTPS 协议隧道，订阅后可在流量策略中配置，通过 YAML 编写规则，系统自动解析并下发至网关。

前置条件

配置项	说明
启用	开关控制，关闭时 YAML 规则不生效
YAML 编辑器	编写 HTTP Header 修改规则，需遵循严格的 YAML 缩进格式（空格而非 Tab）

规则支持三种操作，可分别作用于请求（request）和响应（response）：

操作	效果
`set`	覆盖或新增 Header（存在则覆写，不存在则新增）
`add`	强制追加 Header（允许重复存在多个同名 Header）
`remove`	移除指定的 Header

进入 控制台 → 隧道管理，找到目标隧道，点击隧道右侧 流量策略 菜单，展开流量策略配置页面，点击 HTTP Header 选项。

点击右上角编辑，系统弹出配置侧边栏。

将启用开关点击打开，激活 YAML 规则。 HTTP Header 策略开启时，显示为 active，HTTP Header 策略关闭时，显示为 deactive。

在 HTTP Header YAML 编辑器中编写规则，模板结构如下：

request:
  set:
    X-Request-Id: demo
  add:
    X-Forwarded-Proto: https
  remove:
    - X-Debug

response:
  add:
    X-Served-By: zeronews

常见场景示例：

response:
  set:
    Access-Control-Allow-Origin: "*"

response:
  set:
    Server: "ZeroNews-Secure-Gateway"

点击保存，系统自动校验 YAML 语法并通过后，规则实时下发至网关。如需放弃改动，点击取消关闭即可。