Charles 抓包证书不受信任怎么解决?Android 与 iOS 全平台信任配置及报错排查(含 Android 14)
Charles 抓包证书不受信任的根本原因是:Charles 作为中间人代理,用自签的 Charles Proxy CA 根证书动态签发站点证书,该根证书不在客户端的信任库中,按 RFC 5280 第 6 节的路径验证规则会被判为不可信;把它导入对应信任库并显式信任即可解决。 Android 7.0(API 24)起,App 默认只信任 /system/etc/security/cacerts 下的系统 CA,用户在设置里安装的用户证书不进入 App 信任链,需要 root 写入系统证书目录,或在 App 内配置 network_security_config 的 certificates src=user。 iOS 10.3 及以上版本,安装描述文件后还必须在“设置 → 通用 → 关于本机 → 证书信任设置”中打开 Charles Proxy CA 的完全信任开关,否则会报 NSURLErrorDomain Code=-1202。 Android 14 的系统 CA 已迁移到 Conscrypt APEX 路径 /apex/com.android.conscrypt/cacerts,只往 /system/etc/security/cacerts 写文件在部分机型上不再生效,需要 Magisk 模块挂载。 验证是否生效最快的方法:openssl s_client -proxy 127.0.0.1:8888 -connect www.example.com:443 -CAfile charles.pem,输出 Verify return code: 0 (ok) 即表示证书链已通过校验。
Charles 抓包证书为什么不受信任?先看清四个根本原因
“Charles 明明开着,浏览器也能抓到包,为什么 App 一直报证书错误?”——这是 Charles 用户最常撞上的第一堵墙。把报错拆开看,证书不受信任基本逃不出下面四个根本原因,先定位是哪一类,再谈怎么装证书。
- 原因一:Charles 本质是中间人(MITM)代理。开启 SSL Proxying 后,它会对每个 HTTPS 目标站点实时签发一张叶证书,签发者是自己在本机生成的 “Charles Proxy CA” 根证书(CN=Charles Proxy CA,后跟安装时生成的唯一标识后缀)。这张根证书不在操作系统、浏览器、JDK 的预置信任列表里,客户端按 RFC 5280 的证书路径验证规则找不到可信锚点,只能判定不受信任。先确认你导出的证书与 Charles 正在用的是同一张:
# 1) Charles 菜单 Help → SSL Proxying → Save Charles Root Certificate… 导出 PEM # 2) 查看主体、有效期与指纹,确认客户端信任的就是这张 openssl x509 -in charles-proxy-ssl-proxying-certificate.pem -noout -subject -issuer -dates -fingerprint -sha256 # 典型输出: # subject=CN = Charles Proxy CA (7 Dec 2023, 14:22:31), O = XK72 Ltd, OU = https://charlesproxy.com # issuer=CN = Charles Proxy CA (7 Dec 2023, 14:22:31), O = XK72 Ltd, OU = https://charlesproxy.com # notAfter=Dec 4 06:22:31 2033 GMT # SHA256 Fingerprint=1B:2C:... ← 与设备上已安装的证书指纹比对 - 原因二:Android 7.0(API 24)收紧了用户证书的信任策略。据 Android 官方 Network security configuration 文档,targetSdkVersion ≥ 24 的应用默认只信任系统 CA(
/system/etc/security/cacerts),你在“设置 → 安全 → 加密与凭据 → 安装证书”里装的 CA 只对显式声明了 user trust 的应用(如浏览器)生效,App 内的 OkHttp、HttpURLConnection 会直接抛java.security.cert.CertPathValidatorException: Trust anchor for certification path not found。可用 adb 核对两套证书库的差异:# 系统 CA 库(应用默认信任这里) adb shell ls /system/etc/security/cacerts | head -n 5 # 用户手动安装的 CA(需应用声明信任 user 证书才生效) adb shell ls /data/misc/user/0/cacerts-added仅调试期放行用户 CA 的最小改法(切勿进入 release 构建):
<!-- res/xml/network_security_config.xml --> <network-security-config> <debug-overrides> <!-- 只在 android:debuggable=true 时生效 --> <trust-anchors> <certificates src="user" /> <!-- 追加信任用户安装的 CA --> </trust-anchors> </debug-overrides> </network-security-config> <!-- AndroidManifest.xml 的 <application> 上引用: android:networkSecurityConfig="@xml/network_security_config" --> - 原因三:iOS 的“装描述文件”和“信任证书”是两个动作。iOS 10.3 起,用 Safari 访问
chls.pro/ssl安装描述文件后,还必须到“设置 → 通用 → 关于本机 → 证书信任设置”把 Charles Proxy CA 的开关拨绿;否则系统仍按未信任处理,App 报NSURLErrorDomain Code=-1202(“此服务器的证书无效”)。据 Apple 支持文档《关于信任证书》,这一手动开关是 iOS 对用户级根证书的强制二次确认。 - 原因四:不同运行时各用独立的证书库。把证书装进 Windows 的“受信任的根证书颁发机构”并不等于下面这些运行时也信任:
| 运行时 / 客户端 | 信任库位置 | 导入或覆盖方式 |
|---|---|---|
| Windows 系统 | certmgr.msc → 受信任的根证书颁发机构 | 双击 .cer 导入 |
| JDK(Maven、Tomcat 等) | $JAVA_HOME/lib/security/cacerts,默认口令 changeit |
keytool -importcert -alias charles -file ca.pem -keystore $JAVA_HOME/lib/security/cacerts |
| Firefox | NSS 库 cert9.db(每个配置文件一份) |
设置 → 隐私与安全 → 证书 → 查看证书 → 导入 |
| Node.js | 内置 CA bundle | NODE_EXTRA_CA_CERTS=/path/ca.pem |
| Python requests | certifi 的 cacert.pem |
REQUESTS_CA_BUNDLE=/path/ca.pem |
| Git(底层 curl) | http.sslCAInfo |
git config --global http.sslCAInfo /path/ca.pem |
四个原因对应同一种外在表现:Charles 的 Structure 面板里该请求显示为 <unknown>、状态列挂红色锁形图标,浏览器报 ERR_CERT_AUTHORITY_INVALID,Java 端抛 SSLHandshakeException,Android 抛 Trust anchor for certification path not found,iOS 报 -1202。排查方向始终一致——先确认根证书是否真正进入了该客户端的信任库,再去怀疑 SSL Proxying 的 Host/Port 配置或证书固定(Certificate Pinning)。
完整实操步骤:从导出根证书到全平台信任(以 Charles 4.6.7 / 5.0.x 为例)
问:Charles 4.6.7 装好了,浏览器还是一直报 NET::ERR_CERT_AUTHORITY_INVALID 或 SSLHandshake: Received fatal alert: unknown_ca,是不是哪里漏了?答:九成情况是下面六步里漏了第 5 或第 6 步——iOS 只装了描述文件却没开”证书信任设置”,Android 7.0+ 的 App 只信任系统 CA、不信任用户 CA。按顺序走一遍,charles抓包证书不受信任 基本就能消除。
Step 1 · 开启 SSL 代理
Proxy → SSL Proxying Settings → 勾选 Enable SSL Proxying → Add,Host 填 *、Port 填 443。只调试固定域名时建议写 api.example.com:443,可把无关流量噪音降低 80% 以上,也让证书错误更容易定位。同时在 Proxy → Proxy Settings 确认 HTTP 代理端口为默认 8888(取值范围 1–65535,被占用时 Charles 会提示并自动顺延),勾选 Enable transparent HTTP proxying,以便处理不感知代理的客户端。
Step 2 · 导出根证书
Help → SSL Proxying → Save Charles Root Certificate…,格式选 PEM,保存为 charles.pem(约 1.5 KB)。需要 .p12 时用同一菜单的 Export 导出 PKCS#12,务必设导出密码且不要外发——按 RFC 5280 的信任传递模型,根证书私钥泄露等同于任何人都能冒充你签发任意站点证书。
Step 3 · 桌面端信任
# Windows(管理员 PowerShell / CMD),-f 覆盖同名项
certutil -addstore -f "ROOT" charles.pem
# 校验:应列出 Charles Proxy CA
certutil -store ROOT | findstr /i "Charles"
# macOS:导入"系统"钥匙串并设为始终信任
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain charles.pem
# Linux(Debian/Ubuntu 系,文件名必须以 .crt 结尾)
sudo cp charles.pem /usr/local/share/ca-certificates/charles.crt
sudo update-ca-certificates # 输出 "1 added" 即成功
Step 4 · 手机端下载
手机与电脑连同一 Wi-Fi,在 Wi-Fi 高级设置里配置手动代理:主机名填电脑内网 IP(如 192.168.1.20,用 ipconfig/ifconfig 查),端口 8888。手机浏览器访问 chls.pro/ssl(等价地址 http://charlesproxy.com/getssl)下载。Android 拿到的文件常无扩展名或是 .pem,必须重命名为 charles.crt,”从存储设备安装”才认。
Step 5 · iOS 完全信任
设置 → 已下载描述文件 → 右上角”安装” → 输入锁屏密码 → 再进设置 → 通用 → 关于本机 → 证书信任设置 → 打开 Charles Proxy CA 开关。全程约 3 分钟,漏掉最后这个开关正是 iOS 上 charles抓包证书不受信任 最常见的失败点(iOS 10.3 起强制拆成”安装”和”信任”两步)。
Step 6 · Android 系统级信任(需 root,Android 7.0+ 的 App 才生效)
# 1) 算哈希:Android 用的是 OpenSSL 的 old 哈希算法
openssl x509 -inform PEM -subject_hash_old -in charles.pem | head -1
# 假设输出 1d3a5f2b,则文件名必须为 1d3a5f2b.0
cp charles.pem 1d3a5f2b.0
# 2) Android 7.0–13:写入 /system/etc/security/cacerts
adb root && adb remount
adb push 1d3a5f2b.0 /system/etc/security/cacerts/
adb shell chmod 644 /system/etc/security/cacerts/1d3a5f2b.0
adb reboot
# 3) Android 14:证书目录迁到只读的 /apex/com.android.conscrypt/cacerts
# 需用 tmpfs 覆盖挂载(重启失效,建议做成 Magisk 模块)
adb shell su -c 'mkdir -p /data/local/tmp/cacerts &&
cp /apex/com.android.conscrypt/cacerts/* /data/local/tmp/cacerts/ &&
cp /data/local/tmp/1d3a5f2b.0 /data/local/tmp/cacerts/ &&
mount -t tmpfs tmpfs /apex/com.android.conscrypt/cacerts &&
cp /data/local/tmp/cacerts/* /apex/com.android.conscrypt/cacerts/'
| 平台 | 系统信任库位置 | 用户级是否够用 |
|---|---|---|
| Windows 10/11 | cert:LocalMachineRoot | 是(当前用户亦可) |
| macOS 12+ | /Library/Keychains/System.keychain | 需”始终信任” |
| iOS 15+ | 设置 → 证书信任设置 | 需手动开关 |
| Android 7–13 | /system/etc/security/cacerts | 否,仅浏览器 |
| Android 14 | /apex/com.android.conscrypt/cacerts | 否,需覆盖挂载 |
如果你在 Charles 日志里看到 Client SSL handshake failed: An unknown issue occurred processing the certificate,说明客户端根本没走到信任校验,先回头确认 Step 1 的 Host/Port 是否匹配;而 Android 14 上即使文件已就位,只要重启后忘了重新挂载,charles抓包证书不受信任 就会立刻复现。据 Let’s Encrypt 与 Mozilla CA 证书计划文档,根证书的信任范围以”证书存储”为单位生效,这也解释了为什么用户级安装对多数 App 无效。
配置与命令示例:Charles 参数、OpenSSL、keytool、adb 逐条给出
Charles 的 SSL Proxying 规则怎么写才不会漏包?规则格式是 Host:Port,Host 支持 * 通配符,但通配符不覆盖裸域。据 Charles 官方文档,*.example.com:443 只匹配 api.example.com、m.example.com,请求 https://example.com/ 时仍然显示 <unknown>,必须再补一条 example.com:443。另外这里的端口是目标服务端口,不是 Charles 的代理端口(默认 8888):抓 8443 的接口要单独加 *.example.com:8443,否则该请求在 Structure 视图里始终是灰色 <unknown>。
| 规则写法 | 匹配 api.example.com:443 | 匹配 example.com:443 | 匹配 api.example.com:8443 |
|---|---|---|---|
*.example.com:443 |
✅ | ❌ | ❌ |
example.com:443 |
❌ | ✅ | ❌ |
*:443 |
✅ | ✅ | ❌ |
*:* |
✅ | ✅ | ✅(不推荐,性能与噪声大) |
Android 证书哈希为什么要用 -subject_hash_old?Android 的 /system/etc/security/cacerts/ 按 OpenSSL 旧式 MD5 主题哈希命名,新版 -subject_hash(SHA-1)算出的文件名系统不识别,表现为「已放入目录但设置里看不到证书」。OpenSSL 1.1.1 与 3.x 均支持:
# 1) 从 Charles 导出 PEM 证书(Help > SSL Proxying > Save Charles Root Certificate,选 .pem)
# 2) 计算 8 位十六进制哈希(必须用 _old,即 MD5 算法)
openssl x509 -inform PEM -subject_hash_old -in charles.pem | head -1
# 输出示例:1d2b3c4e
# 3) 重命名,后缀必须是 .0
mv charles.pem 1d2b3c4e.0
# 4) 自检:确认哈希一致
openssl x509 -inform PEM -subject_hash_old -in 1d2b3c4e.0 | head -1
adb 写入系统证书目录的完整序列(Android 9 及以下可 remount 的机型):
adb root # 需要 userdebug/eng 版本,零售版会提示 adbd cannot run as root
adb remount # 若报 remount failed,见下方 Android 10+ 说明
adb push 1d2b3c4e.0 /system/etc/security/cacerts/
adb shell chmod 644 /system/etc/security/cacerts/1d2b3c4e.0
adb shell ls -lZ /system/etc/security/cacerts/1d2b3c4e.0
# 期望输出:-rw-r--r-- 1 root root u:object_r:system_security_cacerts_file:s0 ... 1d2b3c4e.0
adb reboot # 必须重启,否则 TrustManager 不重新加载
SELinux 上下文若是
u:object_r:rootfs:s0,系统会静默忽略该证书;需adb shell restorecon /system/etc/security/cacerts/1d2b3c4e.0修正。Android 10 起/system位于动态分区(system-as-root+dm-verity),adb remount通常直接失败,须改用 Magisk 模块(/data/adb/modules/charles-cert/system/etc/security/cacerts/)或Magisk的AlwaysTrustUserCerts类模块。
桌面端与 JVM 端怎么信任?Charles 4.x 生成的根证书默认有效期 1 年,过期会报 SSLHandshakeException: PKIX path validation failed,需在 Proxy > SSL Proxying Settings > Root Certificate 重新生成。JDK 导入命令(JDK 9 之后 cacerts 默认口令仍是 changeit,来自 OpenJDK 文档):
# 导入到当前 JDK 信任库
keytool -importcert -noprompt -alias charles -file charles.pem
-keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit
# 验证,期望输出:charles, 2024-xx-xx, trustedCertEntry
keytool -list -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit | grep -i charles
各运行时用哪个环境变量?这些变量优先级高于系统证书库,适合在 CI 中临时注入,无需改动镜像:
| 运行时 | 环境变量 / 参数 | 示例值 |
|---|---|---|
| Node.js | NODE_EXTRA_CA_CERTS |
/etc/ssl/certs/charles.pem |
| Python requests | REQUESTS_CA_BUNDLE |
/etc/ssl/certs/charles.pem |
| curl | CURL_CA_BUNDLE 或 --cacert |
curl --cacert charles.pem https://api.example.com |
| OpenSSL | SSL_CERT_FILE |
/etc/ssl/certs/charles.pem |
| Git | http.sslCAInfo |
git config --global http.sslCAInfo /etc/ssl/certs/charles.pem |
App 内怎么只对调试包放行用户证书?Android 7(API 24)起默认不再信任用户安装的 CA,这正是 charles抓包证书不受信任 在真机上最常见的根因。按 Android 开发者文档,用 debug-overrides 仅在 android:debuggable="true" 时生效,正式包不受影响:
<!-- res/xml/network_security_config.xml -->
<network-security-config>
<debug-overrides> <!-- 仅 debuggable 构建生效 -->
<trust-anchors>
<certificates src="user"/> <!-- 信任用户证书(Charles 根证书) -->
<certificates src="system"/>
</trust-anchors>
</debug-overrides>
</network-security-config>
<!-- AndroidManifest.xml 的 <application> 节点 -->
<application android:networkSecurityConfig="@xml/network_security_config" ...>
若配置后仍报 Trust anchor for certification path not found,先确认 APK 里 android:debuggable 为 true(aapt dump badging app.apk | grep -i debuggable),再检查是否被 OkHttp 的 CertificatePinner 或 NetworkSecurityPolicy.isCleartextTrafficPermitted 之外的证书固定逻辑拦截。
方案选型对比:系统证书、network_security_config、Hook 框架怎么选
选错方案往往比证书本身更耗时。下面把 Android 上让 Charles 根证书被信任的几条主流路径放在同一张表里对比,先看结论再决定动手方式。据 Android 官方文档《Changes to Trusted Certificate Authorities in Android Nougat》,从 Android 7.0(API 24)起,应用默认只信任系统 CA,用户手动安装的证书不再对 targetSdkVersion ≥ 24 的应用生效——这一条决定了后面所有方案的分野。
| 方案 | 适用版本 | 需 root | 生效范围 | 耗时 | 主要风险 |
|---|---|---|---|---|---|
| 用户证书安装(设置 → 安全 → 加密与凭据) | Android 6.0 及以下全生效;7.0+ 仅浏览器与主动声明信任用户 CA 的应用 | 否 | 部分应用 | 3–5 分钟 | 低 |
系统证书写入 /system/etc/security/cacerts 或 APEX 证书库 |
Android 7.0–14(Android 14 起系统 CA 迁至 APEX 模块) | 是 | 全部应用 | 15–30 分钟 | 中;OTA 升级后失效,需重刷 |
network_security_config 调试信任 |
API 24+ 的自有 App 调试包 | 否 | 单个应用 | 5 分钟 | 低;需改代码并重新打包 |
| LSPosed + JustTrustMe 等 Hook 模块 | Android 7.0–14 | 是(或使用虚拟框架) | 多数应用 | 10–20 分钟 | 中高;易被风控与完整性检测识别 |
| 低版本模拟器(Android 6.0 / API 23) | 仅老版本 App | 否 | 模拟器内全部 | 10 分钟 | 低;但新 App 常因 minSdk 提升无法安装 |
怎么选?按你的身份和权限分三档。
- 只调自家后端接口:优先
network_security_config+ debug 包。零 root、可进 CI,且信任范围精确到域名。示例(res/xml/network_security_config.xml,Android 7.0+ 有效):
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<!-- debug-overrides 只在 android:debuggable="true" 时生效,release 包不受影响 -->
<debug-overrides>
<trust-anchors>
<certificates src="user"/> <!-- 信任用户安装的 Charles 根证书 -->
<certificates src="system"/>
</trust-anchors>
</debug-overrides>
<domain-config cleartextTrafficPermitted="true">
<domain includeSubdomains="true">api.example.com</domain>
</domain-config>
</network-security-config>
<!-- AndroidManifest.xml 中引用 -->
<application android:networkSecurityConfig="@xml/network_security_config" ... />
- 要抓第三方 App 且设备已 root:用 Magisk 模块把 Charles 根证书写进系统库。Android 14 上注意证书哈希需以
openssl x509 -subject_hash_old -in charles.pem生成,文件名形如1a2b3c4d.0。 - 设备不能 root 又要抓第三方 App:只能走 Frida 脚本 hook
SSL_verify/X509TrustManager,或改用 Android 6.0 测试机。此时要接受 App 闪退、证书固定(certificate pinning)拦截和风控标记的概率。
成本量化:单台设备安装用户证书平均 3–5 分钟;root 后首次写系统证书约 20 分钟,之后每台约 5 分钟;配置 network_security_config 并重新构建约 5–10 分钟,但可复用到整条流水线。团队超过 5 人时,建议把根证书与配置模板沉淀到内网文档——否则每个人都会重复踩一遍“charles抓包证书不受信任”的坑。
两个高频误判:其一,Android 14(targetSdk 34)对明文流量默认禁止,若日志出现 CLEARTEXT communication to api.example.com not permitted by network security policy,这是明文策略问题而非证书信任问题,需在 networkSecurityConfig 中加 cleartextTrafficPermitted="true",两者独立排查。其二,代理工具本身也有取舍:Charles 4.6.7 / 5.0.x 单用户授权 50 美元(含一年升级),Proxyman 起步 69 美元,Fiddler Everywhere 订阅 99 美元/年,mitmproxy 完全免费开源且证书信任逻辑一致(同样需导入 mitmproxy-ca-cert.pem),团队预算敏感时可直接替换。
常见错误与排查:这些真实报错分别对应什么问题
排查 charles抓包证书不受信任 最有效的方式是“读报错”:报错文本直接暴露了客户端用的是哪个信任库。据各平台文档,Chrome/Edge 走操作系统信任库,Firefox 走自带的 NSS 库,Android 7.0(API 24)起应用默认只信任系统 CA 而忽略用户 CA,JVM 走 $JAVA_HOME/lib/security/cacerts,Node.js 走内置 Mozilla CA 列表——同一个 Charles 根证书,在这五个地方需要分别安装。
| 真实报错 | 发生层 | 根因 | 处理动作 |
|---|---|---|---|
| NET::ERR_CERT_AUTHORITY_INVALID | Chrome / Edge(系统库) | 根证书未进入“受信任的根证书颁发机构” | certutil / 钥匙串“始终信任” |
| SEC_ERROR_UNKNOWN_ISSUER | Firefox(NSS 库) | 未读取系统根证书 | 导入 charles.pem 或开 enterprise_roots |
| Trust anchor for certification path not found | Android App | targetSdk ≥ 24 不信任用户 CA | network_security_config 或写系统证书 |
| PKIX path building failed | Java / Spring | cacerts 缺根证书 | keytool 导入并重启 JVM |
| curl: (60) self-signed certificate in certificate chain | curl / OpenSSL | 未指定信任锚 | --cacert |
| UNABLE_TO_VERIFY_LEAF_SIGNATURE | Node.js | 内置 CA 列表无 Charles 根证书 | NODE_EXTRA_CA_CERTS |
| NSURLErrorDomain Code=-1202 | iOS | 描述文件装了但信任开关未开 | 设置 → 通用 → 关于本机 → 证书信任设置 |
Chrome / Edge 报 NET::ERR_CERT_AUTHORITY_INVALID 怎么办? 说明根证书没进系统信任区。Windows 用管理员 PowerShell 执行下面命令,注意 -addstore 的目标必须是 ROOT(受信任根),装到 CA 是无效的:
# 导出 Charles 根证书:Help → SSL Proxying → Save Charles Root Certificate
# Windows(管理员 PowerShell / CMD)
certutil -addstore -f "ROOT" charles.pem
# 验证:应能在列表中看到 "Charles Proxy CA"
certutil -store ROOT | findstr /i charles
# macOS:-d 表示加入管理员域,-r trustRoot 设为根信任
sudo security add-trusted-cert -d -r trustRoot
-k /Library/Keychains/System.keychain charles.pem
Firefox 报 SEC_ERROR_UNKNOWN_ISSUER 或 MOZILLA_PKIX_ERROR_MITM_DETECTED? Firefox 自 2019 年起默认 security.enterprise_roots.enabled = false,不读 Windows/macOS 系统根证书,所以在 Chrome 里正常、在 Firefox 里报错是最典型的症状。在 about:config 把它改成 true 后重启;或在“设置 → 隐私与安全 → 证书 → 查看证书 → 证书颁发机构 → 导入”选择 charles.pem 并勾选“信任由此 CA 标识的网站”。
Android App 报 SSLHandshakeException: Trust anchor for certification path not found? 按 Android 官方网络安全配置文档,targetSdkVersion ≥ 24 时应用默认只信任系统 CA。排查顺序固定为三步:① 设置 → 安全 → 加密与凭据 → 用户凭据,确认 Charles CA 已装(Android 14 在“设置 → 安全 → 更多安全设置 → 加密与凭据 → 安装证书 → CA 证书”);② 确认 App 的 network_security_config 是否放行用户 CA;③ 仍失败则需 root 把证书写入 /system/etc/security/cacerts/(需按 hash 命名,Android 14 上还需处理 APEX 的 /apex/com.android.conscrypt/cacerts)。
<!-- res/xml/network_security_config.xml:debug 包放行用户 CA -->
<network-security-config>
<debug-overrides>
<trust-anchors>
<certificates src="user"/> <!-- 默认只有 system -->
<certificates src="system"/>
</trust-anchors>
</debug-overrides>
</network-security-config>
Java 报 PKIX path building failed: unable to find valid certification path to requested target? 这是 cacerts 里没有 Charles 根证书。用 keytool 导入(默认口令 changeit),并重启 JVM 才生效——已加载的 TrustManager 不会热更新:
keytool -importcert -noprompt -trustcacerts -alias charles
-file charles.pem
-keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit
keytool -list -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit | grep -i charles
容器里要改镜像内的
$JAVA_HOME/lib/security/cacerts,改宿主机的 JDK 完全无效;更稳妥的做法是挂载自定义 truststore 并用-Djavax.net.ssl.trustStore=/etc/ssl/charles-truststore.jks指定。
curl 与 Node.js 的报错怎么修? curl 报 curl: (60) SSL certificate problem: self-signed certificate in certificate chain 时用 --cacert 指定信任锚,-k 只用于一次性本地调试,写进 CI 脚本等于关掉全部校验。Node.js 报 UNABLE_TO_VERIFY_LEAF_SIGNATURE 时设置环境变量即可,据 Node.js 官方文档该变量会把额外 CA 追加进默认列表:
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
# curl:显式信任 Charles 根证书
curl --cacert charles.pem https://api.example.com/health
# Node.js:追加 CA(Node 8+ 支持),不要用 NODE_TLS_REJECT_UNAUTHORIZED=0
export NODE_EXTRA_CA_CERTS=/path/to/charles.pem
node app.js
iOS 报 NSURLErrorDomain Code=-1202 且信任开关是灰的? 灰色说明描述文件根本没装上。必须用 Safari 访问 chls.pro/ssl 触发安装(Chrome for iOS 无法触发描述文件下载),装完后到“设置 → 通用 → 关于本机 → 证书信任设置”手动打开 Charles 的开关——iOS 13 起这一步不再自动完成。
Charles 自己日志里出现 SSL handshake failed: Received fatal alert: unknown_ca 或 Client closed connection before receiving entire response? 前者是客户端在 ServerHello 之后主动拒绝证书,本质仍是信任链没打通;后者常见于证书固定(Certificate Pinning)或 App 内置了独立 truststore。若只有部分域名在结构树里显示 <unknown>,先检查 Proxy → SSL Proxying Settings 是否覆盖了该 Host:Port(通配符 *:443 只匹配单层域名),再判断是否 Pinning——此时只能 hook(Frida 脚本)或改用 App 提供的测试包。这也是 charles抓包证书不受信任 类问题里最容易被误判为“证书没装好”的一种。
效果验证:怎么确认证书信任真的生效了
证书装完、配置文件也改了,怎么确认它不是”看起来生效”?建议按四层依次验证:Charles 自身能否解密、TLS 层能否用你导出的 charles.pem 验通、系统信任库是否真的加载、App 层是否还抛异常。任何一层失败,都会表现为大家常说的 charles抓包证书不受信任,区别只在报错位置。
第一层:Charles 界面。在 Structure 视图下展开目标域名,该 HTTPS 请求应能看到 JSON、HTML 或图片响应体;切到 Overview 标签,Timing 里会出现 TLS Handshake 一行(正常 20–200 ms);Contents 标签内容完整。这三项同时满足,说明解密链路已通。如果 URL 能看到但内容显示 <unknown>,问题出在握手阶段就被客户端拒绝,而不是 Charles 的解密逻辑——此时直接看第二层。
第二层:OpenSSL 验证证书链。据 OpenSSL 官方文档,s_client 的 -proxy 参数自 1.1.1 起提供,1.0.2 分支没有该选项,只能手工构造 CONNECT 隧道后再握手。
# OpenSSL 1.1.1+:经 Charles 的 HTTP 代理端口建立 CONNECT 隧道
openssl s_client -proxy 127.0.0.1:8888
-connect www.example.com:443
-servername www.example.com
-CAfile charles.pem
-verify_return_error
# 期望输出末尾:Verify return code: 0 (ok)
# 加 -showcerts 可打印完整链,issuer 应为 CN=Charles Proxy CA
# 默认 8888 为 Charles Proxy Settings → Proxy Settings 的 HTTP Proxy 端口
返回码非 0 时,报错文本通常直接指向根因:unable to get local issuer certificate 说明 -CAfile 指错了文件或没导出根证书;certificate has expired 说明 Charles 根证书已过期(默认有效期 1 年)。
第三层:curl 验证。curl 复用同一套 OpenSSL,但更贴近真实客户端的证书校验路径:
curl -v --proxy http://127.0.0.1:8888
--cacert charles.pem
https://www.example.com/
# 详细输出中应出现:SSL certificate verify ok.
# subject: CN=www.example.com
# issuer: CN=Charles Proxy CA
echo $? # 0 表示既完成解密又无证书告警
第四层:系统与 App 层。Android 端按 AOSP 的信任库约定,证书必须以 <subject_hash>.0 命名并放在 /system/etc/security/cacerts/;Android 14 该分区为只读,模拟器需 -writable-system 才能写入。
adb shell ls -lZ /system/etc/security/cacerts/<hash>.0
# 期望:-rw-r--r-- root root u:object_r:system_file:s0
adb reboot
adb logcat | grep -i trust # 过滤 Trust anchor / TrustManager 异常
iOS 端据 Apple 支持文档,手动安装的描述文件必须在「设置 → 通用 → 关于本机 → 证书信任设置」中单独打开开关,开关为绿色才算完整信任;验证方式是 Safari 访问任意 HTTPS 站点无”此连接非私人连接”警告,且 Charles 中能看到完整 URL 路径而非仅域名。
顺手校验证书文件本身:
openssl x509 -in charles.pem -noout -subject -issuer -dates
# 检查 notAfter 未过期;自签名特征:subject 与 issuer 完全相同
| 验证手段 | 能证明什么 | 失败典型输出 |
|---|---|---|
| Charles Structure 展开 | 解密链路端到端可用 | 内容为 <unknown> |
openssl s_client |
证书链可被指定 CA 验证 | unable to get local issuer certificate |
curl --cacert |
真实客户端校验路径通过 | SSL certificate problem: self-signed certificate |
adb logcat | grep -i trust |
App 是否命中系统信任锚 | Trust anchor for certification path not found |
四层全部通过后,若仍有 App 报错,方向就应从证书信任转向证书固定(Certificate Pinning)或双向认证,那是另一类问题。
Android 14 与 iOS 17 之后的新变化,以及团队长期维护怎么做
Android 14(API 34)把系统 CA 存储从只读的 /system/etc/security/cacerts 迁到了 Conscrypt APEX 模块,运行时实际生效的路径是 /apex/com.android.conscrypt/cacerts。这意味着过去那套「adb root 后把 PEM 拷进 /system/etc/security/cacerts」的老办法,在 Pixel、部分三星与小米机型上会静默失效——文件还在,但 TrustManager 根本不读它。这是很多人升级系统后突然发现 charles抓包证书不受信任 的根因。
社区目前的主流解法是用 Magisk 模块在开机早期把用户证书挂载到 APEX 路径。以 MagiskTrustUserCerts 为例,需要 Magisk 26.x 及以上版本(26.0 起模块的挂载时序与 APEX 兼容性才稳定),低于该版本会出现模块刷入成功但证书不生效的现象。AlwaysTrustUserCerts 思路相同,选哪个取决于你的 ROM 是否需要额外的 SELinux 上下文修正。
# 前置:Magisk 26.4+,已开启 Zygisk
# 1) 安装模块(任选其一,二者不要同时启用,会冲突)
adb push MagiskTrustUserCerts.zip /sdcard/Download/
# 然后在 Magisk App → 模块 → 从本地安装,选择该 zip,重启
# 2) 重启后验证证书是否真的进了 APEX 路径
adb shell su -c 'ls /apex/com.android.conscrypt/cacerts | grep -i charles'
# 期望输出类似:9a5ba575.0
# 若为空,说明模块未生效,检查 Magisk 版本与 Zygisk 开关
# 3) 同时确认用户证书已安装(Charles 的 PEM 需先转为 .0 命名)
openssl x509 -inform PEM -subject_hash_old -in charles.pem | head -1
# 输出如 9a5ba575,文件名即为 9a5ba575.0
另一件常被混为一谈的事:Android 14 同时收紧了 targetSdk 34 应用的明文流量策略。调试内网 HTTP 接口时若未显式放行,会直接抛出 CLEARTEXT communication to 10.0.0.5 not permitted by network security policy。这条报错与证书信任完全无关,但因为总在抓包时一起出现,极易被误判成证书问题。放行方式是在 network_security_config.xml 中声明:
<!-- res/xml/network_security_config.xml,仅 debug 变体使用 -->
<network-security-config>
<domain-config cleartextTrafficPermitted="true">
<domain includeSubdomains="true">10.0.0.5</domain>
</domain-config>
</network-security-config>
iOS 17 / iPadOS 17 这边反而没有结构性变化,信任流程仍是「安装描述文件 → 设置 → 通用 → 关于本机 → 证书信任设置 → 手动开启完全信任」两步。据 Apple 官方支持文档,企业环境通过 MDM 下发的根证书可免去手动开启信任这一步,对超过 10 台设备的小团队能省下大量重复操作;个人开发者仍建议逐台手动确认,否则描述文件残留会在换机、重装后造成难以定位的信任异常。
证书轮换是长期维护里最容易被忽略的一环。Charles 根证书默认有效期约 1 年,建议在到期前 30 天通过 Help → Reset Charles Root Certificate 重新生成,然后同步更新所有客户端、CI 变量与 Docker 镜像里的 charles.pem。私钥 .p12 只应保存在本机钥匙串或密钥管理系统中,禁止提交到 Git 仓库——一旦泄露,任何人在链路中间都能解密你的 HTTPS 流量。
| 平台 | 批量分发方式 | 关键命令 / 路径 | 适用规模 |
|---|---|---|---|
| macOS | 命令行 + MDM | security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain charles.pem |
任意,需 root |
| Windows | 组策略 | 计算机配置 → Windows 设置 → 安全设置 → 公钥策略 → 受信任的根证书颁发机构 | 域内设备 |
| Linux 服务器 | Ansible | copy 证书到 /usr/local/share/ca-certificates/ + update-ca-certificates |
集群 |
| iOS / iPadOS | MDM 描述文件 | 根证书载荷,免手动信任(iOS 17 起) | > 10 台 |
| Android 14 | Magisk 模块 | 挂载至 /apex/com.android.conscrypt/cacerts |
已 root 测试机 |
把上面这些固化成流程,能显著降低「换个同事的机器又抓不到包」的重复成本:证书文件纳入密钥管理系统并标注到期日,Android 测试机镜像预装 Magisk 模块,iOS 团队设备走 MDM,CI 里的 charles.pem 通过环境变量注入而非硬编码。想进一步减少对 Charles 根证书的依赖,也可以了解 mitmproxy 的 --set confdir 证书目录管理与 OpenSSL 的 SSL_CERT_FILE 覆盖机制,思路是相通的。
抓包工具选型:Charles、mitmproxy、Proxyman 在证书信任上的差异
先说结论:无论你用 Charles、mitmproxy 还是 Proxyman,出现“charles抓包证书不受信任”这类报错时,根因几乎都落在同一处——客户端没有把你的根证书加入受信任存储。三者用的都是标准中间人(MITM)模型:首次启动时在本地生成一对根证书和私钥,之后对每个目标站点动态签发叶证书;客户端只有在信任链上认下那张根证书,后续的 TLS 握手才能通过校验。差异只在于文件叫什么名字、放在哪里、怎么导入。
- Charles:根证书导出为
charles.pem(部分版本导出名为charles-proxy-ssl-proxying-certificate.pem),也可以通过手机浏览器访问chls.pro/ssl直接下载。macOS 下常驻目录为~/Library/Application Support/Charles/ca/。 - mitmproxy:默认写入
~/.mitmproxy/,根证书为mitmproxy-ca-cert.pem,同时生成.p12(带私钥)与.cer。据 mitmproxy 官方文档,该目录可通过confdir选项改写。 - Proxyman:走菜单
Help → Certificate → Install Certificate on this Mac,证书写入系统钥匙串,移动端同样通过向导生成描述文件。
想把证书固定进 Docker 镜像或 CI 缓存,用 mitmproxy 最省事:
# mitmproxy 10.x / 11.x 适用;confdir 默认值为 ~/.mitmproxy
# 指定固定目录后,首次启动即在其中生成 mitmproxy-ca-cert.pem 等文件
mitmdump --set confdir=/opt/mitm --listen-port 8080
# 校验根证书信息,确认客户端导入的就是这一张(SHA-256 指纹应与设备上一致)
openssl x509 -in /opt/mitm/mitmproxy-ca-cert.pem -noout -subject -fingerprint -sha256
# Charles 用户可在 macOS 上确认根证书有效期与主体
openssl x509 -in ~/Library/Application Support/Charles/ca/charles-proxy-ssl-proxying-certificate.pem
-noout -subject -dates
选型时价格与授权是硬约束(以下为 2024–2025 年官网公开价,采购前请复核):
| 工具 | 授权与价格 | 根证书文件 / 导入入口 | 自动化能力 |
|---|---|---|---|
| Charles 4.6.x | 单用户 50 美元买断,含一年免费升级;5 用户 250 美元 | charles.pem,或 chls.pro/ssl |
图形化 Rewrite / Map Local / Throttle,脚本能力弱 |
| Proxyman | 个人版 69 美元起,团队版按人数递增 | Help → Certificate 向导 | 内置脚本,macOS Apple Silicon 内存占用明显低于 Charles 4.6.x |
| mitmproxy | MIT 开源协议,0 成本 | ~/.mitmproxy/mitmproxy-ca-cert.pem |
mitmdump + Python 插件,可做断言与流量回放 |
| Fiddler Everywhere | 99 美元/年订阅 | 内置导出向导 | Windows 生态友好 |
按场景挑更实际:日常手工排查 1–2 台设备,Charles 的交互效率最高;要在流水线里对 500 条请求做回归断言,mitmdump -s assert.py 这类脚本化方案更合适;团队设备超过 20 台且已有 MDM,优先选根证书可命令行下发、目录可固化的工具,减少逐台点“信任”。平台维度上,Windows 可选 Charles 或 Fiddler,Linux 桌面基本只剩 Charles 与 mitmproxy。
需要强调的是:工具换了,排查逻辑不变。Android 7 起用户证书默认不被应用信任、Android 14 进一步收紧 CA 证书更新与 debuggable 应用的信任范围,iOS 则必须在“证书信任设置”里手动打开完全信任开关——这些坑在三个工具上完全一致,区别只是你手上那张 .pem 的名字。
因为 Android 7.0(API 24)起,targetSdkVersion ≥ 24 的应用默认只信任系统 CA,设置里安装的用户证书不进入 App 的信任链。解决方式有两种:root 后把证书按 .0 命名写入 /system/etc/security/cacerts(Android 14 改用 /apex/com.android.conscrypt/cacerts),或在 App 的 network_security_config.xml 中声明 certificates src="user" 并重新打调试包。
NSURLErrorDomain Code=-1202 基本都指向“证书信任设置”开关没打开。进入设置 → 通用 → 关于本机 → 证书信任设置,确认 Charles Proxy CA 的开关是绿色。如果列表里根本没有该证书,说明描述文件安装失败,需要改用 Safari 访问 chls.pro/ssl 重新下载安装,Chrome for iOS 无法触发描述文件安装流程。
机制完全一致,都是自签根证书做中间人签发,客户端必须把对应根证书导入信任库,所以排查思路通用。差异在工程化程度:mitmproxy 免费开源,可用 –set confdir 把证书目录固化进 Docker 镜像,适合 CI;Charles 单用户 50 美元买断,图形化调试功能更全;Proxyman 个人版 69 美元起,在 Apple Silicon 上资源占用更低。
这是 Android 端最典型的证书信任错误,含义是找不到可信的根证书锚点。先确认 Charles 根证书是否已安装到设备,再确认 App 的 targetSdkVersion 是否 ≥ 24,最后检查 App 是否配置了 network_security_config。三者都排除后,考虑该 App 启用了证书固定(Certificate Pinning),需要 hook 或使用官方测试包。
对 targetSdkVersion ≥ 24 的第三方 App,不 root 基本抓不到,因为用户证书不被应用信任。可行的替代路径有三条:让开发提供带 network_security_config 的调试包;使用 Android 6.0 及以下的模拟器(默认信任用户证书);用 Frida 或 LSPosed 模块 hook 掉校验逻辑,但会面临风控检测和闪退风险。
会。Charles 生成的根证书默认有效期约 1 年,过期后所有客户端都会报 certificate has expired。建议在到期前 30 天通过 Help → Reset Charles Root Certificate 重新生成,然后同步更新设备、CI 变量和容器镜像里的 charles.pem。用 openssl x509 -in charles.pem -noout -dates 可以随时查看 notAfter 时间。
macOS 用 sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain charles.pem,配合 MDM 下发;Windows 通过组策略的公钥策略导入到“受信任的根证书颁发机构”;Linux 用 Ansible 复制到 /usr/local/share/ca-certificates/ 后执行 update-ca-certificates;移动设备建议走 MDM 的描述文件通道,可免去 iOS 手动打开信任开关的步骤。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。