Skip to content

重写器

3.3.0

重写器可以对HTTP请求和响应体进行动态修改，与内置的rewriteBody/rewriteResponseBody/rewriteRequestBody规则（基于正则匹配和替换）不同，重写器通过外部插件服务提供更灵活的修改能力。

使用重写器

重写器可以作为服务级配置，在services中引用：

services:
- name: service-0
  addr: :8080
  handler:
    type: auto
  listener:
    type: tcp
  rewriter: rewriter-0

rewriters:
- name: rewriter-0
  plugin:
    type: grpc
    addr: 127.0.0.1:8000

插件配置

plugin.type (string, default=grpc)
插件类型：grpc，http。
plugin.addr (string, required)
插件服务地址。
plugin.token (string)
认证信息，插件服务可以选择对此信息进行验证。
plugin.tls (object)
设置后将使用TLS加密传输。
plugin.timeout (duration)
请求超时时长。

HTTP插件

rewriters:
- name: rewriter-0
  plugin:
    type: http
    addr: http://127.0.0.1:8000/rewrite

请求体格式： 

{"data":"<base64原内容>","metadata":<元数据>}

响应体格式： 

{"ok":true,"data":"<base64修改后内容>"}

节点级重写器

重写器也可以在每个转发器节点的rewriteBody/rewriteResponseBody/rewriteRequestBody规则中使用：

forwarder:
  nodes:
  - name: target-0
    addr: example.com:80
    http:
      rewriteResponseBody:
      - type: text/html
        match: "Hello"
        replacement: "你好"
      rewriteRequestBody:
      - type: application/json
        rewriter: rewriter-0

当规则设置了rewriter后，body的修改将委托给重写器插件处理，match和replacement将被忽略。

当不使用rewriter时，match字段可以是：

  • 正则表达式（对原始 body 字节进行 regexp.ReplaceAll 替换）。replacement 支持 Go 正则替换语法（$1、$2 等）。
  • **json: 前缀**用于 JSON 路径字段匹配：json:<路径>[=<值正则>]。字段值通过 gjson 提取后与可选的值正则匹配，命中后通过 sjson 替换。
# 正则模式（现有行为）
rewriteRequestBody:
- match: '"model"\s*:\s*"[^"]*"'
  replacement: '"model":"deepseek-v4-pro"'

# JSON 路径模式 — 匹配任意 model 字段并替换
rewriteRequestBody:
- match: json:model
  replacement: deepseek-v4-pro

# JSON 路径模式 — 仅匹配特定 effort 值
rewriteRequestBody:
- match: json:output_config.effort=(xhigh|max)
  replacement: low

JSON 模式自动检测 application/json 内容类型，无需设置 type。

rewriter可以与type(内容类型过滤)结合使用，通过设置不同的type将不同类型的请求/响应体发送给不同的重写器处理。

Comments