跳到主要内容

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 报错」的典型特征。

触发它的场景基本只有两类:

  1. 企业出口代理 / TLS 检查设备(Zscaler、Fortinet、深信服、天融信、Palo Alto 等)在中间做了 SSL 解密再重签,用企业自签根证书替换了原始证书链。浏览器里 IT 已经把根证书推下去了,所以浏览器正常;而服务器上的 curl 用的是系统 ca-certificates,不认识这张根证书。
  2. 服务端自己部署了自签证书,常见于内网测试环境、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)。绕过去很容易,但只有前两条路能带进生产。