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

前置条件

  • 已订阅 HTTP 请求标头插件(参见 集成中心
  • 已创建至少一条隧道

核心配置项

配置项说明
启用开关控制,关闭时 YAML 规则不生效
YAML 编辑器编写 HTTP Header 修改规则,需遵循严格的 YAML 缩进格式(空格而非 Tab)
规则支持三种操作,可分别作用于请求(request)和响应(response):
操作效果
set覆盖或新增 Header(存在则覆写,不存在则新增)
add强制追加 Header(允许重复存在多个同名 Header)
remove移除指定的 Header

操作步骤

1. 进入配置页

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

2. 进入编辑模式

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

3. 启用策略

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

4. 编写 YAML 规则

在 HTTP Header YAML 编辑器中编写规则,模板结构如下:
request:
  set:
    X-Request-Id: demo
  add:
    X-Forwarded-Proto: https
  remove:
    - X-Debug

response:
  add:
    X-Served-By: zeronews
常见场景示例:
  • 解决跨域(CORS):在 response 下添加允许跨域头
response:
  set:
    Access-Control-Allow-Origin: "*"
  • 隐藏后端服务器信息:替换 Server 头防止信息泄露
response:
  set:
    Server: "ZeroNews-Secure-Gateway"

5. 保存生效

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