跳转到内容

开启 HTTPS 解密 ​

MITM 让 B-box 在指定连接上终止客户端 TLS,再按配置连接上游。HTTP 改写和 HTTP 脚本处理 HTTPS 之前,需要先经过这一步。

启用前的三个条件 ​

  1. 目标请求经过 B-box 本地服务,并进入可处理的 TCP/TLS 连接。
  2. 已生成有效 CA,且目标客户端信任它。
  3. experimental.mitm.enabled 为 true,实际域名命中 hosts 以及可选端口、应用筛选。

如果只需要明文 HTTP 改写或 Cron 主动请求,不需要开启 MITM。

最小配置 ​

先完成证书准备,再将以下片段合并进自己的 sing-box 配置。把 api.example.test 换成目标域名。

下载 MITM 配置片段

json
{
  "experimental": {
    "mitm": {
      "enabled": true,
      "hosts": [
        "api.example.test"
      ],
      "tcp": false,
      "h2": true,
      "skip_server_cert_verify": false,
      "block_quic": true
    }
  }
}

保存并确认配置应用成功,让目标客户端重新建立连接。需要查看结果时,再到 工具 → 连接与请求 开始记录并发出新请求。

页面选项和 JSON 对应关系 ​

选项字段默认使用说明
解密 HTTPSenabledfalseMITM 总开关
解密域名hosts空列表空列表不解密;支持有序排除与通配符
HTTP/2 MITMh2true两端分别协商 HTTP 版本;可能一端 h2、一端 HTTP/1.1
跳过服务器证书校验skip_server_cert_verifyfalse只影响 B-box 对上游的校验,不能让目标 App 信任 B-box CA
解密非 HTTP TLS/TCPtcpfalse允许转发并记录解密后的非 HTTP TLS 字节流
QUIC 请求 TCP 回退block_quictrue对命中范围且能观察到名称的 QUIC 尝试促使客户端改用 TCP

ports 和 packages 可在 JSON 中追加,分别限制原始目的端口和应用;它们与 hosts 取交集。见域名与范围匹配。

HTTP/2 默认开启,以兼容只接受 h2 的 Android 客户端。已有配置中的显式 h2: false 仍然生效;此时只提供 h2 的连接原样透传,不会被降为 HTTP/1.1 或转为 TCP 解密。

TCP 解密不是 HTTP 改写 ​

开启 tcp 后,确定为非 HTTP 的 TLS 内容按字节流转发,记录标为 TLS/TCP,可按记录设置保存两个方向的字节。这类流没有 HTTP 状态码、Header 或 Cookie,不执行 HTTP 改写和 HTTP 脚本,也不能导出 HAR/cURL。

没有 ALPN 时,开启 TCP 解密会先识别完整 HTTP/1.x 请求行;识别为 HTTP 的流仍可进入正常 HTTP 处理。

HTTP/3 与 QUIC ​

B-box 不解密 HTTP/3。block_quic 只在 MITM 已启用、域名/端口/应用匹配且能恢复名称时拒绝对应 QUIC,尝试让客户端回退 TCP。它不阻断所有 UDP,也不保证客户端一定回退。

记录列表出现“仅域名”不代表解密成功;提取域名与 MITM 是独立能力。

支持边界 ​

支持 TLS 1.2/1.3、HTTP/1.1 和默认开启的 HTTP/2。任意私有加密协议、STARTTLS、真实 ECH、客户端证书认证和嵌套 CONNECT 不在当前解密范围内。

有证书固定校验或自有信任库的 App 可能拒绝连接。可在目标客户端配置对应信任,或参考 TrustMe 绕过 SSL Pinning;安装系统 CA 也不等于所有 App 都会接受。

下一步:域名与范围匹配 · 记录、详情与导出。

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