curl: (60) SSL certificate problem: self signed certificate in certificate chain
服务器上跑 curl 突然报 curl: (60) SSL certificate problem: self signed certificate in certificate chain,浏览器打开同一个地址却完全正常——这是运维和开发最常撞见的 TLS 报错之一。它的本质是 curl 使用的信任库在证书链里遇到了一个它不认识的签发者,而不是「证书坏了」。
本文按「先定位、再修复」的顺序讲清楚两件事:证书链里为什么会混进自签证书,以及针对企业代理 / TLS 检查设备和真正的服务端自签两种场景,分别该怎么改配置、改代码、改信任库。文中所有命令可直接复制执行。
一、这个报错到底在说什么
curl 的错误码 60 对应 CURLE_PEER_FAILED_VERIFICATION,含义是「对端证书验证失败」。完整输出通常长这样:
$ curl -I https://example.com
curl: (60) SSL certificate problem: self signed certificate in certificate chain
More details here: https://curl.se/docs/sslcerts.html
curl failed to verify the legitimacy of the server and therefore could not
establish a secure connection to it. To learn more about this situation and
how to fix it, please visit the web page mentioned above.
拆开看三个关键词:
- certificate chain:curl 校验的不是一张证书,而是一条链——叶子证书(服务器证书)→ 中间证书 → 根证书。
- self signed:链中至少有一张证书的 issuer(签发者)等于 subject(主体),也就是自己签自己。
- in certificate chain:问题不一定出在服务器证书本身,很可能出在中间那一层——这正是「浏览器正常、curl 报错」的典型特征。
触发它的场景基本只有两类:
- 企业出口代理 / TLS 检查设备(Zscaler、Fortinet、深信服、天融信、Palo Alto 等)在中间做了 SSL 解密再重签,用企业自签根证书替换了原始证书链。浏览器里 IT 已经把根证书推下去了,所以浏览器正常;而服务器上的 curl 用的是系统
ca-certificates,不认识这张根证书。 - 服务端自己部署了自签证书,常见于内网测试环境、IP 直连、临时上线的服务。
顺带说明:不同 OpenSSL 版本输出的措辞略有差异,你可能会看到 self-signed certificate in certificate chain(带连字符)或 self signed certificate,指向的是同一个问题。
二、三步定位:问题在代理侧还是服务端侧
在改任何配置之前,先花一分钟确认签发者是谁,否则很容易改错地方。
第 1 步:看证书链的 issuer
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
输出里会连续出现若干 s:(subject)和 i:(issuer)。重点关注最上面那张叶子证书的 i::
- issuer 是
Zscaler Root CA、Fortinet Untrusted CA、公司拼音名之类的内网 CA → 走第三节,装代理根证书。 - issuer 和 subject 完全一样(例如都是
CN=test.internal)→ 服务端自签,走第四节。 - issuer 是
R3、Let's Encrypt、DigiCert却仍报错 → 多半是中间证书没配全,跳到第七节看unable to get local issuer certificate。
更紧凑的一行版本:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
第 2 步:确认 curl 用的是哪个信任库
curl -V
curl-config --ca
ls -l /etc/ssl/certs/ca-certificates.crt
常见路径:Debian/Ubuntu 是 /etc/ssl/certs/ca-certificates.crt,RHEL/CentOS 是 /etc/pki/tls/certs/ca-bundle.crt,Alpine 是 /etc/ssl/cert.pem。如果 curl -V 显示 Schannel 或 SecureTransport,说明它走的是 Windows / macOS 系统信任库,装证书的方式完全不同。
第 3 步:排除环境变量干扰
env | grep -i -E 'proxy|ca_bundle|ssl_cert|curl_ca'
如果 CURL_CA_BUNDLE 或 SSL_CERT_FILE 指向了一个不存在的文件,会出现 curl: (77) error setting certificate verify locations;如果指向了旧的 bundle,则会继续报 60。这种情况下改系统信任库是没用的。
三、方案 A:企业代理 / TLS 检查设备场景
结论先说:把代理的根证书装进 curl 使用的信任库,不要关校验。向 IT 或安全团队要 proxy-root.crt(PEM 格式),然后按平台操作。
Debian / Ubuntu
# 必须是 PEM 格式,扩展名用 .crt
sudo cp proxy-root.crt /usr/local/share/ca-certificates/proxy-root.crt
sudo update-ca-certificates
# 验证
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt proxy-root.crt
如果拿到的是 DER 格式(.cer、.der),先转换:
openssl x509 -inform DER -in proxy-root.cer -out proxy-root.crt
RHEL / CentOS / Rocky / AlmaLinux
sudo cp proxy-root.crt /etc/pki/ca-trust/source/anchors/
sudo update-ca-trust extract
macOS
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain proxy-root.crt
Windows(管理员 PowerShell)
Import-Certificate -FilePath .proxy-root.crt -CertStoreLocation Cert:LocalMachineRoot
或者用 certutil:
certutil -addstore -f Root proxy-root.crt
不改系统、只给 curl 用
没有 root 权限时,可以合并一个专用 bundle,再用 --cacert 指定:
cat /etc/ssl/certs/ca-certificates.crt proxy-root.crt > ~/bundle.crt
curl --cacert ~/bundle.crt https://example.com
# 或者用环境变量,对所有 curl 调用生效
export CURL_CA_BUNDLE=~/bundle.crt
注意:--cacert 会替换默认 bundle 而不是追加,所以一定要把系统原有证书一起 cat 进去,否则公网站点会集体报错。
其他运行时也要跟着配
代理证书问题往往不止 curl 一个受害者,Python、Node、Java、Git、npm、pip 各有各的信任库:
# Python requests
export REQUESTS_CA_BUNDLE=~/bundle.crt
export SSL_CERT_FILE=~/bundle.crt
# Node.js(追加,不是替换)
export NODE_EXTRA_CA_CERTS=~/proxy-root.crt
# Git
git config --global http.sslCAInfo ~/bundle.crt
# npm
npm config set cafile ~/bundle.crt
# pip
pip config set global.cert ~/bundle.crt
# Java
keytool -importcert -alias proxy-root -file proxy-root.crt -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit
Docker 镜像里需要在构建时把证书拷进去并刷新:
COPY proxy-root.crt /usr/local/share/ca-certificates/proxy-root.crt
RUN update-ca-certificates
四、方案 B:服务端自签,换成正规 CA 证书
如果确认签发者是服务端自己,正确做法不是让所有客户端去信任一张随手生成的自签证书,而是换成公有 CA 签发的证书。公网域名用 Let’s Encrypt 零成本,内网域名用 DNS-01 验证同样可以签。
Let’s Encrypt + certbot
sudo apt install certbot
sudo certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
# 演练续期,确认自动续期可用
sudo certbot renew --dry-run
Nginx 配置的关键点是必须用 fullchain.pem,用 cert.pem 会缺中间证书,客户端照样报错:
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:SSL:10m;
}
纯内网、80 端口不通时用 DNS-01:
sudo certbot certonly --manual --preferred-challenges dns -d internal.example.com
确实只能用自签:至少做成「私有 CA + 带 SAN 的服务器证书」
直接对服务器证书自签是最差的做法,因为每台客户端都要单独信任一张会过期的叶子证书。规范做法是建一个私有根 CA,再用它签发服务器证书:
# 1. 生成私有根 CA
openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout internal-ca.key -out internal-ca.crt -subj '/C=CN/O=Example/CN=Example Internal Root CA'
# 2. 生成服务器 CSR
openssl req -newkey rsa:2048 -nodes -keyout server.key -out server.csr -subj '/CN=internal.example.com'
# 3. 带 SAN 签发(现代客户端只认 SAN,不认 CN)
cat > san.cnf <<'EOF'
subjectAltName=DNS:internal.example.com,IP:10.0.0.10
basicConstraints=CA:FALSE
keyUsage=digitalSignature,keyEncipherment
extendedKeyUsage=serverAuth
EOF
openssl x509 -req -in server.csr -CA internal-ca.crt -CAkey internal-ca.key -CAcreateserial -out server.crt -days 825 -sha256 -extfile san.cnf
然后只需要把 internal-ca.crt 分发到各客户端(第三节的方法),续期或换服务器时都不用再动客户端。
五、临时绕过:curl -k 的正确用法与边界
调试阶段可以用 -k(等价于 --insecure)快速确认「是不是纯证书问题」:
curl -k https://example.com
curl --insecure -vI https://example.com
判断逻辑很简单:加 -k 就正常、不加就报 60,说明网络、DNS、路由、协议全都没问题,问题 100% 在证书信任上。
但边界必须说清楚:
- 生产代码严禁跳过校验。
-k会让中间人攻击变成静默成功,等于把 TLS 降级成明文。 - 不要把
verify=False、rejectUnauthorized: false、NODE_TLS_REJECT_UNAUTHORIZED=0写进 CI 脚本、Dockerfile 或 SDK 初始化代码里——它们会随着代码一路进生产。 - 确实需要长期容忍某张证书,用
--cacert或CURL_CA_BUNDLE精确指定,而不是全局关校验。 - 如果团队里已经有人加了
-k来「解决」报错,把它当成一个待修的技术债记录下来。
六、几种方案横向对比
| 场景 | 推荐做法 | 关键命令 / 配置 | 安全性 | 维护成本 |
|---|---|---|---|---|
| 企业代理 / TLS 检查导致 curl 报错 | 把代理根证书装入系统信任库 | update-ca-certificates / update-ca-trust extract |
高(仅信任指定根) | 低,证书轮换时更新一次 |
| 无 root 权限,只想让某个脚本通过 | 合并 bundle + --cacert |
cat ca-certificates.crt proxy-root.crt > bundle.crt |
高 | 中,需随系统证书更新 |
| 公网域名服务端自签 | 换 Let’s Encrypt 证书 | certbot certonly --webroot |
高 | 低,自动续期 |
| 内网域名、80 端口不可达 | DNS-01 签发或私有 CA | certbot --preferred-challenges dns |
高 | 中 |
| 纯离线内网 | 私有根 CA + SAN 服务器证书,分发根证书 | openssl req -x509 + openssl x509 -req -extfile |
中高 | 中,需管理 CA 私钥 |
| 一次性调试 | curl -k |
curl -k -vI https://example.com |
低(不校验) | 无 |
| 容器 / CI 环境 | 构建时注入根证书并刷新 | COPY + RUN update-ca-certificates |
高 | 低 |
七、常见报错与排查清单
下面这些都是在 curl: (60) 附近经常一起出现的真实报错,按现象对症:
| 报错原文 | 含义 | 处理 |
|---|---|---|
curl: (60) SSL certificate problem: self signed certificate in certificate chain |
链中存在未受信任的自签证书 | 装代理根证书,或服务端换正规证书 |
curl: (60) SSL certificate problem: self signed certificate |
叶子证书本身就是自签的 | 服务端换证书;或把该自签根加入信任库 |
curl: (60) SSL certificate problem: unable to get local issuer certificate |
缺中间证书,或根 CA 不在信任库 | Nginx 改用 fullchain.pem;补齐中间证书 |
curl: (60) SSL certificate problem: certificate has expired |
证书过期 | certbot renew;检查系统时间 |
curl: (60) SSL certificate problem: certificate is not yet valid |
系统时间早于生效时间 | date -u 校准 NTP |
curl: (51) SSL: no alternative certificate subject name matches target host name 'example.com' |
证书 SAN 不含访问的域名 | 重新签发,把域名和 IP 都写进 SAN |
curl: (77) error setting certificate verify locations: CAfile: /etc/ssl/certs/ca-certificates.crt CApath: none |
CA 文件路径不存在或无读权限 | 检查 CURL_CA_BUNDLE,重装 ca-certificates |
curl: (35) OpenSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.com:443 |
握手被中断,常见于代理要求认证或协议不匹配 | curl -v 看握手阶段;检查代理与 TLS 版本 |
curl: (7) Failed to connect to example.com port 443: Connection refused |
不是证书问题,是端口不通 | 查防火墙、安全组、服务是否监听 |
排查动作清单
# 1. 打印完整握手过程
curl -vI https://example.com 2>&1 | head -60
# 2. 让 openssl 严格校验,拿到明确的失败原因
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
# 3. 看证书有效期与 SAN
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates -subject -issuer -ext subjectAltName
# 4. 校验整条链(chain.pem 为中间证书)
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem server.crt
# 5. 确认系统时间
date -u
几个高频坑:
- 装完证书没生效:
update-ca-certificates只会扫描/usr/local/share/ca-certificates/下的.crt文件,文件后缀写成.pem会被静默忽略。 - Java 应用仍报错:Java 用
cacerts,和系统信任库完全独立,必须keytool单独导入。 - Docker 里改了宿主机的证书:容器有自己的文件系统,宿主机装好不等于容器装好。
- curl 是静态编译的:某些二进制发行版把 CA 路径编译死了,需要用
CURL_CA_BUNDLE覆盖。
八、FAQ
Q1:浏览器访问正常,为什么 curl 报错?
浏览器有自己的一套信任逻辑:Chrome/Edge 走系统信任库,Firefox 走内置库,而且企业 IT 通常已经通过组策略把代理根证书推到浏览器里了。服务器上的 curl 用的是 OpenSSL 的 ca-certificates 包,两者并不共享。所以「浏览器正常」恰恰是代理替换证书的典型信号。
Q2:把代理根证书装进系统后就一定好了吗?
不一定。还要确认三件事:证书是 PEM 格式、update-ca-certificates 输出里出现了 1 added、curl 实际使用的是这个 bundle(curl -V / curl-config --ca)。另外已经建立的连接或常驻进程可能需要重启才能读到新证书。
Q3:curl -k 能临时上线吗?
不能。它跳过的是整条证书链的校验,攻击者只要能在链路上做一次 ARP 欺骗或 DNS 劫持,就能完整读取和篡改流量。临时验证可以,生产环境必须改成 --cacert 或修信任库。
Q4:怎么确认是代理在替换证书,而不是服务端自签?
看叶子证书的 issuer 字段。issuer 是公司名、安全厂商名称或内网 CA 名,就是代理;issuer 等于 subject,就是自签;issuer 是知名 CA 却仍报错,多半是中间证书缺失。对比一下「直连出口」和「走代理」两次 openssl s_client 的输出,差异一目了然。
Q5:Let’s Encrypt 证书能用在纯内网吗?
可以,但验证方式要换。内网服务器通常没有公网 80 端口,HTTP-01 走不通,用 DNS-01:给 internal.example.com 加一条 TXT 记录即可签发。前提是这个域名有公网 DNS 解析能力,纯离线环境只能走私有 CA。
Q6:为什么 Python / Node / Java 也同时报证书错误?
因为它们各自维护信任库:Python requests 看 certifi 或 REQUESTS_CA_BUNDLE,Node 看 NODE_EXTRA_CA_CERTS,Java 看 $JAVA_HOME/lib/security/cacerts。修完 curl 只解决了 curl,其他运行时需要按第三节的清单逐个配置。
Q7:证书链怎么自查是否完整?
用 openssl s_client -showcerts 抓下全部证书,再用 openssl verify -CAfile 根证书 -untrusted 中间证书 服务器证书 验证。返回 OK 说明链完整;返回 unable to get local issuer certificate 说明中间证书没下发。
Q8:公司不允许改系统信任库怎么办?
三条路:一是申请把证书装进项目专用的 bundle,用 CURL_CA_BUNDLE 或 --cacert 指定;二是在 CI 镜像构建阶段注入(需要平台团队配合);三是让服务端改用公有 CA 签发的证书,从根上绕开代理信任问题。
九、上线前检查清单
- 已确认问题出在代理侧还是服务端侧(看 issuer)。
- 代理场景:根证书已装进所有相关运行时的信任库,而不只是 curl。
- 服务端场景:使用 fullchain(含中间证书),SAN 覆盖所有访问域名与 IP。
- 证书有效期已接入监控,续期任务有
--dry-run验证。 - 代码仓库全局搜索
-k、--insecure、verify=False、rejectUnauthorized,确认没有残留。 - 容器镜像与 CI 环境已同步根证书,不依赖宿主机状态。
归根到底一句话:证书链报错是信任边界的问题,不是加密算法的问题。 找到那个「不被信任的签发者」,要么让客户端认识它(装根证书),要么换一个客户端本来就认识的签发者(正规 CA)。绕过去很容易,但只有前两条路能带进生产。