证书桥

简体中文

English

简体中文

English

Appearance

常见问题 ​

按场景查阅。改配置请用 WebUI 或 CLI；键名见 配置说明。

安装与更新 ​

模块从哪里下载？ ​

GitHub Releases。选 *_arm64.zip（推荐）或 *_arm32.zip / *_x86.zip / *_x64.zip / *_lite.zip。文档站是说明书，不托管安装包。

刷完没反应 / 证书还是错的？ ​

  1. 重启一次

  2. WebUI 首页确认大状态为「运行正常」（不是异常 / 检测中）

  3. 强停被抓包 App 以及 Reqable / ProxyPin 再打开

  4. 点「刷新复核」，或执行：

    bash
    /data/adb/modules/CertBridge/bin/cb status --live

  5. 仍失败：看日志里 inject: / generation:，或 Action / 首页诊断建议

WebUI 打不开？ ​

安装时要勾选 WebUI（默认安装已含），且管理器要支持模块网页。普通浏览器不行。可重刷同版本并选择安装 WebUI。

没有「隐藏」页？ ​

未安装挂载隐藏协助，也未安装 Zygisk 过滤。默认安装会装隐藏协助；若自定义时两项都跳过，则无此页。重刷并勾选即可。

没有 Zygisk 过滤选项 / 提示缺 so？ ​

