跳到主要内容
安装配置教程

SSL 证书安装教程最佳实践:从文件校验到灰度发布的 6 步验收流程

ssl证书 安装教程最佳实践 — 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 条命令跑完。

  1. 域名与 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 列表里
  2. 有效期: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 天告警升级。别用”记得续”这种人工流程。

  3. 链完整性:缺中间证书是最常见的线上事故

    # 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
  4. 私钥匹配:对不上就别改配置,直接回退证书包

    # 分别导出公钥再算 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)
  5. 算法与密钥长度:确认没签出 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 证书并行部署
  6. 权限与命名:回滚时间要压在 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。

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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。