SSL 证书安装教程最佳实践:从文件校验到灰度发布的 6 步验收流程
SSL 证书安装最佳实践的核心不是把 PEM 拖进目录,而是完成“域名匹配、链完整、私钥匹配、部署生效、外部验收”五个检查点;用 openssl verify 返回 OK、curl 返回 HTTP/2 200 且证书剩余有效期大于 30 天作为上线门槛。 据 Let's Encrypt 文档,ACME 证书有效期 90 天,建议在剩余 30 天前续期;用 `openssl x509 -checkend 2592000 -noout` 可在到期前 30 天返回非 0。 多环境安装先统一产物:Nginx/Caddy/HAProxy 用 fullchain.pem + privkey.pem,IIS 用 .pfx,Kubernetes 用 TLS Secret;私钥权限设为 600,证书文件 644。 上线前用 `openssl s_client -connect example.com:443 -servername example.com -showcerts` 与 `curl -vI --resolve` 分别验证外部链和指定节点,避免 DNS 未切换时误判。 DV 证书常见价格 0-300 元/年,OV 约 800-3000 元/年,EV 约 2000-8000 元/年;手动安装通常 5-30 分钟,ACME 自动化 1-5 分钟,证书管理平台按域名数量计费。
为什么证书已经上传,浏览器仍提示“不安全”?
因为”上传”只是把文件放到了磁盘上,浏览器校验的却是握手时服务端真正发出的那条证书链。这中间隔着一整条链路:文件是否拼对 → Web 服务器是否加载 → 是否 reload → CDN/负载均衡是否同步 → 客户端是否信任。任何一环没闭环,本地 ls 看到新文件、外部却依旧报错。Chrome 的两个高频错误正好指向两类根因:NET::ERR_CERT_COMMON_NAME_INVALID 说明证书里没有当前域名(SAN 未覆盖或压根没带 SNI),NET::ERR_CERT_AUTHORITY_INVALID 说明客户端拼不出到受信根的完整链。
根因一:只部署了 leaf 证书,没带中间证书。据 RFC 5280 第 7.4.2 节,服务器应发送”终端证书 + 中间证书”,根证书由客户端内置信任库提供,服务器不应发送根证书。只配置 cert.pem 时,Chrome 会走 AIA 扩展去补链,所以”我这边能打开”;但 curl(OpenSSL 默认不开 AIA 抓取)、Java 8 默认信任库、Android 7 以下往往直接失败。Nginx 的正确写法是 ssl_certificate 指向 fullchain.pem(leaf 在前、中间证书在后),而非 cert.pem;Let’s Encrypt 文档明确说明 fullchain.pem 即为此用途。
根因二:SNI 未命中,拿到了默认站点的证书。同一 IP 绑定多张证书时,客户端不带 SNI 扩展(老设备、老 JDK、openssl s_client 忘加参数)就会落到第一个 server 块。用 -servername 对比即可复现差异。
根因三:私钥与证书不匹配。文件替换时把测试证书和线上私钥混用,配置检查阶段不报错,reload 时才炸:SSL_CTX_use_PrivateKey: key values mismatch(Nginx 表现为 nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed)。上线前比两者公钥 SHA256 是最廉价的预防。
# 1) 看服务端真实发出的证书链(带 SNI,取第一张 leaf)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 2) 校验链完整性:chain.pem 为中间证书,根用系统库
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem
# 期望输出:cert.pem: OK
# 3) 证书与私钥是否配对(两条 SHA256 必须完全一致)
openssl x509 -in cert.pem -noout -pubkey | openssl pkey -pubin -outform DER | openssl dgst -sha256
openssl pkey -in privkey.pem -pubout -outform DER | openssl dgst -sha256
# 4) 绕过 DNS/CDN 直连源站验证,排除"缓存旧证书"
curl -vI https://example.com --resolve example.com:443:203.0.113.10
| 现象 / 报错 | 根因 | 验证命令 | 修复动作 |
|---|---|---|---|
ERR_CERT_COMMON_NAME_INVALID |
SAN 未含该域名;SNI 未命中拿到默认证书 | openssl s_client -servername … -showcerts |
重签含 SAN 的证书;确认 server_name 与 SNI 配置 |
ERR_CERT_AUTHORITY_INVALID |
缺中间证书或根不受信(自签/私有 CA) | openssl verify -untrusted chain.pem |
改指 fullchain.pem;客户端导入根 |
reload 报 key values mismatch |
私钥与证书非同一对 | 公钥 SHA256 比对 | 换回匹配私钥,重跑 nginx -t |
| 本地新、外部旧 | 未 reload / CDN 未刷新 / 剩余有效期 <30 天触发告警 | curl --resolve 直连源站 |
systemctl reload nginx、刷新 CDN,回滚命令写进变更单 |
这正是 ssl 证书 安装教程最佳实践里最容易被跳过的一步:验收不看”文件对不对”,只看”握手发出去的是什么”。把上面 4 条命令固化成上线前的检查清单,比事后在浏览器里刷 F5 有效得多;后续的灰度发布与到期监控,也应当基于同一组探测点(源站 + CDN + 至少一个不支持 AIA 的客户端)来设计。
安装前必须校验哪些文件?用 openssl 怎么一条条查?
很多人把 ssl证书 安装教程最佳实践 理解成”改 nginx.conf 那五行”,但线上大部分握手失败其实发生在改配置之前——证书包拿错了、链里缺中间证书、私钥跟证书对不上。据 Let’s Encrypt 文档,其证书有效期固定 90 天且不提供宽限期;Mozilla 服务器侧 TLS 指南也明确要求 ssl_certificate 指向包含中间证书的 fullchain。所以别急着 reload,先花 60 秒把下面 6 条命令跑完。
-
域名与 SAN:这张证书到底签给了谁
# 只输出 SAN 扩展,避免整段 -text 刷屏 openssl x509 -in cert.pem -noout -text | grep -A1 'Subject Alternative Name' # 期望: # X509v3 Subject Alternative Name: # DNS:example.com, DNS:www.example.com # 注意:通配符 *.example.com 只覆盖一级域名, # a.b.example.com 不会被匹配,必须单独出现在 SAN 列表里 -
有效期:notAfter 要进监控而不是进备忘录
openssl x509 -in cert.pem -noout -dates # notBefore=Jul 1 00:00:00 2025 GMT # notAfter=Sep 29 23:59:59 2025 GMT ← Let's Encrypt 固定 90 天 # 商业 DV 常见 1 年;据 CA/Browser Forum 基线要求,公开信任证书最长 398 天把
notAfter写进监控:剩余少于 30 天即进入续期队列,少于 7 天告警升级。别用”记得续”这种人工流程。 -
链完整性:缺中间证书是最常见的线上事故
# 1) 看 fullchain.pem 里究竟装了几张证书 openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout # 期望:1 张 leaf(subject=CN=example.com)+ 1~2 张 intermediate # 2) 用系统根证书库做真实路径验证 openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem # 期望输出:cert.pem: OK # 常见报错: # error 20 at 0 depth lookup: unable to get local issuer certificate → 缺中间证书 # error 21 at 0 depth lookup: unable to verify the first certificate → 同上,且服务端没配 fullchain -
私钥匹配:对不上就别改配置,直接回退证书包
# 分别导出公钥再算 SHA-256 指纹,两行必须完全一致 openssl x509 -in cert.pem -noout -pubkey | openssl sha256 openssl pkey -in privkey.pem -pubout | openssl sha256 # 不一致时 Nginx 启动会直接报: # SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:key values mismatch) -
算法与密钥长度:确认没签出 1024 位的老古董
openssl x509 -in cert.pem -noout -text | grep 'Signature Algorithm' | head -1 # 常见:sha256WithRSAEncryption / ecdsa-with-SHA256 openssl version # OpenSSL 3.0.13 实测通过;1.1.1 分支同样适用(pkey 子命令自 1.0.0 起可用)算法 推荐长度/曲线 握手体积 取舍 RSA 2048 位(下限)/ 3072 位 较大 兼容 Android 4.x、旧 Java 客户端 ECDSA P-256 约为 RSA 的 1/3 握手更快;老客户端需与 RSA 证书并行部署 -
权限与命名:回滚时间要压在 5 分钟内
chmod 644 fullchain.pem cert.pem chain.pem chmod 600 privkey.pem chown root:root privkey.pem # 或改为 nginx 运行账号 ls -l /etc/nginx/ssl/ # 备份命名:20250601-example.com-fullchain.pem # 至少保留当前版 + 上一版,回滚只需改一行 ssl_certificate 再 reload
| 文件 | 权限 | 属主 | 在 Nginx 中的角色 |
|---|---|---|---|
| fullchain.pem | 644 | root | ssl_certificate(leaf + 中间证书) |
| chain.pem | 644 | root | 校验与 OCSP stapling 用 |
| privkey.pem | 600 | root 或服务账号 | ssl_certificate_key |
把上面六条串成一个门禁脚本:任一命令返回非 0 或指纹不一致就以非 0 退出,阻断后续的灰度发布步骤——这正是 ssl证书 安装教程最佳实践 里最容易被跳过、却最省钱的一环。OpenSSL 官方文档对 verify 的 -untrusted 参数有明确说明:它只提供中间证书,根证书必须来自 -CAfile,两者搞反就会一直报 error 20。
完整实操:SSL 证书安装的 6 步流水线怎么走?
能跑通的命令不少,能验收的流程很少。下面这条 6 步流水线就是把“ssl证书安装教程最佳实践”从一句口号变成可复核的检查点:每一步都有命令、有预期输出、有失败时的停手条件。
第 1 步:盘点入口,别急着拷文件。证书装错位置,90% 是因为漏掉了某一层入口——CDN 回源、云 LB、Ingress Controller、IIS 站点绑定各有一份证书。
# 1) 找出本机真正加载 443 的进程(RHEL/CentOS 8+、Ubuntu 均自带 ss)
ss -lntp '( sport = :443 )'
# 输出示例:LISTEN 0 511 0.0.0.0:443 0.0.0.0:* users:(("nginx",pid=1841,fd=6))
# 2) 判断流量是否先经过 CDN/代理:看 CNAME 与响应头
dig +short example.com # 出现 xxx.cdn.net 说明前面还有一层
curl -I https://example.com # 关注 Server / Via / X-Cache 头
# 3) 记录所有需要换证书的节点 + SNI 域名清单,写入变更单
第 2 步:统一产物。据 Let’s Encrypt 官方文档,ACME 签发的证书链必须按“站点证书 → 中间证书”顺序拼接,fullchain.pem 正是这个顺序;顺序错了在部分客户端(尤其 Android 与老版 Java)会直接握手失败。
# ACME(certbot) 产物路径固定,直接取用
ls -l /etc/letsencrypt/live/example.com/{fullchain.pem,privkey.pem,chain.pem}
# 登记指纹与有效期,避免多个团队拿到不同版本
openssl x509 -in fullchain.pem -noout -fingerprint -sha256 -dates
# IIS 需要 PFX(含私钥),务必设置导出密码
openssl pkcs12 -export -out example.pfx -inkey privkey.pem
-in fullchain.pem -certfile chain.pem
第 3 步:本地预检,四项任一失败即停止分发。“先上线再修链”在证书场景里几乎必翻车,因为浏览器不会给你第二次机会。
openssl x509 -in fullchain.pem -noout -ext subjectAltName # ① SAN 是否覆盖全部域名
openssl x509 -in fullchain.pem -noout -dates # ② 有效期
openssl verify -CAfile chain.pem -untrusted chain.pem fullchain.pem # ③ 链完整性
diff <(openssl pkey -in privkey.pem -pubout | sha256sum)
<(openssl x509 -in fullchain.pem -noout -pubkey | sha256sum) # ④ 私钥匹配
第 4 步:分发到目标。权限按 Mozilla Server Side TLS 建议:私钥 0600、证书链 0644,属主 root。
- name: 分发证书(Ansible)
copy:
src: "{{ item.src }}"
dest: "{{ item.dest }}"
owner: root
mode: "{{ item.mode }}" # privkey.pem=0600, fullchain.pem=0644
# Kubernetes:幂等写入 Secret
kubectl create secret tls example-com-tls --cert=fullchain.pem --key=privkey.pem
--dry-run=client -o yaml | kubectl apply -f -
# 分发后回读比对 SHA256 指纹
kubectl get secret example-com-tls -o jsonpath='{.data.tls.crt}'
| base64 -d | openssl x509 -noout -fingerprint -sha256
| 分发目标 | 核心命令 | 生效方式 | 回滚方式 |
|---|---|---|---|
| Linux + Ansible | copy + mode |
systemctl reload haproxy / caddy reload |
软链接指回旧目录后重载 |
| Kubernetes | kubectl create secret tls |
kubectl rollout restart deploy/web |
重新 apply 旧 Secret 并重启 |
| 云负载均衡 | ACM / 证书服务导入 | 控制台或 API 切换证书 ID | 切回上一证书 ID(秒级) |
| Windows IIS | Import-PfxCertificate |
站点绑定切换 SNI 证书 | 绑定回旧证书指纹 |
第 5 步:灰度与重载。先打单台,绕过 DNS 直接验证 SNI 命中:
curl -vI https://example.com --resolve example.com:443:203.0.113.10 2>&1
| grep -E 'subject|issuer|expire'
# 确认 issuer 已变为新 CA,再执行重载;旧证书至少保留 24 小时
第 6 步:外部验收与回滚。据 testssl.sh 官方说明,--fast 会跳过耗时的协议枚举,只做证书、链、SNI 等关键检查,适合放进 CI:
testssl.sh --fast --sni example.com https://example.com
# 失败时:恢复上一版软链接 / Secret,再执行第 5 步的重载命令,目标回滚 5-15 分钟
常见真实报错 unable to get local issuer certificate 几乎都指向第 3 步的链检查被跳过;而 SSL_ERROR_NO_CYPHER_OVERLAP 则是 SNI 域名清单漏项。把这两条写进验收单,比事后排查便宜得多。
不同环境怎么落地?Caddy、Kubernetes、IIS 与云负载均衡的命令示例
把 PEM 文件校验完、链补全、私钥权限收紧之后,真正的分歧点在于证书怎么注入运行时、改动怎么生效、续期由谁负责。这也是 ssl 证书 安装教程最佳实践里最容易被一笔带过的一步——同一份 fullchain.pem,在 Caddy 里靠 admin API 热加载,在 IIS 里必须写进证书存储并绑定 SNI,在 HAProxy 里则要求把 leaf、私钥、中间链拼成单个文件。下面按环境给出可直接复制的命令。
问:Caddy 既然自动签证书,什么时候还需要手动指定文件?
内网 CA、证书由公司 PKI 统一签发、或必须固定使用某张已采购的 OV/EV 证书时,用 tls 指令覆盖自动 HTTPS。据 Caddy 官方文档,Caddy 2.7.6 的 Caddyfile 写法与校验、热加载命令如下(caddy reload 走 admin API,默认监听 localhost:2019,零连接中断):
# /etc/caddy/Caddyfile
example.com {
tls /etc/caddy/fullchain.pem /etc/caddy/privkey.pem
# 手动证书模式下 Caddy 不再自动续期,续期需外部任务完成后再 reload
encode zstd gzip
reverse_proxy 127.0.0.1:8080
}
# 先静态校验,再热加载(两条都要执行,validate 不通过不要 reload)
caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
caddy reload --config /etc/caddy/Caddyfile --adapter caddyfile
问:Kubernetes 里怎么让证书自动续期又不断流?
cert-manager 1.14.4 的做法是声明 Certificate 资源,由控制器写入 Secret,Ingress 只引用 Secret 名称。据 cert-manager 官方文档,renewBefore 未显式设置时由控制器按证书有效期推算(90 天证书通常落在到期前 30 天左右续期),显式写 720h 可以把这个窗口钉死:
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
name: example-tls
namespace: prod
spec:
secretName: example-tls # Ingress 的 tls.secretName 必须与此一致
dnsNames:
- example.com
- www.example.com
issuerRef:
name: letsencrypt-prod
kind: ClusterIssuer
renewBefore: 720h # 到期前 30 天开始续期
# 验收:READY 必须为 True,False 时看 REASON 与 kubectl describe certificate
kubectl get certificate -n prod
# NAME READY SECRET AGE
# example-tls True example-tls 6d
常见报错
Reason: DoesNotExist表示引用的 Issuer/ClusterIssuer 不存在;Reason: IncorrectIssuer则是 Secret 被另一个 Certificate 占用。Secret 更新后 Ingress Controller 会自动重载,无需重启 Pod。
问:Windows Server 2019 的 IIS 10 怎么绑定才支持 SNI?
IIS 的坑在于证书进存储 ≠ 完成绑定,且 SslFlags 1 才代表启用 SNI(0 为 IP 绑定,多站点共用 443 时必须为 1)。以管理员身份运行 PowerShell:
# 1) 导入 PFX 到本机个人存储(密码交互输入,避免明文留在历史记录)
Import-PfxCertificate -FilePath ./site.pfx `
-CertStoreLocation 'Cert:LocalMachineMy' `
-Password (Read-Host -AsSecureString)
# 2) 新建 443 绑定并启用 SNI
New-WebBinding -Name 'Default Web Site' -Protocol https -Port 443 `
-HostHeader 'example.com' -SslFlags 1
# 3) 核对实际绑定的指纹与证书是否一致(Microsoft Learn 推荐的排查方式)
netsh http show sslcert hostnameport=example.com:443
问:HAProxy 为什么总报加载私钥失败?
HAProxy 2.8.5 要求 crt 指向的文件内同时含 leaf 证书、私钥、中间链,顺序为 leaf → 私钥 → 链。据 HAProxy 配置手册,私钥必须紧跟在对应证书之后,否则报 unable to load SSL private key from PEM file:
cat cert.pem privkey.pem chain.pem > /etc/haproxy/certs/example.com.pem
chmod 600 /etc/haproxy/certs/example.com.pem
# haproxy.cfg 片段
# bind :443 ssl crt /etc/haproxy/certs/example.com.pem alpn h2,http/1.1
haproxy -c -f /etc/haproxy/haproxy.cfg # 配置与证书语法校验
systemctl reload haproxy # reload 而非 restart,老连接平滑退出
问:证书交给云负载均衡托管要注意什么?
以 AWS ACM 为例,导入的证书不会自动续期(据 AWS ACM 文档,第三方证书需在到期前重新 import),到期前必须重复同一命令并用新 ARN 重新绑定 listener:
aws acm import-certificate
--certificate fileb://cert.pem
--private-key fileb://privkey.pem
--certificate-chain fileb://chain.pem
--region ap-east-1
# 返回 {"CertificateArn": "arn:aws:acm:ap-east-1:...:certificate/xxxx"}
aws acm describe-certificate --certificate-arn <ARN> --region ap-east-1
# 检查 Status=ISSUED、NotAfter、以及 DomainName/SAN 是否覆盖 www 子域
# 绑定到 ALB 443 listener(需提供 listener ARN)
aws elbv2 modify-listener --listener-arn <LISTENER_ARN>
--certificates CertificateArn=<ARN> --region ap-east-1
换证书时别忘了 CDN 回源链路:CloudFront 到 ALB 之间若走 HTTPS,回源证书也要同步替换,否则会出现 502 与 SSL handshake failed。这也是 6 步验收流程中”灰度发布”环节最容易漏掉的一环——先切 1% 流量验证 TLS 握手,再全量。
| 环境 | 证书注入方式 | 生效方式 | 默认自动续期 | 关键校验命令 |
|---|---|---|---|---|
| Caddy 2.7.6 | Caddyfile tls 指令指定文件 |
admin API 热加载 | 自动 HTTPS 模式有;手动文件模式无 | caddy validate |
| cert-manager 1.14.4 | Certificate → Secret | Ingress Controller 监听 Secret 变更 | 有,renewBefore 默认按有效期推算 |
kubectl get certificate |
| IIS 10 | PFX 导入本机 My 存储 | 绑定生效,改证书需重绑 | 无,需计划任务或 ACME 客户端 | netsh http show sslcert |
| HAProxy 2.8.5 | leaf+key+chain 合并单文件 | reload 平滑生效 |
无,依赖外部 ACME | haproxy -c -f |
| AWS ACM | import-certificate 得 ARN |
修改 listener 指向新 ARN | 导入证书无(公有证书有) | describe-certificate |
无论落在哪个环境,验收口径应一致:SNI 是否按 RFC 6066 正确返回对应证书、链是否完整到根、SAN 是否覆盖所有域名、私钥权限是否 ≤600、以及续期失败时是否有告警。把这几项固化成脚本,ssl 证书 安装教程最佳实践才算真正可复现。
手动安装、ACME 自动化、证书平台和 CDN 托管怎么选?
拿到 fullchain.pem 只是开始,真正决定后期维护成本的是”证书怎么落地、由谁续期、私钥放在哪”。这也是 ssl证书 安装教程最佳实践里最容易被跳过的一步:多数事故不是签发失败,而是续期脚本失效、私钥权限过宽、或 CDN 回源证书悄悄过期。先看五种主流路径的硬指标对比。
| 方案 | 典型产物/格式 | 关键参数或版本 | 生效时间 | 价格区间 | 适合场景 |
|---|---|---|---|---|---|
| 手动文件安装 | fullchain.pem + privkey.pem | OpenSSL 3.0.13;私钥 chmod 600 | 5–30 分钟 | DV 0–300 元/年 | 单机、固定域名、内网 CA |
| ACME 自动化 | cert.pem / chain.pem | certbot 2.x 或 acme.sh;90 天续期 | 1–5 分钟(续期) | 0 元 | 中小站点、DevOps |
| Kubernetes cert-manager | TLS Secret | cert-manager 1.14.4;renewBefore 720h | 1–10 分钟 | 0 元 + 集群成本 | 多命名空间、多 Ingress |
| 云 LB 托管 | ACM / 证书服务 | ALB/NLB 443 listener | 5–15 分钟 | DV 0–500 元/年,OV 800–3000 元/年 | 弹性伸缩、跨可用区 |
| IIS 导入 PFX | .pfx | IIS 10;Import-PfxCertificate | 10–20 分钟 | OV 800–3000 元/年 | Windows 内网、传统 ASP.NET |
选型原则:单机且域名少于 5 个,手动或 ACME 都行;多集群、多命名空间优先 cert-manager,让证书随 Ingress 一起声明式管理;Windows/.NET 老系统走 PFX 导入;跨境业务和弹性伸缩用云 LB 托管,核心收益是私钥不进业务节点。注意云厂商的硬约束:据 AWS ACM 文档,ACM 签发的公有证书无法导出私钥,且必须与 ALB/NLB 同区域,用于 CloudFront 时证书必须位于 us-east-1。
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- HTTPS配置 · SSL证书安装服务(各种服务器)
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
ACME 最小可用命令(certbot 2.x,Ubuntu 24.04 仓库版本 2.9):
# 首次签发:nginx 插件自动改写 server 块并 reload
sudo certbot --nginx -d example.com -d www.example.com
--agree-tos -m ops@example.com --no-eff-email
# 续期演练:不真正续签,只验证 ACME 链路与钩子
sudo certbot renew --dry-run
# 续期后统一执行的动作放在这里,避免写进 crontab 被覆盖
sudo tee /etc/letsencrypt/renewal-hooks/deploy/reload.sh <<'EOF'
#!/bin/sh
systemctl reload nginx
EOF
sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload.sh
# 默认到期前 30 天触发续期,可改 renew_before_expiry = 20 days
# 文件位置:/etc/letsencrypt/renewal/example.com.conf
cert-manager 声明式写法(v1.14.4):
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
name: example-tls
namespace: prod
spec:
secretName: example-tls # 产物:kubernetes.io/tls 类型 Secret
duration: 2160h # 90 天
renewBefore: 720h # 提前 30 天续期(默认取 duration 的 2/3)
dnsNames:
- example.com
issuerRef:
name: letsencrypt-prod
kind: ClusterIssuer
IIS 10 导入 PFX(管理员 PowerShell):
$pwd = Read-Host -AsSecureString "PFX 密码"
Import-PfxCertificate -FilePath C:certsexample.pfx `
-CertStoreLocation Cert:LocalMachineMy -Password $pwd
# 取指纹后在 IIS 管理器绑定 443,或用 netsh http show sslcert 复核
Get-ChildItem Cert:LocalMachineMy |
Where-Object { $_.Subject -like "*example.com*" } |
Select-Object Thumbprint, NotAfter
典型报错一:
Problem binding to port 80: Could not bind to IPv4 or IPv6.—— standalone 模式下 80 端口被 Nginx/Apache 占用,改用--nginx/--webroot插件。典型报错二:
curl: (60) SSL certificate problem: unable to get local issuer certificate—— 内网 CA 的根证书未分发到客户端信任库。用curl -v --cacert root.crt https://intranet.example.com可先验证服务端链是否完整,Java 侧还需keytool -importcert -cacerts -file root.crt。
预算与时间成本怎么算:DV 常见 0–300 元/年,OV 约 800–3000 元/年,EV 约 2000–8000 元/年;多域名、通配符和托管服务另计,以 CA 或云厂商当期报价为准。时间上,手动安装 5–30 分钟、ACME 首次 10–30 分钟而续期仅 1–5 分钟、cert-manager 首次 5–15 分钟、云 LB 导入 5–15 分钟——把验收和回滚算进去,变更窗口建议预留 30 分钟。趋势也值得纳入决策:据 CA/Browser Forum SC-081 表决,公有 TLS 证书最长有效期将自 2026 年 3 月起由 398 天降至 200 天,2027 年降至 100 天,2029 年降至 47 天,手动续期的边际成本只会持续上升。
合规与风险:证书管理平台要确认私钥托管区域与审计日志留存;CDN 托管要分清”边缘证书”和”回源证书”是两套生命周期,回源段常被遗忘而先过期;内网 CA 则必须把根证书推进所有客户端信任库,否则浏览器正常、脚本全挂。
出现这些报错先查哪里?6 类真实错误与定位命令
这 6 类报错并不随机:它们分别落在“证书本体 → 证书链 → 域名匹配 → 客户端信任库 → 集群引用”五个层次上。先确定错误属于哪一层,再执行命令,比反复重签证书快得多。下表是速查入口,随后逐条给出可复制的定位命令。
| 报错关键字 | 根因层 | 第一条命令 |
|---|---|---|
| SSL_CTX_use_PrivateKey: key values mismatch | 证书/私钥配对 | openssl pkey 双向 sha256 |
| curl: (60) unable to get local issuer certificate | 服务端证书链 | openssl s_client -showcerts |
| PEM_read_bio_X509_AUX() failed | 文件格式 | openssl x509 -noout |
| ERR_CERT_COMMON_NAME_INVALID | SAN 域名匹配 | openssl x509 -ext subjectAltName |
| PKIX path building failed | Java truststore | keytool -list |
| x509: certificate signed by unknown authority | K8s 引用/过期 | kubectl describe certificate |
为什么报了 key values mismatch?一定是证书和私钥不配对吗?是的。OpenSSL 在 SSL_CTX_check_private_key() 校验失败时抛出该错误(见 OpenSSL 文档中 SSL_CTX_use_PrivateKey 的说明),本质是模数或曲线公钥不一致,与私钥密码无关。分别导出两边的公钥做哈希比对即可确认:
# OpenSSL 1.1.1 / 3.x 均适用;两行输出必须是同一个 64 位十六进制串
openssl x509 -in fullchain.pem -noout -pubkey | openssl pkey -pubin -outform der | openssl sha256
openssl pkey -in privkey.pem -pubout -outform der | openssl sha256
# 修复:换回与该证书同批签发的 privkey.pem,不要重签、不要改私钥密码
# (改密码只会把报错换成 bad decrypt / bad password read)
curl: (60) unable to get local issuer certificate 是本地 CA 包旧,还是服务器漏发中间证书?先确认服务器发了哪些证书。按 RFC 5280 的证书路径构建要求,服务端应发送“叶证书 + 全部中间证书”,根证书可不发。数证书张数:
# 张数 >= 2 表示发了中间证书;只有 1 张即漏发
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE'
# 修复:把中间证书追加到 fullchain.pem(顺序:叶证书在前)
cat example.com.crt intermediate.crt > fullchain.pem
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate|issuer'
据 Let’s Encrypt 文档,fullchain.pem 已包含中间证书,直接配置它即可;cert.pem 单独使用是这条报错最常见的成因。
nginx 启动报 PEM_read_bio_X509_AUX() failed,证书文件哪里不对?该函数只接受 PEM 编码的 X.509,文件是 DER、被加密、或把私钥混进同一文件都会失败。ssl_certificate 无默认值,必须显式指定,且 nginx 1.11.0 起才支持同一指令配置多张证书:
# 能正常输出 subject/dates 才说明是合法 PEM
openssl x509 -in fullchain.pem -noout -subject -dates
# Windows/IIS 导出的 PFX 需转换(-nodes 表示私钥不加密,便于 nginx 读取)
openssl pkcs12 -in site.pfx -nodes -out fullchain.pem
# 校验通过后:nginx -t && nginx -s reload
浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID,证书不是签了吗?现代浏览器不再看 CN 字段,只认 SAN 扩展;据 CA/B 论坛基线要求,公有证书必须包含 SAN。常见情形是只签了 example.com,却用 www.example.com 访问:
# OpenSSL 1.1.1+;老版本改用 -text | grep -A1 'Subject Alternative Name'
openssl x509 -in fullchain.pem -noout -ext subjectAltName
# 期望输出:DNS:example.com, DNS:www.example.com
# 通配符 *.example.com 只覆盖一级子域,不含 example.com 本身,也不含 a.b.example.com
Java 客户端报 PKIX path building failed 怎么修?JDK 默认信任 $JAVA_HOME/lib/security/cacerts(默认口令 changeit),缺中间证书就建不成链。两个方向:让服务端发全链(推荐),或把中间证书导入 truststore:
keytool -importcert -alias intermediate -file chain.pem
-keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit
keytool -list -keystore "$JAVA_HOME/lib/security/cacerts" -alias intermediate
# 导入后需重启 JVM,truststore 在进程启动时加载
Kubernetes 里 certificate signed by unknown authority 或 certificate has expired 先查什么?按“Secret 是否存在且同 namespace → Ingress 引用名是否一致 → 证书是否过期”顺序排查,cert-manager 场景还要看 Certificate 资源的 Events:
kubectl get secret -n prod | grep tls
kubectl get ingress -n prod -o jsonpath='{.items[*].spec.tls[*].secretName}'
kubectl describe certificate example -n prod # 看 Events 中的 Reason
kubectl rollout restart deployment/ingress-nginx-controller -n ingress-nginx
据 Mozilla Server Side TLS 指南,链路问题优先在服务端补齐中间证书,而不是逐个客户端打补丁;这也正是 ssl证书 安装教程最佳实践中把“链完整性校验”放在灰度发布之前的原因——一次 openssl s_client -showcerts 能拦掉上表中近一半的报错。
怎么确认新证书真的生效?外部验收清单
装完证书、nginx -s reload 也执行了,怎么确认它真的生效?答案不是“浏览器能打开就行”。本机访问成功只说明你验的是自己,而 SSL 证书 安装教程最佳实践的最后一步,必须站在公网客户端的视角做外部验收——你验的应该是别人看到的那张证书。
第一步:抓整条链,而不是只看叶子证书
# -servername 触发 SNI,漏掉会拿到默认站点的证书;-showcerts 输出完整链
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望:issuer 为中间 CA(如 Let's Encrypt 的 R11/E5),SAN 含当前域名,notAfter 与签发时间吻合
如果 issuer 直接是根 CA 名,通常说明你把根证书也塞进了 ssl_certificate,或链顺序写反了(据 OpenSSL 文档,s_client 默认只取第一个证书做校验,链不全会在校验阶段暴露)。
第二步:看 Verify return code,非 0 就是没装好
| 返回码 | 含义 | 常见成因 |
|---|---|---|
| 0 | ok | 链完整可信,通过 |
| 20 | unable to get local issuer certificate | 服务器未下发中间证书,客户端缺中间 CA |
| 21 | unable to verify the first certificate | 链首证书自签或中间证书缺失、顺序错误 |
| 10 | certificate has expired | 证书过期,或服务器时间漂移 |
| 62 | hostname mismatch | SAN 不含该域名,或 SNI 未命中对应 server 块 |
注意本机 openssl 的信任库会影响结果,判断服务端问题时应配合 -CAfile 指定目标根库,或直接以 curl 结果为准。
第三步:指定节点验证,避免只验到一台缓存节点
# 绕过 DNS,直连边缘/后端节点,对每个 IP 逐个执行
curl -vI https://example.com --resolve example.com:443:203.0.113.10 2>&1
| grep -E 'SSL certificate verify|HTTP/'
# 期望同时出现 "SSL certificate verify ok" 和 "HTTP/2 200"
--resolve 只改解析不改 SNI,所以它验证的是“这台机器上的证书是否也正确”,多节点集群必须逐个跑,否则灰度期间很可能漏掉某台还挂着旧证书的机器。
第四步:自动化扫描兜底
# testssl.sh 3.2+,--fast 只跑关键项,--severity 过滤输出级别
./testssl.sh --fast --severity MEDIUM https://example.com
重点看 chain issues、certificate expiration 与协议支持项;据 Mozilla Server Side TLS 指南,生产站点应只保留 TLS 1.2/1.3。批量场景可调用 SSL Labs API,但注意其有速率限制。
第五步:真实客户端抽查
Chrome 开发者工具 Security 面板 → View certificate,可直接看到链与 SAN 列表;再抽 1 台 iOS、1 台 Android 真机访问。旧 Android(7.0 以下)不信任 ISRG Root X1,遇到 Let’s Encrypt 证书时会报链错误,这是纯命令行验收发现不了的差异。
第六步:把到期检查变成告警,而不是日历提醒
# -checkend 参数单位为秒,2592000 = 30 天;剩余不足 30 天时退出码非 0
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -checkend 2592000 -noout || echo "CRITICAL: 证书 30 天内到期"
Prometheus 侧用 blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标(Unix 时间戳)更省事,告警表达式可写 probe_ssl_earliest_cert_expiry - time() < 86400 * 30,这样一条规则就能覆盖全站所有域名。
| 验收手段 | 能发现的问题 | 局限 |
|---|---|---|
| openssl s_client | 链顺序、SAN、有效期、SNI | 仅单节点,受本机信任库影响 |
| curl –resolve | 单节点真实握手 + HTTP 状态 | 需逐 IP 手动执行 |
| testssl.sh / SSL Labs | 协议版本、套件、链完整性、漏洞 | 耗时长,有速率限制 |
| 浏览器与真机 | 真实信任库差异、旧系统兼容性 | 抽样,不可回归 |
| blackbox_exporter | 持续可用性与到期预警 | 不校验链是否完整 |
把这几项做成发布门禁里的固定检查项,灰度阶段每放量一批就重跑一遍指定节点验证,才算真正走完了 SSL 证书 安装教程最佳实践的验收环节。
多数 Web 服务只需 reload 而非重启:Caddy 用 `caddy reload`,HAProxy 用 `systemctl reload haproxy`,Nginx 用 `nginx -t && systemctl reload nginx`;Kubernetes 更新 Secret 后由 Ingress Controller 热加载,必要时 `kubectl rollout restart`。重启会中断连接,变更窗口内优先 reload。
浏览器会尝试补链并缓存中间证书,curl/Java 更严格;用 `openssl s_client -showcerts` 检查服务器是否发送中间链,确认 fullchain.pem 含 leaf+intermediate,Java 还要把根/中间证书导入 truststore。
安装流程基本一致,区别在签发审核、价格和信任展示:DV 常见 0-300 元/年,Let's Encrypt 90 天自动续期;OV 约 800-3000 元/年,EV 约 2000-8000 元/年,需要组织验证。OV/EV 不会改变部署命令,但证书链和中间 CA 可能不同。
`*.example.com` 覆盖 `www.example.com`、`api.example.com` 等一级子域,不覆盖 `example.com` 本身,也不覆盖 `a.b.example.com`;需要把裸域写入 SAN,二级子域另签或使用多域名证书。
通常不需要。据 RFC 5280 和主流 CA 文档,服务器发送 leaf + intermediate,根证书由客户端信任库内置;把根证书放进链会增加包体,且部分客户端会因重复根证书报错。内网自建 CA 才需要单独分发根证书。
要分别确认。CDN 边缘证书和回源证书是两条链路,只换边缘时源站可能仍报过期;在 CDN 控制台检查证书版本,源站用 `openssl s_client -connect origin:443 -servername example.com` 验证,必要时刷新缓存并等待 TTL 到期。
先查服务器时间:`date -u` 与 `timedatectl` 确认 NTP 同步;再查证书 notBefore/notAfter 和客户端系统时间。服务器时间偏差超过 5 分钟就会导致新证书被判无效,修复 NTP 后重载服务并复测。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。