SSL 证书实战全指南:通配符、IP 证书、代码签名、申请配置与过期续费
问题背景与根因:证书买了却用不上
运维工单里最高频的一类问题是:证书已经采购并部署,浏览器、小程序或 Java 客户端仍然报错。把近两年的故障归类,根因集中在五点,没有一条是“证书没买”。
- 覆盖范围理解错误。通配符
*.example.com只匹配一级子域(如a.example.com),既不包含主域example.com,也不匹配a.b.example.com,且星号只能出现在最左侧标签。跨域、跨级一律不生效。 - 证书链不完整。只部署了叶子证书(leaf),漏掉中间 CA。桌面 Chrome 会通过证书内的 AIA 地址自动补链,所以“我这儿是好的”;而旧版 Android、Java 8、微信小程序、Go 的 crypto/tls 不会补链,直接握手失败。
- 私钥与证书不配对、算法过时。CSR 与最终部署的私钥不是同一对;或仍在使用 RSA 1024、SHA-1 签名,已被主流客户端拒绝。
- 有效期新规。自 2020-09-01 起,公共 TLS 证书单次签发最长 398 天;Let’s Encrypt 固定 90 天。CA/B Forum SC-081 已确定继续缩短:2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。仍按“一次买三年”规划,必然在半夜过期。
- 对 EV 的认知过时。Chrome 自 2019 年起移除 EV 证书的绿色地址栏,Firefox、Edge 同步跟进。EV 的价值转为组织信息展示与合规审计,而不是 UI 上的绿条。
下面按“选型 → 申请 → 配置 → 排错 → 续期 → 验证”的顺序给出一套可直接执行的流程,命令在 OpenSSL 1.1.1+/3.x、Nginx 1.20+、Apache 2.4.8+ 上均可复现。
选型边界:DV/OV/EV、通配符、IP 证书与代码签名
选型只看三件事:域名结构、验证强度要求、私钥形态。
- DV(域名验证):只验证域名控制权,ACME 或邮件/TXT 验证后 10 分钟内签发,Subject 中不含企业名。适合个人站、测试环境、内部 API 网关。
- OV(组织验证):核验营业执照、电话回拨,证书 Subject 带
O=字段,签发 1–3 个工作日。适合企业官网、支付回调页、需要向甲方出示资质的场景。 - EV(扩展验证):最严核验(工商、律师函、邓白氏编码等),签发 3–7 天。注意 EV 已无绿色地址栏,仅在证书详情和部分合规审计中有价值。
- 通配符:
*.example.com一本证书覆盖无限个一级子域,DV/OV 均可。若主域也要用,必须在 SAN 中追加DNS:example.com;二级子域需另签*.a.example.com。 - 多域名 SAN:单证书可挂多个不同域名,主流 CA 上限 100 个名称,超过需拆单。
- IP 证书:SAN 中写
IP:203.0.113.10,用于没有域名的对外 API、设备管理口、内网出口。Let’s Encrypt 长期不签发 IP 证书(2025 年起才在短有效期证书中试验性支持),生产环境请选商业 CA。IP 变更必须重签,且客户端不能依赖 SNI。 - 代码签名:给 .exe/.msi/.ps1/驱动签名,OV 与 EV 两档,单次有效期上限 39 个月。自 2023-06-01 起,CA/B Forum 要求代码签名私钥必须存放在 FIPS 140-2 Level 2 或 CC EAL4+ 以上的硬件令牌/HSM 中,私钥不可导出;EV 代码签名还必须通过 EV 令牌完成签名,SmartScreen 信誉靠下载量逐步累积。
一句话决策:子域多选通配符,无域名选 IP 证书,要露企业名选 OV,发 Windows 软件选代码签名,能自动化就绝不手工续期。
完整实操步骤:从私钥、CSR 到合并证书链
以下命令可直接复制执行,示例域名为 example.com,IP 为 203.0.113.10。
# 1. 生成 ECDSA P-256 私钥(推荐,握手更快、包更小)
openssl ecparam -genkey -name prime256v1 -out example.com.key
chmod 600 example.com.key
# 2. 生成 CSR,SAN 同时写入通配符与主域
openssl req -new -key example.com.key -out example.com.csr
-subj '/C=CN/ST=Beijing/L=Beijing/O=Example Tech Ltd/CN=*.example.com'
-addext 'subjectAltName=DNS:*.example.com,DNS:example.com'
# 3. 校验 CSR 内容,确认 SAN 与 CN 正确
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
若必须用 RSA(部分老旧设备不支持 ECDSA),把第 1、2 步替换为:
openssl req -new -newkey rsa:2048 -nodes -sha256
-keyout example.com.key -out example.com.csr
-subj '/C=CN/O=Example Tech Ltd/CN=*.example.com'
-addext 'subjectAltName=DNS:*.example.com,DNS:example.com'
IP 证书的 CSR 写法不同,CN 与 SAN 都要写 IP:
openssl req -new -key ip.key -out ip.csr -subj '/CN=203.0.113.10'
-addext 'subjectAltName=IP:203.0.113.10'
提交 CA 后拿到 example.com.crt 与 intermediate.crt,按“叶子在前、中间在后”合并,并校验私钥与证书是否配对:
cat example.com.crt intermediate.crt > fullchain.pem
openssl x509 -in example.com.crt -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256 # 两行哈希必须一致
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted intermediate.crt example.com.crt
通配符证书必须走 DNS-01 验证,用 acme.sh 或 certbot 可全自动完成,无需手工续期:
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength ec-256
certbot certonly --dns-cloudflare --dns-cloudflare-credentials ~/.secrets/cf.ini
-d example.com -d '*.example.com'
配置示例:Nginx、Apache、IP 直连与小程序后端
Nginx 是主流选择,注意 ssl_certificate 必须指向合并后的 fullchain,而不是单张叶子证书:
server {
listen 443 ssl;
http2 on;
server_name example.com *.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE+AESGCM:ECDHE+CHACHA20:DHE+AESGCM:!aNULL:!MD5:!3DES;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
add_header Strict-Transport-Security "max-age=31536000" always;
}
提示:Let’s Encrypt 自 2025-05-07 起不再在证书中写入 OCSP URL,并于 2025-08-06 关闭 OCSP responder,因此对 LE 证书配置 ssl_stapling on; 已无意义,日志会出现 stapling 被忽略的提示。
Apache 2.4.8 之后不需要单独的链文件,SSLCertificateFile 直接指向 fullchain:
<VirtualHost *:443>
ServerName example.com
ServerAlias *.example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
</VirtualHost>
IP 直连场景(无域名)必须使用 IP 证书,且 server_name 写 IP,客户端不能依赖 SNI:
server {
listen 443 ssl;
server_name 203.0.113.10;
ssl_certificate /etc/nginx/ssl/ip-fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/ip.key;
}
微信小程序对后端有三条硬约束:必须是 HTTPS 且端口为 443、域名已完成 ICP 备案、证书链被系统信任(自签名一律拒绝),TLS 版本需 ≥1.2,域名不能填 IP 也不能带端口。使用通配符证书时,请求域名必须与该通配符同级,例如 *.api.example.com 签发的证书不能用于 www.example.com。小程序出现 request:fail ssl hand shake error 时,九成是中间证书缺失。
对比表格:证书类型与有效期新规
| 证书类型 | 覆盖范围 | 验证内容 | 单次有效期 | 典型场景 | 关键限制 |
|---|---|---|---|---|---|
| DV 单域名 | 1 个精确域名 | 域名控制权 | ≤398 天 | 个人站、测试环境 | 不显示企业名 |
| DV 通配符 | *.example.com 全部一级子域 | DNS-01 验证 | ≤398 天 | SaaS 多租户、子域众多 | 不含主域与二级子域 |
| OV 单域名/多域名 | 1–100 个 SAN | 工商+电话核验 | ≤398 天 | 企业官网、支付回调 | 签发 1–3 天,需营业执照 |
| OV 通配符 | *.example.com | 企业核验+域名 | ≤398 天 | 企业内部系统群 | 续费需重新核验 |
| EV 单域名 | 1 个域名 | 最严身份核验 | ≤398 天 | 金融、招投标、合规 | 无绿条,签发 3–7 天 |
| IP 证书 | IP:203.0.113.10 等 | IP 归属核验 | ≤398 天 | 无域名 API、设备管理口 | IP 变更须重签,无 SNI |
| OV 代码签名 | .exe/.msi/.ps1 | 企业核验 | ≤39 个月 | Windows 软件分发 | 私钥在硬件令牌中 |
| EV 代码签名 | 可签内核驱动 | 最严核验 | ≤39 个月 | 驱动、SmartScreen 加速 | 需 EV 令牌或云签名 |
有效期新规时间表(CA/B Forum SC-081),运维排期必须按这张表倒推:
| 生效日期 | 公共 TLS 证书单次最长有效期 |
|---|---|
| 2020-09-01 | 398 天 |
| 2026-03-15 | 200 天 |
| 2027-03-15 | 100 天 |
| 2029-03-15 | 47 天 |
选型结论:域名结构固定且子域多 → 通配符;对外无域名 → IP 证书;需要展示企业主体 → OV;发 Windows 安装包或驱动 → 代码签名。不要为了“绿条”买 EV,那是 2019 年之前的认知。证书周期越短,自动化价值越高,398 天降到 47 天后,手工续期在生产环境里不可行。
常见错误排查:真实报错与处置
下面这些报错几乎覆盖了 95% 的现场问题,按顺序对照即可定位。
curl: (60) SSL certificate problem: unable to get local issuer certificate
原因:服务端未下发中间证书。处置:用openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null查看返回证书条数,少于 2 条即确认缺链,重新合并 fullchain。NET::ERR_CERT_COMMON_NAME_INVALID或SSL: no alternative certificate subject name matches target host name 'api.example.com'
原因:SAN 中没有该域名,或通配符层级不匹配(*.example.com不能用于a.b.example.com)。处置:核对openssl x509 -in fullchain.pem -noout -ext subjectAltName。nginx: [emerg] SSL_CTX_use_PrivateKey("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
原因:私钥与证书不配对。处置:用上文 pubkey sha256 对比法确认,重新部署配对文件。nginx: [emerg] PEM_read_bio_X509_AUX("/etc/nginx/ssl/fullchain.pem") failed (SSL: error:0909006C:PEM routines:get_name:no start line)
原因:文件不是 PEM,或把私钥写进了 crt,或合并顺序颠倒。处置:确认文件以-----BEGIN CERTIFICATE-----开头。x509: certificate signed by unknown authority(Go/Java 客户端)
原因:容器内 CA 库缺失或链不全。处置:Alpine 执行apk add ca-certificates,Debian 执行update-ca-certificates。NET::ERR_CERT_DATE_INVALID
原因:证书已过期或客户端系统时间错误。处置:openssl x509 -noout -dates -in fullchain.pem核对 notBefore/notAfter。curl: (35) error:0A000126:SSL routines::unexpected eof while reading
原因:443 端口被非 TLS 服务占用,或防火墙拦截。处置:ss -lntp | grep 443与openssl s_client -connect 127.0.0.1:443本地验证。SignTool Error: No certificates were found that met all the given criteria.
原因:代码签名令牌未插入、驱动未安装,或证书已过期。处置:certutil -csp查看令牌,确认用signtool sign /sha1 <指纹> /fd sha256指定证书。
排查顺序建议:先本地 openssl s_client 看链,再 curl -vI 看域名匹配,最后才怀疑客户端。
过期续费与自动化:从 398 天到 47 天的运维姿势
先建立到期巡检,任何证书剩余天数低于 30 天即告警:
# 查看线上证书有效期与签发者
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -dates -subject -issuer
# 剩余天数
end=$(openssl x509 -in fullchain.pem -noout -enddate | cut -d= -f2)
echo $(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
# 30 天内到期则返回非 0,可直接接入监控
openssl x509 -checkend 2592000 -noout -in fullchain.pem || echo ALERT_EXPIRING
certbot 与 acme.sh 的续期必须做到“续期 + 重载”一步完成,否则新证书落地但进程仍加载旧证书:
# certbot 干跑验证 + 部署钩子
certbot renew --dry-run
certbot renew --deploy-hook 'systemctl reload nginx'
systemctl list-timers | grep certbot
# acme.sh 安装证书并绑定重载命令
acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/fullchain.pem
--reloadcmd 'nginx -s reload'
acme.sh --cron --home ~/.acme.sh
Prometheus 可用 blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标做统一告警,阈值设为 21 天。
续费要点逐项确认:通配符续费必须重走 DNS-01,DNS API Token 过期是续期失败的头号原因;OV/EV 续费需重新核验组织信息,建议提前 30 天提交;IP 证书续费前确认 IP 未变更;代码签名续费会换发新硬件令牌,旧令牌到期即作废,CI 流水线需同步更新云签名配置。证书周期缩短到 100 天以下后,任何“人工到期提醒”都不再可靠,ACME 自动化是唯一解。
效果验证:握手、链路与终端实测
部署完成后按四层验证,全部通过才算收工。
# 1. 协议与套件
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep -E 'Protocol|Cipher'
nmap --script ssl-enum-ciphers -p 443 example.com
# 2. 证书链完整性(返回条数 ≥2)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 3. 本地链验证
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted intermediate.crt example.com.crt
# 4. HTTP 层与 HSTS
curl -sI https://example.com | head -5
浏览器侧打开开发者工具的 Security 面板,确认显示“连接安全”、协议为 TLS 1.3、证书链完整;再用 SSL Labs 跑一次评级,A+ 的关键条件是:仅启用 TLS 1.2/1.3、无 RC4/3DES、启用 HSTS、证书链完整、密钥 ≥2048 位(RSA)或 P-256(ECDSA)。
小程序需在真机上验证,开发者工具的“详情 → 域名信息”可看到实际协商的证书;wx.request 成功返回即代表链与域名均匹配。代码签名用 signtool verify /pa /v app.exe 或在 PowerShell 中执行 Get-AuthenticodeSignature .app.exe,状态应为 Valid。IP 证书直接访问 https://203.0.113.10,浏览器地址栏不应出现域名不匹配警告。
常见问题
不能。*.example.com 只匹配一级子域如 a.example.com,不匹配 a.b.example.com,也不包含 example.com 本身。需要主域时在同一证书 SAN 中追加 DNS:example.com;二级子域必须单独签发 *.a.example.com 或改用多域名证书。
传统上不支持 IP 地址,2025 年起才在短有效期证书中试验性支持,生产环境不建议依赖。需要 IP 证书请选商业 CA,CSR 的 SAN 写 IP:203.0.113.10,且 IP 一旦变更必须重新签发,客户端也不能依赖 SNI。
目前公共 TLS 证书单次签发最长 398 天(2020-09-01 起生效),Let’s Encrypt 固定 90 天。SC-081 已确定分阶段缩短:2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天,必须用 ACME 自动化续期。
多半是只部署了叶子证书。Nginx 的 ssl_certificate 应指向 leaf+中间证书合并的 fullchain.pem,顺序是叶子在前;Apache 2.4.8+ 同样只需 SSLCertificateFile 指向 fullchain。用 openssl s_client -showcerts 数一下返回证书是否 ≥2 张。
没有了。Chrome 自 2019 年起移除 EV 视觉标识,Firefox、Edge 同步跟进。EV 现在的价值在于组织信息展示、合规审计和部分金融招投标要求,不要为了“绿条”买 EV,按实际核验需求选 OV 更划算。
不能。自 2023-06-01 起,代码签名私钥必须存放在 FIPS 140-2 Level 2 或 CC EAL4+ 以上的硬件令牌/HSM 中,EV 代码签名同样如此。私钥不可导出,只能在插着令牌的机器上用 signtool 签名,CI 场景需采购云签名服务。