SSL证书安装教程 troubleshooting:443端口、SNI与中间链排错
1)SSL证书安装教程 troubleshooting 的核心答案是:先按 DNS→443/TCP→SNI→fullchain 中间链→系统时间→reload 六段定位,多数“安装失败”在前四段就能复现;2)`openssl s_client -connect example.com:443 -servername example.com -showcerts -verify_return_error </dev/null` 返回 `Verify return code: 0 (ok)` 才算握手与链验证通过;3)Nginx 1.26 的 `ssl_certificate` 必须指向 `fullchain.pem`,只配 `cert.pem` 常见 `curl: (60) unable to get local issuer certificate`;4)系统时间偏移建议控制在 5 分钟内,`chronyc tracking` 的 `System time` 偏移小于 0.1 秒;5)续期后不 reload 不会生效,certbot 2.11 加 `--deploy-hook 'systemctl reload nginx'` 并用 `certbot renew --dry-run` 验证。
为什么证书“装好了”仍报错?443、SNI、中间链、时间四个根因
结论先行:证书文件存在,不等于 TLS 握手成功。据 Let’s Encrypt 官方文档,签发成功后真正要装到 Web 服务器上的是 fullchain.pem(站点证书 + 中间 CA),而不是 cert.pem;很多人在这条 ssl证书 安装教程 troubleshooting 链路上只走完了”拿到文件”这一步。正确的定位顺序是 DNS → 443/TCP → SNI → 证书链 → 系统时间 → 应用 reload,每一环都有唯一命令可验证,通常 3 分钟内就能撞到第一个失败断点。
| 断点 | 验证命令 | 正常表现 | 失败特征 |
|---|---|---|---|
| DNS | dig +short example.com A AAAA |
返回预期 IP | 空记录 / 旧 IP 未过 TTL |
| 443/TCP | sudo ss -lntp | grep ':443' |
nginx 或 httpd 处于 LISTEN | 无输出 = 未监听或安全组丢包 |
| SNI | openssl s_client -servername |
subject 等于目标域名 | 返回默认 vhost 的证书 |
| 证书链 | openssl s_client -showcerts |
≥ 2 张证书 | 仅 1 张(缺中间 CA) |
| 系统时间 | timedatectl |
System clock synchronized: yes | 漂移导致 not yet valid |
| reload | systemctl show nginx -p ActiveEnterTimestamp |
晚于证书 mtime | 进程仍加载旧证书 |
根因一:443 未放行,或被 IPv6 绕过。端口没监听和端口被云安全组丢弃是两种故障,ss 能区分。注意 AAAA 记录存在时,浏览器会优先走 IPv6,而安全组常只放行了 IPv4 的 443/TCP:
# 分别验证两条栈路,结果可能不一致
curl -4 -sI https://example.com | head -1 # HTTP/2 200
curl -6 -sI https://example.com | head -1 # curl: (7) Failed to connect
sudo ss -lntp | grep ':443' # 应看到 nginx/httpd 的 PID 与 LISTEN
根因二:SNI 未命中。SNI 由 RFC 6066 定义,客户端在 ClientHello 里携带目标主机名;不带 -servername 时 OpenSSL 客户端不发 SNI,服务器只能回默认 443 vhost 的证书。同一 IP 多站点时对比两条命令:
openssl s_client -connect 1.2.3.4:443 -servername example.com
</dev/null 2>/dev/null | openssl x509 -noout -subject
openssl s_client -connect 1.2.3.4:443
</dev/null 2>/dev/null | openssl x509 -noout -subject # 常返回别的域名
Nginx 1.26 中需显式写全 server_name example.com www.example.com;,且不要把 listen 443 ssl default_server; 留给一个不相关的站点——它会吃掉所有未匹配的 SNI 请求。
根因三:中间链缺失。这是 ssl证书 安装教程里最高频的坑。Nginx 的 ssl_certificate 必须指向 fullchain.pem,只配 cert.pem 时 curl 直接报 curl: (60) SSL certificate problem: unable to get local issuer certificate,OpenSSL 3.x 客户端则报 error:0A000086:SSL routines::certificate verify failed,浏览器表现为 NET::ERR_CERT_AUTHORITY_INVALID。
# 正常应输出 2 或以上(站点证书 + 中间 CA,不含根证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts
</dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# /etc/nginx/conf.d/example.com.conf (Nginx 1.26 适用)
server {
listen 443 ssl;
http2 on; # 1.25.1+ 语法,旧版用 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 关键:fullchain
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3; # 与 Mozilla 生成器 intermediate 配置一致
ssl_session_cache shared:SSL:10m;
}
根因四:系统时间漂移。RFC 5280 规定客户端必须校验 notBefore/notAfter,服务器时钟快慢都会让一张刚签发的证书”尚未生效”或”已过期”。据 chrony 文档,建议把偏移压在 0.1 秒以内:
timedatectl # 需为 System clock synchronized: yes, NTP service: active
chronyc tracking | grep -E 'System time|Leap status' # System time 偏移应 < 0.1 秒
最后一环:配置未 reload。nginx -t 只校验语法,不重载进程。用证书 mtime 与进程启动时间对比即可确认:
nginx -t && systemctl reload nginx
stat -c '%y' /etc/letsencrypt/live/example.com/fullchain.pem
systemctl show nginx -p ActiveEnterTimestamp # 必须晚于上一行的 mtime
四类根因对应四种不同报错,排错时不要从配置文件读起,而是从客户端侧由外向内逐层验证——第一个失败的断点就是答案。
完整实操步骤:从 CSR 到 Nginx/Apache 生效的 6 步编号流程
问:从拿到域名到 Nginx/Apache 真正在 443 上跑通,最少需要几步?答:六步,而且顺序不能颠倒。跳过其中任何一步,后面 443 端口、SNI、中间链的排查成本都会翻倍——这也是每一版 ssl证书 安装教程 troubleshooting 里最该先固定下来的骨架。
- 备份配置并核对解析。改配置前先留一份带日期的副本,同时确认 A 与 AAAA 记录都指向目标 IP;只有 AAAA 记录指向旧机器,是 HTTPS 间歇性失败的常见原因。
# 备份,文件名带日期,出问题可直接 mv 回来
cp /etc/nginx/conf.d/site.conf /etc/nginx/conf.d/site.conf.$(date +%F)
# A 与 AAAA 都要核对:有 AAAA 就必须同时监听 [::]:443
dig +short example.com A
dig +short example.com AAAA
- 生成私钥与 CSR。OpenSSL 1.1.1 起支持
-addext,可在生成 CSR 时直接写入 SAN;RSA 2048 与 ECDSA P-256 都可签发,选型见下表。SAN 必须覆盖站点所有域名,漏一个www就会触发NET::ERR_CERT_COMMON_NAME_INVALID。
# OpenSSL 3.0:一条命令产出 2048 位私钥 + 带 SAN 的 CSR
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj '/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# 回读确认 SAN 列表完整
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
| 对比项 | RSA 2048 | ECDSA P-256 |
|---|---|---|
| 生成参数 | -newkey rsa:2048 |
-newkey ec -pkeyopt ec_paramgen_curve:prime256v1 |
| 证书与签名体积 | 约 1.5 KB | 约 0.8 KB |
| 兼容性 | 几乎所有客户端 | Android 7+/现代浏览器;极老设备与部分嵌入式客户端不支持 |
| 适用建议 | 默认首选,兼容兜底 | 移动端流量为主、追求握手性能时使用 |
- 完成 DCV 验证并下载证书。据 Let’s Encrypt 文档,ACME v2(RFC 8555)常用 HTTP-01 或 DNS-01;商业 DV 证书多为邮件或 DNS TXT 验证。TXT 记录 TTL 建议设 60–300 秒,保存后等 1–10 分钟再点验证,立刻验证大概率读到旧缓存。
# HTTP-01 前先确认挑战路径可达(应返回 200/404,而不是 301 到 https)
curl -I http://example.com/.well-known/acme-challenge/test
# DNS-01 用 TXT,先本地确认已生效
dig +short TXT _acme-challenge.example.com
- 合并 fullchain。顺序是”站点证书在前、中间 CA 在后”,反过来部分客户端会直接握手失败;根证书不要放进去。
# 拼接:站点证书 + 中间 CA
cat example.com.crt intermediate.crt > fullchain.pem
grep -c 'BEGIN CERTIFICATE' fullchain.pem # 常见输出 2,交叉链场景可能为 3
- 写入 Web 服务器配置。Nginx 的
ssl_certificate直接指向 fullchain;Apache 2.4.8 起SSLCertificateChainFile已废弃,同样交给SSLCertificateFile。
# Nginx 1.26:/etc/nginx/conf.d/site.conf 的 server 块内
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
# Apache 2.4.58:虚拟主机内
SSLCertificateFile /etc/nginx/ssl/fullchain.pem
SSLCertificateKeyFile /etc/nginx/ssl/example.com.key
- reload 并做首轮验证。先测语法再 reload,不要 restart;随即用
curl -vI看握手结果。
nginx -t && systemctl reload nginx # Apache:apachectl configtest && systemctl reload httpd
curl -vI https://example.com
# 通过标准:出现 "SSL certificate verify ok." 且首行为 "HTTP/2 200"
六步走完后如果 curl 仍报 unable to get local issuer certificate 或 SSL_ERROR_NO_CYPHER_OVERLAP,问题基本落在 SNI 虚拟主机匹配或中间链缺失上,而不是证书本身签发失败——那属于下一节的排错清单。密钥类型与协议版本可对照 Mozilla SSL Configuration Generator 的 intermediate 配置档校核。
配置与命令示例:Nginx 1.26、Apache 2.4.58、OpenSSL 3.0 可直接复制
把证书装好后最常见的翻车点不是文件没放对,而是配置语法、协议版本或证书链没对上。下面这份片段可以直接复制,环境基线是 Nginx 1.26.0(2024-04 stable)、Apache httpd 2.4.58、OpenSSL 3.0.x,也都是多数发行版当前的默认或可选版本。这也是本 ssl证书 安装教程 troubleshooting 部分最值得先照着跑一遍的内容。
Nginx 1.26 的最小可用片段怎么写?
server {
listen 443 ssl; # 不要写 listen 443 ssl http2,1.25.1 起已弃用
http2 on; # 1.25.1 新增的独立指令
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 必须是「叶证书+中间证书」
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3; # 默认值仅 TLSv1.2 TLSv1.3
ssl_session_cache shared:SSL:10m; # 默认 none;10m 约缓存 4 万个会话
ssl_session_timeout 1d; # 默认 5m
add_header Strict-Transport-Security 'max-age=31536000' always;
}
注意 http2 on; 是 1.25.1 引入的新写法,旧的 listen ... http2 在该版本被标记 deprecated,混用会在 nginx -t 时给出 warning。证书文件缺失时的真实报错是 nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory),看到这句先查路径权限,别急着怀疑证书本身。
Apache 2.4.58 怎么写?
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 # 2.4.58 默认已排除这三项,显式写便于审计
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
改完必须执行 apachectl configtest,正常输出 Syntax OK;若证书路径写错,会得到 AH00526: Syntax error on line 6 of /etc/httpd/conf.d/ssl.conf: SSLCertificateFile: file '/etc/httpd/ssl/fullchain.pem' does not exist or is empty。注意 SSLCertificateFile 在 2.4.8 之后可直接指向 fullchain(不再需要 SSLCertificateChainFile,该指令已弃用),这一点与很多老教程冲突。
| 能力 | Nginx 1.26 | Apache 2.4.58 |
|---|---|---|
| 启用 TLS | listen 443 ssl; |
SSLEngine on |
| 证书链文件 | ssl_certificate |
SSLCertificateFile |
| 协议控制 | ssl_protocols |
SSLProtocol |
| HSTS | add_header ... always |
Header always set ... |
| 配置校验 | nginx -t |
apachectl configtest |
如何用 OpenSSL 3.0 确认握手真的成功?
openssl s_client -connect example.com:443
-servername example.com -showcerts -verify_return_error </dev/null
-servername 是 SNI 的关键:省略它,SNI 虚拟主机就会返回默认站点的证书,这是”证书明明装了却提示域名不匹配”的头号原因。输出里必须同时看到 Verify return code: 0 (ok)、Protocol : TLSv1.3、Cipher : TLS_AES_256_GCM_SHA384;若出现 verify error:num=21:unable to verify the first certificate,说明服务器没发中间证书,即 fullchain 不完整。
# 校验证书主体、签发者、有效期与 SAN(RFC 5280 要求 SAN 覆盖所有访问域名)
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
# RSA 证书:两行输出的 MD5 必须完全一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# ECDSA 证书改用公钥比对
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
校验证书时盯两个数:notAfter 距当前至少 30 天(否则续期流程已经坏了),SAN 列表里裸域和 www 都要在。据 Let’s Encrypt 文档,续期应”每天两次、带随机延迟”执行,避免整点集中冲击 ACME 端点;certbot 2.11 的验证方式如下:
certbot renew --dry-run --deploy-hook 'systemctl reload nginx'
systemctl list-timers | grep certbot # 确认 certbot.timer 存在且 NEXT 时间正常
以上片段覆盖了从配置、握手到续期的完整闭环,后续排错(443 端口连通性、SNI 分流、中间链缺失)都可以基于同一套命令逐层定位。
参数对比与方案选型:单域名、通配符、多域名 SAN、DV/OV 怎么选
443 端口连不上,十有八九不是端口没开,而是证书根本不含你访问的那个名字。做 ssl证书 安装教程 troubleshooting 时最容易搞反顺序:先查防火墙、再查 Nginx 配置,最后才看证书覆盖范围。先选对证书类型,能省掉一半排错时间。
| 类型 | 覆盖的主机名 | 国内常见价格 | 验证方式 / 签发时长 | 典型坑 |
|---|---|---|---|---|
| 单域名 DV | 仅 example.com 或 www.example.com 之一 |
0(Let’s Encrypt,90 天)~80 元/年 | HTTP-01 或 DNS-01,分钟级 | 另一个主机名必然报错,需另签或换 SAN |
| 通配符 DV | *.example.com(同级任意子域),不含 example.com |
300~800 元/年;Let’s Encrypt 免费 | 据 Let’s Encrypt 文档,通配符只支持 DNS-01 | 误以为 *.example.com 顺带覆盖裸域 |
| 多域名 SAN DV | 2~100 个 SAN,可跨主域 | 100~600 元/年 | 每个域名独立 DCV | 任一域名 DCV 失败,整张证书续期失败 |
| OV | 同上,含企业主体信息 | 800~3000 元/年 | 营业执照 + 电话核验,1~3 个工作日 | 公司更名须重签,不能沿用旧证书 |
| EV | 同上 | 2000~8000 元/年 | 更严格核验,3~7 个工作日 | 主流浏览器已取消绿色地址栏,仅为合规而买 |
价格为企业市场报价区间,随渠道浮动;Let’s Encrypt 的 90 天有效期是 CA/Browser Forum 有效期上限内的自我限制,续期靠 ACME 自动化而非人工。
通配符的边界必须记牢:*.example.com 匹配 a.example.com,不匹配 a.b.example.com,也不匹配裸域。这是 RFC 6125 的通配符匹配规则,现代浏览器与 curl 都只比对 SAN 扩展,Subject CN 已不作为匹配依据。装完先做两件事:
# 1) 看证书文件里到底签了哪些名字(SAN 才是匹配依据)
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -ext subjectAltName
# 2) 带 SNI 从线上 443 取回真正下发的证书,确认没装错文件
echo | openssl s_client -connect www.example.com:443 -servername www.example.com 2>/dev/null
| openssl x509 -noout -subject -dates -ext subjectAltName
# 输出示例:DNS:example.com, DNS:*.example.com
# 若访问 www 时输出里只有 example.com,curl 会直接报:
# curl: (60) SSL: no alternative certificate subject name matches target host name 'www.example.com'
# 浏览器对应 NET::ERR_CERT_COMMON_NAME_INVALID —— 这是选型问题,不是"证书没装好"
需要通配符时,Let’s Encrypt 的签发命令如下(certbot 3.x 适用):
# 通配符只能走 DNS-01;裸域要单独 -d 一次,否则 example.com 不被覆盖
certbot certonly --manual --preferred-challenges dns
-d '*.example.com' -d example.com --cert-name wildcard-example
# 注意:--manual 无法自动续期,生产环境请换 --dns-cloudflare 等插件
# 或配 --manual-auth-hook 调 DNS API,否则 90 天后必然过期告警
协议与密钥参数同样是选型的一部分:当前基线是 TLS 1.2/1.3,密钥 RSA 2048 位或 ECDSA P-256(后者握手更快、包更小,但老客户端如 Android 6 以下不认)。可直接以 Mozilla SSL Configuration Generator 的 intermediate 档作为起点:
# nginx 1.23.0+:该版本起 ssl_protocols 默认值已改为 TLSv1.2 TLSv1.3
# 1.23.0 之前的默认值是 TLSv1 TLSv1.1 TLSv1.2,必须显式覆盖
ssl_protocols TLSv1.2 TLSv1.3; # 显式禁用 TLS 1.0/1.1 与 3DES
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off; # 默认 off;对 TLS 1.3 不生效
ssl_session_cache shared:SSL:10m; # 默认 none,开启可减少握手开销
ssl_session_timeout 1d; # 默认 5m,Mozilla intermediate 建议 1d
ssl_dhparam /etc/nginx/dhparam.pem; # 使用 DHE 套件时必配,否则 2048 位以下报错
Apache 对应写法为 SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1,SSLCipherSuite 取同一份 Mozilla intermediate 串。选型阶段就把主机名清单、证书类型、密钥算法三件事定死,后面的 443 端口、SNI、中间链排错才有意义——绝大多数”握手失败”告警,在对比表第一列就能定位到根因。
常见错误与排查:curl、openssl、浏览器真实报错逐条处理
证书装完却报错,先别急着重装。下面这些报错几乎覆盖了 443、SNI 和中间链排错的 90% 场景,每条都给出可复现的命令序列和判断依据。这也是 SSL 证书安装教程 troubleshooting 中最常被搜索的部分。
1. curl: (60) SSL certificate problem: unable to get local issuer certificate
这条报错的意思是:客户端拿到的证书链无法锚定到受信任的根。绝大多数情况是服务器只下发了叶子证书,漏了中间 CA。先确认服务端实际返回几张证书:
# 只打印证书链,不校验;数一下 BEGIN CERTIFICATE 出现次数
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -c 'BEGIN CERTIFICATE'
# 期望值 >= 2(叶子 + 中间);等于 1 说明中间链缺失
Nginx 侧把 ssl_certificate 从 cert.pem 改为 fullchain.pem(Let’s Encrypt 的 fullchain.pem 默认就是叶子 + 中间的顺序,切勿倒置):
server {
listen 443 ssl;
server_name example.com;
# 必须是 fullchain,不能只用 cert.pem
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
}
据 Let’s Encrypt 文档,cert.pem 仅含服务端证书,chain.pem 仅含中间证书,二者拼接才是浏览器需要的完整链。
2. 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID
现代浏览器早已忽略 CN,只看 SAN。先核对证书里到底写了哪些域名:
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -ext subjectAltName
# 输出示例:DNS:example.com, DNS:www.example.com
# 缺失的域名就是报错根源
多站点共用同一 IP 时,还要确认 SNI 命中的是不是你预期的 vhost。用 --resolve 绕过 DNS,直接打到目标 IP:
curl -vI https://example.com --resolve example.com:443:1.2.3.4 2>&1 | grep -E 'subject:|issuer:|SSL certificate'
若返回的 subject 是别的站点,说明该 IP 上 443 的默认 server 抢先生效了——Nginx 中第一个 listen 443 ssl 即为默认 vhost。
3. SSL_ERROR_RX_RECORD_TOO_LONG
这是 Firefox 的经典报错,含义是:客户端发出 TLS ClientHello,服务端却回了一段明文 HTTP。验证方法:
curl -I http://example.com:443
# 若返回 400 Bad Request,说明 443 端口在跑明文 HTTP
常见原因有两个:Nginx listen 443 漏写 ssl 参数;或云负载均衡后端端口填成了 80。检查配置:
nginx -T 2>/dev/null | grep -n 'listen 443'
# 正确写法:listen 443 ssl;(Nginx 1.25+ 推荐 listen 443 ssl; http2 on;)
4. certificate has expired 但证书文件明明没过期
先看服务器时间,别急着续签:
date -u
timedatectl status # 关注 "System clock synchronized: yes"
chronyc tracking # 看 System time 偏移量
# 偏移超过 5 分钟即会误判过期
chronyc makestep # 立即强制校时
容器场景下要额外确认宿主机时间——容器默认继承宿主机的 clock,宿主偏移会原样带入。
5. nginx: [emerg] PEM_read_bio_X509_AUX(...) failed
启动即失败,通常是路径、权限或文件格式问题,逐项验证:
ls -l /etc/nginx/ssl/fullchain.pem # nginx 运行用户需可读
sudo -u nginx test -r /etc/nginx/ssl/fullchain.pem && echo OK
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout # 能解析才算格式正确
chmod 600 /etc/nginx/ssl/privkey.pem # 私钥建议 600
另一种高频原因是文件里混入了 Windows 换行(CRLF)或 BOM,用 file fullchain.pem 确认是 PEM 而非 ASCII text with CRLF。
6. Apache AH01909: RSA certificate configured for ... does not include an ID which matches the server name
vhost 的 ServerName 与证书 SAN 不匹配,或 443 的默认 vhost 抢先匹配。查看 vhost 加载顺序:
apachectl -S
# 输出中 "*:443 为 default server" 的那一项会接管所有 SNI 未命中请求
修法是把目标站点放进独立的 <VirtualHost *:443> 并确保 ServerName 出现在证书 SAN 列表里,同时避免在 ports.conf 中留下无 ServerName 的兜底 vhost。
| 报错 | 首要怀疑点 | 一条命令定位 |
|---|---|---|
| curl (60) unable to get local issuer | 中间链缺失 | openssl s_client -showcerts 数证书张数 |
| ERR_CERT_COMMON_NAME_INVALID | SAN 漏域名 / SNI 命中错 vhost | openssl x509 -ext subjectAltName |
| SSL_ERROR_RX_RECORD_TOO_LONG | 443 回了明文 | curl -I http://host:443 |
| certificate has expired | 系统时钟偏移 | chronyc tracking |
| PEM_read_bio_X509_AUX failed | 路径/权限/CRLF | openssl x509 -noout |
| AH01909 | ServerName 与 SAN 不符 | apachectl -S |
排查顺序建议固定为:先 openssl s_client -showcerts 看服务端实际下发了什么,再 curl --resolve 确认 SNI 命中,最后才动配置文件。据 OpenSSL 官方文档,s_client 的 -servername 参数正是为 SNI 场景设计的,省略它会拿到默认 vhost 的证书,从而得出错误结论。
效果验证方法:如何确认配置真的生效而不是“看起来生效
为什么浏览器地址栏已经出现小锁,仍然可能是“看起来生效”?因为浏览器会缓存证书、复用 TLS 会话(session resumption),CDN 边缘节点也可能还在下发旧证书;而 openssl s_client 与 curl 每次都发起全新握手,拿到的是真实链路。这里有个容易踩的坑:据 OpenSSL 官方文档,s_client 默认不会因证书校验失败而返回非 0 退出码,脚本里不加 -verify_return_error,echo $? 永远是 0。这也是很多 ssl 证书 安装教程 troubleshooting 里“脚本说成功、用户说打不开”的根因。
# 1) 本机 TLS 握手:必须同时满足「退出码 0」和「Verify return code: 0 (ok)」
openssl s_client -connect example.com:443 -servername example.com
-verify_return_error </dev/null
echo "exit=$?" # 期望 0;-servername 即 SNI,漏掉它会拿到默认站点的证书
# 2) 失败时逐层定位:看握手卡在 TCP、TLS 还是证书校验
openssl s_client -connect example.com:443 -servername example.com -state &1 | tail -40
# 输出停在 CONNECTED 多半是防火墙/安全组;停在 SSL_connect 是协议或套件不匹配
# 3) HTTP 层:用 --resolve 强制解析到指定 IP,绕过本地 DNS 与 hosts 干扰
curl -vI https://example.com --resolve example.com:443:1.2.3.4 2>&1
| grep -E 'SSL certificate verify|^HTTP'
# 期望同时出现 SSL certificate verify ok 与 HTTP/2 200(或 HTTP/1.1 200)
# 4) 明文入口必须跳转,否则 HSTS 会把你锁在门外
curl -sI http://example.com | head -3 # 期望 301/308 + Location: https://...
# 5) 证书链:确认签发者、主体与有效期,排除自签证书和过期证书
openssl s_client -showcerts -connect example.com:443 -servername example.com </dev/null
| openssl x509 -noout -issuer -subject -dates
# 6) 用系统信任库校验整条链,必须输出 OK
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
# fullchain.pem: OK 才算完整;error 20 = 缺中间证书,error 10 = 根证书过期
据 Let’s Encrypt 文档,最常见的链问题就是只部署了 cert.pem 而漏掉中间证书,服务端应返回 fullchain.pem。端口侧再确认一次:
# 7) 监听与防火墙(Ubuntu 用 ufw,RHEL 系用 firewall-cmd)
ss -lntp | grep ':443' # 需看到 nginx/httpd,且 0.0.0.0:443 与 [::]:443 同时存在
sudo ufw status | grep 443 # 或:firewall-cmd --list-ports | grep 443/tcp
# 云安全组入方向要同时放行 0.0.0.0/0 与 ::/0 的 TCP 443,IPv6 规则最常被漏掉
| 验证层 | 关键命令 | 通过标准 | 典型失败信号 |
|---|---|---|---|
| L4 端口 | ss -lntp | grep ':443' |
有进程处于 LISTEN | Connection refused / 超时 |
| TLS 握手 | openssl s_client -verify_return_error |
exit 0 + Verify return code: 0 (ok) |
error:num=20 unable to get local issuer certificate |
| 证书链 | openssl verify -CAfile ... fullchain.pem |
fullchain.pem: OK |
error 20(缺中间证书)、error 10(根证书过期) |
| HTTP 语义 | curl -vI --resolve |
verify ok + 200,且 http 返回 301/308 | 重定向循环、502 |
浏览器侧打开 DevTools → Security 面板,应显示 TLS 1.3(RFC 8446)、证书有效、无混合内容;若控制台报 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure image 'http://...',把 http:// 资源改成 https:// 或相对路径,再考虑提交 HSTS 预加载。外部工具方面,据 Qualys SSL Labs 评级说明,拿到 A/A+ 即达标,不必追求满分;testssl.sh 3.2 可离线复核:
# 8) 重点看 Certificate Validity、Chain of Trust、Protocols 三项
./testssl.sh --severity HIGH https://example.com
续期与自动化排错:certbot 2.11 的 dry-run、webroot、DNS-01 场景
certbot 2.11(2024 年 10 月发布)默认通过 certbot.timer 每天触发两次 certbot renew,续期窗口是证书到期前 30 天。这意味着:dry-run 必须在进入这个窗口之前跑通,否则一旦失败,你只剩不到 30 天来排查,而 Let’s Encrypt 对同一组域名有“每周 5 次失败验证”的速率限制(据 Let’s Encrypt 官方 Rate Limits 文档)。所以正确顺序是:部署后立即 dry-run 一次,之后每次改动 Nginx 配置或防火墙都重跑一次。
# 干跑续期:不写磁盘、不消耗生产配额(走 staging 环境)
sudo certbot renew --dry-run
# 失败先看日志,最后 50 行通常就有根因
sudo tail -n 50 /var/log/letsencrypt/letsencrypt.log
# 只想干跑某一个 lineage,避免全量扫描耗时
sudo certbot renew --cert-name example.com --dry-run
日志里最常见的三类报错,对应三种完全不同的修法:
Problem binding to port 80: Could not bind to IPv4 or IPv6.—— 80 端口被 nginx/apache 或容器占用,certbot 的 standalone 插件抢不到端口。Detail: Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404—— webroot 路径写错,或请求被 302 重定向到 HTTPS 登录页。DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com—— TXT 记录没生效或写错了主机名。
HTTP-01 验证前先自己模拟一遍,不要等 certbot 报错:
# 手工放一个测试文件,确认外部能取到纯文本 200,而不是 301/302
echo "ok" | sudo tee /var/www/html/.well-known/acme-challenge/test
curl -i http://example.com/.well-known/acme-challenge/test
# 期望:HTTP/1.1 200 + Content-Type: text/plain;若出现 301 或 302 到 https,说明被 rewrite 拦截
Nginx 需要在 server 块里显式“短路”ACME 路径。用 ^~ 前缀匹配可以让它优先于正则 rewrite,这是关键:
server {
listen 80;
server_name example.com;
# ^~ 保证该前缀优先于后续正则 location,避免被强制跳转 HTTPS 吃掉
location ^~ /.well-known/acme-challenge/ {
root /var/www/html; # 必须与 certbot -w 的 webroot 完全一致
default_type text/plain;
try_files $uri =404;
}
location / { return 301 https://$host$request_uri; }
}
# 目录权限:chmod 755 /var/www/html/.well-known/acme-challenge
# 续期命令:certbot renew --webroot -w /var/www/html
DNS-01 通配符场景的核心不是命令,而是 DNS 传播等待。TXT 记录 TTL 设 60 秒,但公共递归 DNS 缓存通常仍需 60–300 秒才刷新(取决于上游 resolver 的负缓存策略)。签发前务必自检:
dig +short TXT _acme-challenge.example.com @8.8.8.8
# 无输出 = 未生效,此时执行 certbot 必然 NXDOMAIN
sudo certbot certonly --manual --preferred-challenges dns
-d '*.example.com' -d example.com
--deploy-hook 'systemctl reload nginx'
注意 --manual 插件不支持自动续期(需要人工粘贴 TXT 值),生产环境应换成 DNS 厂商的 certbot 插件(如 certbot-dns-cloudflare),把凭据放 /etc/letsencrypt/cloudflare.ini 并 chmod 600。
| 维度 | HTTP-01 | DNS-01 |
|---|---|---|
| 支持通配符 | 不支持 | 支持 *.example.com |
| 依赖端口 | 必须公网可达 80 | 无需开放任何入站端口 |
| 典型失败耗时 | 秒级(404/302 立现) | 分钟级(等 DNS 传播) |
| 能否自动化续期 | webroot 可全自动 | 需 DNS API 插件才可全自动 |
| 适合场景 | 单域名、内网无 DNS API | 通配符、80 端口被封、CDN 后端 |
钩子选型:--deploy-hook 'systemctl reload nginx' 只在成功续期后执行,reload 是平滑的、不断连接,这是默认首选。--pre-hook 会在每次 renew 尝试前无条件执行,如果你在里面写 systemctl stop nginx,那么一次失败的重试就会造成额外的停机窗口。只有当 80 端口被 standalone 插件独占、必须停服务时,才用 pre-hook/post-hook 组合,并把停机控制在 60 秒内(HTTP-01 验证本身超时较短)。
# 查看 timer 下次触发时间,确认自动化真的在跑
systemctl list-timers | grep certbot
# 直接读证书到期时间,接入监控告警(21/14/7 天三档)
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -enddate
# notAfter=Jan 12 03:14:07 2026 GMT
容器化部署最容易踩的坑:/etc/letsencrypt 和 /var/lib/letsencrypt 必须挂到持久卷,否则容器重建后证书与账户密钥全部丢失,续期直接报 Account not found。把上面这些检查串起来,才算真正跑通了一次完整的 ssl证书 安装教程 troubleshooting 闭环——安装只是起点,续期自动化才是长期可用的分水岭。
上线与回滚清单:变更前 10 分钟、变更后 10 分钟做什么
问:换证书不就是改一行 ssl_certificate 吗,为什么还要留 10 分钟观察窗?因为 443 上跑的是全站流量,证书、私钥、中间链三者任一不匹配,nginx 要么拒绝 reload,要么在 TLS 握手阶段给用户返回 SSL_ERROR_BAD_CERT_ALERT。这份 ssl证书 安装教程 troubleshooting 清单把变更切成“前 10 分钟 / 后 10 分钟”两段,每一步都落到可复制的命令上。
变更前 10 分钟:备份、记指纹、先自测
顺序不能反——先备份再动配置;指纹则是回滚之后唯一能证明“确实切回去了”的证据,别靠肉眼比对文件大小。
# 1) 备份整份配置目录(-a 保留权限/软链,回滚时可直接 diff)
cp -a /etc/nginx /etc/nginx.bak.$(date +%F-%H%M)
# 2) 记录当前在用证书的 SHA-256 指纹,回滚后用它核对
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -fingerprint -sha256
# 输出示例:SHA256 Fingerprint=3A:1F:...:9C:2D
# 3) 语法自检,必须先通过再谈 reload(nginx 1.0+ 通用)
nginx -t
# nginx: configuration file /etc/nginx/nginx.conf test is successful
# 4) 绕过 DNS 直连源站验证:--resolve 强制解析到源站 IP,SNI 照常发送
curl --resolve example.com:443:1.2.3.4 -I https://example.com
# HTTP/2 200
第 4 步是这套 ssl证书 安装教程 troubleshooting 里最容易省掉、也最该做的一步:DNS 还没切换时就能验证证书是否匹配域名、中间链是否完整,而不是等真实用户报错。
变更时:reload,不要 restart
据 nginx 官方文档(“Controlling nginx”),reload 会启动新 worker、优雅关闭旧 worker,存量 TLS 连接不中断;restart 则会让 443 直接断流。systemd 下 systemctl reload nginx 走的是单元文件里默认的 ExecReload=/bin/kill -s HUP $MAINPID。若 reload 被拒,nginx -t 的报错带配置行号,例如证书与私钥不配对时:
nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/privkey.pem") failed
(SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
变更后 10 分钟:盯错误日志和 5xx
# 只看与证书/握手相关的行,避免被 404 噪声淹没
tail -f /var/log/nginx/error.log | grep -i -E 'ssl|certificate'
# 另一路:systemd 侧的启动/重载失败信息
journalctl -u nginx --since '10 min ago'
判断标准要提前定死:5xx 比例超过 1% 立即回滚,不要在现场“再看一会儿”。
回滚:软链切回旧证书,旧文件留 7 天
ln -sfn /etc/nginx/ssl/old-fullchain.pem /etc/nginx/ssl/fullchain.pem
ln -sfn /etc/nginx/ssl/old-privkey.pem /etc/nginx/ssl/privkey.pem # 证书与私钥必须成对切
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -fingerprint -sha256 # 比对变更前记录
nginx -t && systemctl reload nginx
| 操作 | 存量连接 | 配置有错时 | 典型用途 |
|---|---|---|---|
systemctl reload nginx |
旧 worker 优雅退出,连接不断 | 不生效,旧进程继续用旧配置 | 证书轮换、上游地址变更 |
systemctl restart nginx |
全部断开,TLS 重新握手 | 服务直接起不来,443 全站不可用 | 增删模块、改 worker_processes |
旧 fullchain 与 privkey 至少保留 7 天再清理:据 Let’s Encrypt 文档,部分客户端(Android 7 及更早、Java 8 自带 truststore)对中间链的缓存可能滞后数天才暴露问题,届时你还需要能一键切回。
先执行 `openssl s_client -connect 域名:443 -servername 域名 -showcerts -verify_return_error
填 `fullchain.pem`。`cert.pem` 只有站点证书,缺中间 CA 时 curl 常报 `unable to get local issuer certificate`;fullchain 的顺序是站点证书在前、中间 CA 在后,不要拼根证书。
个人站、测试环境优先 Let's Encrypt ACME v2,90 天有效、自动续期成本低;需要通配符但不想维护 DNS 插件,或需要发票、合同、更高支持时选商业 DV,单域名常见 0-80 元/年、通配符常见 300-800 元/年。两者在浏览器加密强度上无本质差异,差别在有效期、支持与责任条款。
优先补中间链,把 `ssl_certificate` 指向 `fullchain.pem`;临时排查可用 `curl –cacert fullchain.pem` 验证,但生产不要用 `-k`。再用 `openssl s_client -showcerts` 确认服务端确实发送了中间 CA。
常见是 SNI 未命中或默认 443 vhost 抢占;Nginx 用 `server_name` 匹配,测试时用 `openssl s_client -servername` 指定域名。检查 `listen 443 ssl default_server` 是否落在错误站点,Apache 用 `apachectl -S` 看 vhost 顺序。
续期只更新文件,未 reload 不会生效;给 certbot 加 `–deploy-hook 'systemctl reload nginx'`,并检查软链是否指向新目录。用 `openssl x509 -noout -dates` 对比文件与线上 `openssl s_client` 返回的 notAfter。
TLS 1.3 本身不要求 OCSP Stapling,且 Let's Encrypt 已推进 CRL 与短周期证书,商业证书按 CA 文档决定;Nginx 可配 `ssl_stapling on; ssl_stapling_verify on; ssl_trusted_certificate fullchain.pem;`,用 `openssl s_client -status` 看是否返回 `OCSP Response Status: successful`。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。