跳转到内容

Map Local / API Mock ​

Map Local 在命中后直接生成本地响应,适合固定 API 返回值、测试页面与静态资源。规则位于 experimental.http_rewrite.map_local,首条匹配生效。

返回一个 JSON ​

json
{
  "experimental": {
    "http_rewrite": {
      "enabled": true,
      "map_local": [
        {
          "name": "Mock status API",
          "pattern": "^https?://api\\.example\\.test/status$",
          "status": 200,
          "headers": [
            { "name": "Content-Type", "value": "application/json" }
          ],
          "data_type": "text",
          "data": "{\"ok\":true,\"source\":\"Map Local\"}"
        }
      ]
    }
  }
}

预期返回指定 JSON,无需上游生成内容。data 是字符串,所以内层 JSON 引号必须转义。HTTPS 仍需要启用并匹配 MITM、准备好 CA。

字段速查 ​

字段说明
pattern完整 URL 正则
status默认 200,允许 200~999;日常使用标准 HTTP 状态码即可
headers{name,value} 数组,可保留重复字段
data_typetext、base64、tiny-gif、file;省略按 text 兼容处理
data文本、Base64,或 file 类型的路径/URL
resource引用同一 http_rewrite.resources 中的命名资源

resource 与 data / data_type 互斥。不要把两种内容来源写在同一规则里。

复用资源 ​

json
{
  "experimental": {
    "http_rewrite": {
      "enabled": true,
      "map_local": [
        {
          "pattern": "/status$",
          "resource": "status.json",
          "headers": [
            { "name": "Content-Type", "value": "application/json" }
          ]
        }
      ],
      "resources": {
        "status.json": {
          "data_type": "text",
          "data": "{\"ok\":true}"
        }
      }
    }
  }
}

这里 /status$ 是简化路径匹配,会覆盖范围内所有以该路径结束的 URL。实际使用时建议加上明确域名。

图片与文件 ​

返回内置透明小 GIF,可使用单条规则:

json
{
  "pattern": "^https?://api\\.example\\.test/pixel$",
  "data_type": "tiny-gif"
}

读取文件或远程缓存,则将资源定义为:

json
{
  "data_type": "file",
  "data": "https://resources.example.test/status.json",
  "update_interval": 86400
}

这是一条放进 resources 字典的资源对象。file 同时支持相对配置目录的文件路径和 HTTP(S) URL;更新间隔属于资源对象。路径、缓存和失败行为见文件与远程资源。

和其他规则一起使用 ​

请求 Header、URL、Map Remote、Body 和请求脚本都排在 Map Local 之前。请求脚本已经生成 Mock 时,不再运行 Map Local。

Map Local 生成的响应仍经过响应 Header、Body/jq 和响应脚本。因此在固定模板上做二次变更是可行的。

HTTP 离线 Mock 可以不连接上游。HTTPS 仅在确定按 HTTP 处理且启用 HTTP 规则时采用支持离线 Mock 的握手路径;纯 MITM、原始 TCP 和待识别的无 ALPN 流仍可能先连接上游,不能据此推断所有 TLS 流都能离线使用。

需要分支判断或根据请求生成内容时,使用脚本动态 Mock。

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