wget 报错 Unable to locally verify the issuer’s authority:CA 证书链排查与修复完全指南
一、这个错误到底在说什么
Unable to locally verify the issuer's authority 是 GnuTLS 后端的 wget 在 TLS 握手后校验证书链时抛出的提示。它并不表示服务器证书一定有问题,而是说:wget 已经拿到了服务器发来的证书链,但本地找不到可以锚定这条链的根证书 / 中间证书,因此无法判定签发者(issuer)可信。
典型完整输出如下:
$ wget https://example.com
--2024-05-11 10:22:31-- https://example.com/
Resolving example.com (example.com)... 93.184.216.34
Connecting to example.com (example.com)|93.184.216.34|:443... connected.
ERROR: cannot verify example.com's certificate, issued by 'CN=R3,O=Let's Encrypt,C=US':
Unable to locally verify the issuer's authority.
To connect to example.com insecurely, use `--no-check-certificate'.
如果 wget 编译时链接的是 OpenSSL 而非 GnuTLS,同一根因会表现为另一种文案:
ERROR: The certificate of 'example.com' is not trusted.
ERROR: The certificate of 'example.com' hasn't got a known issuer.
因此根因通常只有三类:
- 系统 CA 证书包缺失或过期(精简容器镜像、最小化安装最常见);
- 信任库没有刷新(包已装,但
ca-certificates.crt为空或未重建); - wget 配置指向了错误的 CA 文件路径(
/etc/wgetrc中的ca_certificate),或目标站点用了自签 / 企业内网 CA。
二、30 秒定位根因
先确认三件事:wget 用的是哪个 TLS 后端、CA 包是否装了、CA 文件是否真的有内容。
# 1. 看 TLS 后端:出现 +ssl/gnutls 或 +ssl/openssl
wget --version | head -3
# 2. 看 CA 包是否安装
# Debian / Ubuntu
dpkg -l ca-certificates | tail -2
# RHEL / CentOS / Rocky / AlmaLinux
rpm -q ca-certificates
# 3. 看 CA bundle 是否存在、条目数量是否正常
ls -l /etc/ssl/certs/ca-certificates.crt /etc/pki/tls/certs/ca-bundle.crt 2>/dev/null
grep -c 'BEGIN CERTIFICATE' /etc/ssl/certs/ca-certificates.crt 2>/dev/null
正常情况下条目数在数百量级(150~300 之间很常见)。如果是 No such file or directory、文件为 0 字节,或者条目数为 0/1,那问题就定位到了 CA 包或信任库。
再确认目标服务器的证书链本身能否验证:
echo | openssl s_client -connect example.com:443 -servername example.com 2>&1 | grep -i 'Verify return code'
# 期望:Verify return code: 0 (ok)
如果这里返回 20 (unable to get local issuer certificate) 或 21 (unable to verify the first certificate),说明本地信任库确实不认这条链;如果返回 0 (ok) 而 wget 仍报错,则是 wget 自己配置了别的 CA 路径(见第五节)。
三、方案一:安装或重装 CA 证书包
绝大多数情况下,重装 ca-certificates 即可解决。各发行版命令如下:
# Debian / Ubuntu
apt-get update && apt-get install --reinstall ca-certificates
# RHEL / CentOS / Rocky / AlmaLinux / Fedora
dnf install -y ca-certificates
# 老版本用 yum
yum install -y ca-certificates
# Alpine Linux
apk add --no-cache ca-certificates
# Arch Linux
pacman -S --noconfirm ca-certificates-utils ca-certificates-mozilla
# openSUSE / SLES
zypper install -y ca-certificates
几个容易踩的坑:
- 容器镜像里根本没装:
debian:slim、alpine、scratch基镜像默认不带 CA 包,必须在 Dockerfile 里显式安装。 - 包已安装但 postinst 脚本被跳过(常见于被裁剪的镜像或失败的 apt 事务),此时
apt-get install --reinstall ca-certificates会重新触发钩子。 - 离线环境:无法联网时,把
ca-certificates的 .deb/.rpm 包和依赖一起拷进去,或直接从同版本机器复制/etc/ssl/certs/ca-certificates.crt(Debian 系)//etc/pki/tls/certs/ca-bundle.crt(RHEL 系)。
四、方案二:刷新系统信任库并验证
包装上不等于信任库已生成,必须执行一次刷新命令。注意 Debian 系和 RHEL 系的命令完全不同,不能混用。
# Debian / Ubuntu / Alpine:重建 /etc/ssl/certs 下的符号链接与 ca-certificates.crt
update-ca-certificates --fresh
# RHEL / CentOS / Rocky / AlmaLinux / Fedora:生成 /etc/pki/tls/certs/ca-bundle.crt
update-ca-trust extract
# Arch:生成兼容路径
trust extract-compat
刷新后立即复验:
grep -c 'BEGIN CERTIFICATE' /etc/ssl/certs/ca-certificates.crt
# 确认某个具体根证书是否在里面,例如 Let's Encrypt 的 ISRG Root X1
openssl crl2pkcs7 -nocrl -certfile /etc/ssl/certs/ca-certificates.crt
| openssl pkcs7 -print_certs -noout | grep -i 'ISRG Root'
# 最终验证
wget -q --spider https://example.com && echo OK
如果 update-ca-certificates 报 command not found,说明你在 RHEL 系机器上,请改用 update-ca-trust extract;反之在 Debian 系用 update-ca-trust 同样会提示找不到命令。
五、方案三:检查 wget 的配置与证书路径
wget 有三级配置:命令行参数 > 用户 ~/.wgetrc > 全局 /etc/wgetrc,另外环境变量 WGETRC 可指定任意配置文件。如果系统 CA 正常但 wget 仍报错,多半是这里写死了路径。
# 查看生效的配置中与证书相关的行
grep -nE 'ca_certificate|ca_directory|check_certificate|^certificate|private_key'
/etc/wgetrc ~/.wgetrc 2>/dev/null
# 查看 wget 实际读取的配置文件(调试模式会打印)
wget --debug https://example.com 2>&1 | grep -iE 'wgetrc|ca_certificate|ca-directory'
典型错误写法是 /etc/wgetrc 里残留了一行指向 Debian 路径的配置,而系统实际是 RHEL:
ca_certificate = /etc/ssl/certs/ca-certificates.crt # RHEL 上此文件不存在
改成对应系统的真实路径,或直接注释掉让 wget 使用默认值:
# Debian 系
ca_certificate = /etc/ssl/certs/ca-certificates.crt
# RHEL 系
ca_certificate = /etc/pki/tls/certs/ca-bundle.crt
也可以只对单次命令生效,不动配置文件:
wget --ca-certificate=/etc/pki/tls/certs/ca-bundle.crt https://example.com
wget --ca-directory=/etc/ssl/certs https://example.com
# OpenSSL 后端的 wget 还会读取这两个环境变量
export SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt
export SSL_CERT_DIR=/etc/ssl/certs
注意:SSL_CERT_FILE / SSL_CERT_DIR 只对 OpenSSL 后端有效,GnuTLS 后端的 wget 不认这两个变量,此时必须用 --ca-certificate 或改 wgetrc。
六、方案四:自签证书与企业内网 CA
如果证书签发者是公司自建 CA、内部 K8s Ingress 或中间人代理(HTTPS 代理、WAF、抓包工具),公共根证书列表里当然找不到它,必须把该 CA 显式加入信任库。
# Debian / Ubuntu:文件名必须以 .crt 结尾,内容为 PEM
sudo cp internal-ca.crt /usr/local/share/ca-certificates/internal-ca.crt
sudo update-ca-certificates
# RHEL / CentOS / Rocky / AlmaLinux
sudo cp internal-ca.crt /etc/pki/ca-trust/source/anchors/internal-ca.crt
sudo update-ca-trust extract
不想污染系统信任库时,可只对单条命令生效:
wget --ca-certificate=/path/to/internal-ca.pem https://intranet.example.com/
容器场景请在镜像构建阶段完成:
FROM debian:12-slim
RUN apt-get update
&& apt-get install -y --no-install-recommends ca-certificates
&& rm -rf /var/lib/apt/lists/*
COPY internal-ca.crt /usr/local/share/ca-certificates/internal-ca.crt
RUN update-ca-certificates
使用 scratch 或 distroless 基镜像时,直接从构建阶段复制证书包:
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ca-certificates.crt
七、各方案对比
| 方案 | 适用场景 | 关键命令 | 作用范围 | 持久性 | 安全影响 |
|---|---|---|---|---|---|
| 重装 CA 包 | 镜像精简、包损坏、首次部署 | apt install --reinstall ca-certificates / dnf install ca-certificates |
全系统 | 持久 | 无,推荐首选 |
| 刷新信任库 | 包已装但 bundle 为空或未更新 | update-ca-certificates --fresh / update-ca-trust extract |
全系统 | 持久 | 无,推荐首选 |
| 修正 wgetrc 路径 | 系统 CA 正常但 wget 指向错误文件 | 编辑 /etc/wgetrc 的 ca_certificate |
该机器上所有 wget 调用 | 持久 | 无 |
命令行 --ca-certificate |
临时验证、CI 脚本、单一站点 | wget --ca-certificate=/path/ca.pem URL |
单次命令 | 不持久 | 无 |
| 导入自签 / 内网 CA | 企业内网、代理 MITM、私有 PKI | cp ca.crt /usr/local/share/ca-certificates/ + update-ca-certificates |
全系统 | 持久 | 需确认 CA 来源可信 |
--no-check-certificate |
仅限排障与一次性测试 | wget --no-check-certificate URL |
单次命令 | 不持久 | 高危:丧失身份校验,可被中间人攻击 |
八、真实错误信息速查与故障排查
下面这些报错在实际环境中高频出现,按文案对照即可判断根因。
ERROR: cannot verify example.com's certificate, issued by '...': Unable to locally verify the issuer's authority.
CA 包缺失或 bundle 为空。处理:安装ca-certificates并执行update-ca-certificates --fresh。ERROR: The certificate of 'example.com' is not trusted.
OpenSSL 后端的同义报错,或站点使用自签证书。处理:先查openssl s_client -showcerts的签发者,若为内网 CA 则导入信任库。ERROR: The certificate of 'example.com' hasn't got a known issuer.
服务器下发的证书链不完整(缺中间证书)。处理:服务端补齐 fullchain;客户端可临时用--ca-certificate指向含中间证书的 PEM。ERROR: The certificate of 'example.com' has expired.
证书确实过期,或本机时间严重偏差。处理:date -u核对时间,必要时timedatectl set-ntp true;确认无误则需服务端续签。ERROR: certificate common name 'www.example.com' doesn't match requested host name 'example.com'.
SNI / 主机名不匹配,常见于用 IP 直接访问或 Hosts 指向错误。处理:使用证书中登记的域名访问,或加--header无济于事——应改 DNS/Hosts。Unable to establish SSL connection.
协议或加密套件协商失败,多见于老旧 wget 访问仅支持 TLS 1.2+ 的站点。处理:升级 wget,或用wget --secure-protocol=TLSv1_2显式指定。verify error:num=20:unable to get local issuer certificate
OpenSSL 侧的同根因报错,等价于本文主题。处理:openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt cert.pem逐级定位。curl: (60) SSL certificate problem: unable to get local issuer certificate
与 wget 同源问题,说明是系统级 CA 缺失而非 wget 独有。处理:按第三节重装 CA 包,两条命令应同时恢复正常。update-ca-certificates: command not found
在 RHEL 系执行了 Debian 的命令。处理:改用update-ca-trust extract。- 浏览器正常、wget 报错
浏览器自带证书库并会缓存中间证书,wget 只用系统信任库。处理:以openssl s_client的结果为准,补齐系统 CA。 - 公司网络下所有 https 都失败
出口存在 HTTPS 解密代理,返回的是代理自签证书。处理:向运维索取代理根证书并导入信任库,切勿长期使用--no-check-certificate。
排障时务必打开调试输出,它会把证书链、CA 路径、失败点全部打印出来:
wget --debug https://example.com 2>&1 | grep -iE 'certificate|issuer|CA|verify'
九、FAQ
Q1:直接加 --no-check-certificate 不就完了?
A:只建议用于确认「是不是证书问题」这一瞬间。它会完全关闭证书校验,任何中间人都能冒充目标站点并读取你的请求内容,生产脚本与 CI 流水线中禁止使用。若需长期免校验,正确做法是导入对应 CA。
Q2:--no-check-certificate 在配置文件里怎么写?
A:/etc/wgetrc 或 ~/.wgetrc 中写 check_certificate = off。这会影响该机器上所有 wget 调用,风险比命令行参数更大,务必谨慎。
Q3:为什么 curl 也报错,是不是 wget 坏了?
A:恰恰相反,这说明问题是系统级 CA 缺失而非 wget 配置。两者共用系统信任库,修好 CA 后应当同时恢复。
Q4:怎么判断 wget 用的是 GnuTLS 还是 OpenSSL?
A:执行 wget --version | head -3,特性行中会显示 +ssl/gnutls 或 +ssl/openssl。这决定了 SSL_CERT_FILE 环境变量是否有效,也决定了报错文案。
Q5:容器里装了 ca-certificates 还是报错?
A:检查三点:一是 Dockerfile 中安装后是否被后续 rm -rf 误删;二是 scratch/distroless 基镜像必须显式 COPY 证书包;三是多阶段构建时证书是否只装在了 builder 阶段而没带到运行阶段。
Q6:update-ca-certificates 执行成功,但文件还是空的?
A:检查 /etc/ca-certificates.conf 是否被误改(行首的 ! 表示禁用),以及 /usr/share/ca-certificates/ 目录是否被裁剪。可执行 update-ca-certificates --fresh 强制重建全部符号链接。
Q7:只想让某一条命令信任内网 CA,不想改系统?
A:用 wget --ca-certificate=/path/to/internal-ca.pem https://intranet.example.com/。注意该文件必须是 PEM 格式;如果内网是「根 CA + 中间 CA」结构,把两者按顺序拼进同一个文件即可。
Q8:证书没过期、CA 也装了,为什么还是 verify 失败?
A:大概率是证书链不完整——服务器只下发了叶子证书,没带中间证书。用 openssl s_client -showcerts -connect host:443 -servername host 看返回了几个 BEGIN CERTIFICATE,正常应至少两个。这需要服务端修复,客户端无法单方面绕过。
Q9:能不能把 --no-check-certificate 写进 crontab 应急?
A:不建议。应急的正确姿势是:先导入正确 CA,或临时把 --ca-certificate 指向可信 PEM。真要临时放行,也应加注释与到期时间,并纳入后续整改清单。