默认安装不安该组件；自定义安装才会问。若包内未带 zygisk/*.so，勾选后会提示缺失——请用带 so 的正式包，或自行构建。

更新后设置变了？ ​

同模块覆盖升级会尽量保留 certs.conf 与自定义证书；安装时音量键仍会再问组件。WebUI「更多」可切换正式 / CI 更新通道。

抓包与证书 ​

Reqable 显示「根证书未安装」，或一开抓包就断网？ ​

优先查 Root 隐藏是否卸掉了证书挂载：

现象常见原因
抓包软件提示根证未安装对该软件开了卸载模块 / DenyList umount / 排除修改
目标 App 断网、证书错误对目标 App 开了 umount

处理：对 Reqable / ProxyPin 以及被抓包目标，关闭卸载模块；仅对不参与抓包的 App 开启。详见 挂载隐藏。

Zygisk 挂载过滤（可选组件）与「卸载模块」不同：前者只藏进程读到的本模块路径痕迹、不卸 CA。默认黑名单模式（空=不过滤）；白名单模式空名单≈全机过滤，请慎用。抓包 App 永久豁免。见 挂载隐藏 · Zygisk。

状态正常，抓包还是断网？ ​

很常见：App 正在用的根证，和模块里启用的不是同一张。

  1. Reqable 重新生成证书后模块需再同步（不内置样例）
  2. ProxyPin 以 App 当前证为准；指纹对不上就不算同一张
  3. 「用户证书」≠「系统证书」；本模块注入的是系统 / APEX 信任库
  4. 对照 WebUI 证书详情里的指纹与 App 内显示

处理：刷新复核 / cb sync_apps；或自定义导入后重启；临时可用热挂载。

主空间 Reqable / 黄鸟显示已安装，分身里的抓包 App 仍显示未安装？ ​

最常见原因：主、分身用的是两张不同的根证，而证书桥只把「主空间那张」写进系统库。

Reqable / 黄鸟等会在各自数据目录里生成 MITM 根证书；重装 App、在设置里重新生成证书、或首次打开分身实例时，往往会得到新的指纹。主空间 Reqable 显示「已安装」，表示：系统 / APEX 里已有它当前正在用的那张根证（通常来自证书桥的 Reqable 同步或你自定义导入）。分身 Reqable 检查的却是它自己目录里的那张——若与系统里已注入的不一致，就会显示「未安装」，这是指纹对不上，不是证书桥没往系统里写 CA。

证书桥 sync_apps / 安装导入默认只读 user 0（主用户） 路径，不会自动同步分身实例下的 reqable-root.crt。因此：

你想达到的效果建议
全机（含分身目标 App）只信任一张抓包根证固定主空间一张证：不要在主 / 分身各自点「重新生成」；主空间生成后 → WebUI 刷新 / cb sync_apps → 重启。分身处 Reqable 若支持导入/复用同一张根证，与主空间对齐；否则尽量只用主空间 Reqable 抓包，分身只装要测的目标 App。
必须用分身 Reqable，且要界面也变绿把分身当前那张根证导出为 PEM，在 WebUI 自定义导入（可与 Reqable 开关并存，系统库会合并多张 CA）→ 重启；或关闭 Reqable 自动同步、只保留自定义源，避免再次被主空间覆盖。
主、分身各用各的证同时抓系统库需同时包含两张（主同步 + 分身自定义导入）；两个 Reqable 的「已安装」才可能都绿。模块不会按分身自动第三套逻辑。

主、分身 Reqable 里看到的「证书 ID」相同（主题一样、公钥不同）时，能否共存？ Android 系统库文件名来自 subject hash（常见为 a1b2c3d4.0）。同主题的两张不同根证会争用同一个 hash 前缀，不能在系统里各放一份内容不同的 xxxx.0，但证书桥合并时会自动写到 xxxx.1、xxxx.2…（见模块内冲突处理），两张可以同时存在于系统信任库，TLS 校验一般任一张合法 CA 即可。仍解不了的情况：① 只同步了主空间、从未把分身那张 PEM 自定义导入——系统里只有 .0 上是主空间公钥，分身用另一把私钥签流量，目标 App 仍不信任；② 你在主空间重新生成根证后 sync_apps 覆盖了源，.0 换成新证，分身旧证既不在系统也不在 .1。推荐仍是一张证走全机（主生成 → 分身 Reqable 导入同一张），比维护 .0+.1 两张 MITM 根更省事。

次要可能： 分身进程看不到 cacerts 挂载（Root 隐藏 / umount、ColorOS 元模块隔离）——主空间绿、分身红且完全不能解密时再查 根证未安装、force_bind_capture 等。

模块不能做的： 让分身 Reqable 自动与主空间共用同一份本地密钥文件，也不能替你在分身处点「安装到系统」；只能把你配置进模块的 PEM 注入系统信任库。

系统 CA 已生效，个别 App（如抖音）仍断网？ ​

证书桥只把抓包 CA 写入 Android 系统信任库（system / Conscrypt APEX）。部分 App 不会完全依赖系统信任锚，例如：

  • 证书锁定（Certificate Pinning）：仅接受预置公钥 / 证书指纹，拒绝「系统信任但未锁定」的中间人证书
  • 自建信任库 / 自定义 SSL 栈：内嵌自有 CA 列表或 OkHttp / 自研 TLS，绕过系统 TrustManager
  • 其它加固或网络安全配置（如仅信任用户区、禁用系统用户 CA 等）

此时即使用户侧 TLS 中间人已正确部署，目标 App 仍可能握手失败并表现为断网——这属于应用层信任策略，不是系统 CA 未注入。

如何判断是否仍是证书桥的问题：

  1. 打开 Reqable（或同类工具）的证书管理：若根证书状态为绿色 「已安装」（系统信任库侧已识别抓包 CA）
  2. 且证书桥 WebUI / cb status --live 为大状态正常、指纹与抓包软件一致

则系统 CA 注入链路已成立，断网应优先排查该 App 的 pinning / 私有信任策略，而不是反复重装本模块。

可行方向（与证书桥无关）： 使用针对 pinning 或 SSL 校验的 Xposed / LSPosed 模块（或抓包软件自带的对应方案），在目标进程内放宽校验。常用模块与仓库 / 下载见 LSPosed 模块（TrustMe、SSLBypass、SSL Kill Switch、TrustMeAlready 等；部分会员类模块如 Fuck for VIP / HookVip 的「拓展」里也有同类 SSL / 去 VPN 检测开关）。Tricky Store 用于密钥证明，不是 pinning 绕过。具体效果因 App 与版本而异，需自行评估风险与合规性。

白名单为空能抓、只抓单个 App 却断网？ ​

多数与证书桥无关，是抓包软件的拦截范围 / 单应用 VPN / DNS 问题。可先对「全部应用」试抓；仍断网再查证书指纹与 umount。

ColorOS / OPPO 应用分身： 主空间能抓、分身不能时，多为系统把 VpnService / TUN 与分身用户隔离——证书桥无法把流量强行导入隧道。可改 Wi‑Fi 代理、在分身处单独装抓包 App，或使用社区 LSPosed 模块（如 Coloros VPN fix）；若 App 是「检测到 VPN 就断网」而非「没进隧道」，见 LSPosed 模块 · VPN 相关。

刚重启显示异常，过一会又正常？ ​

开机瞬间命名空间可能未就绪。较新版本会退避重试与延迟自愈；点一次「刷新复核」即可。若你关闭了 late_inject / service_probe（默认关），中间态会更短、兼容性依赖机型——证书异常时再开冷门实验。

挂载与机型 ​

大面积 HTTPS 失败、系统 CA 像只剩几张？ ​

轻量 Magic 模式下，若 KernelSU 等把模块 system/ 整目录替换，会遮蔽原系统 CA。立刻改回 完整兼容 并重启。见 配置说明 · 挂载模式。

Android 14+ 部分 App 仍不信任？ ​

默认只绑主 APEX 且跳过 system（痕迹最少）。可依次尝试（均需重启）：

  1. experimental_14_system=auto
  2. boot_multi_apex=1
  3. boot_bind_zygote=1 / late_inject=1

入口：WebUI「隐藏 → 冷门实验」或 cb set …。

和别的证书 / 挂载模块一起用？ ​

尽量避免多个模块同时改同一 cacerts。卸载其它证书模块后重启再测。热挂载若检测到上层叠层会拒绝强拆并提示重启。

界面与配置 ​

命令行怎么用？ ​

bash
/data/adb/modules/CertBridge/bin/cb help

常用：status --live、set、sync_apps、hot_mount。完整说明见 命令行 CLI。

热挂载后重启又没了？ ​

预期行为：临时会话不持久。永久请用自定义证书或保持 Reqable/ProxyPin 开关开启并重启。

相关抓包软件 / LSPosed 模块？ ​

抓包工具见 相关软件；SSL / pinning 绕过见 LSPosed 模块（含会员类模块的同类拓展说明）。

证书桥 · CertBridge

由许小墨维护