HTTPS 证书部署全流程:CSR 生成、CA 签发、Nginx/Apache 配置与真实报错排查
一、问题背景与根因:证书装上了,为什么浏览器还是提示不安全
实际交付中最常见的场景是:用户在 CA 机构买完 SSL 证书,拿到 domain.crt 和 domain.key 两个文件,直接写进 Nginx 的 ssl_certificate 就重启,结果 Chrome 报 NET::ERR_CERT_AUTHORITY_INVALID,微信小程序接口报 request:fail ssl hand shake error,Java 客户端抛 PKIX path building failed。证书本身没问题,问题几乎都出在部署环节。归纳起来是五类根因:
- 证书链不完整:只部署了服务器证书,没有拼接中间 CA 证书。桌面浏览器有 AIA 补链机制,能自动下载中间证书,所以出现“我这儿能打开”;但部分 Android 版本、Java 8、curl、微信/支付宝 SDK、各类 IoT 设备不做 AIA fetching,直接握手失败。这是线上 HTTPS 故障中占比最高的一类,通常超过一半。
- 私钥与证书不匹配:重复生成过 CSR,最后上传的是旧私钥。
- 域名不匹配:证书签给
www.example.com,用户却访问example.com;或者买了*.example.com,发现example.com和多级子域a.b.example.com都不在覆盖范围内。 - 协议与端口配置错误:443 端口没写
ssl参数、CDN 回源仍走 HTTP、页面内硬编码http://资源造成混合内容。 - 非证书问题被误判:服务器在中国大陆但域名未做 ICP 备案,80/443 会被运营商侧拦截,表现是连接重置或超时,而不是证书告警。这两类现象必须先区分开,否则会一直围着证书打转。
还要建立时间意识:自 2020 年 9 月 1 日起,公有 CA 签发的 SSL 证书最长有效期被限制为 398 天,Let’s Encrypt 免费证书只有 90 天,且 CA/Browser Forum 已通过决议在未来几年把上限逐步压缩到 47 天。“一年一续”的运维模式已经失效,自动化续期是硬性要求而非可选项。
定位问题时先跑下面两条命令,30 秒内就能判断是链、域名还是有效期的问题:
# 查看服务端实际下发的证书主体、签发者、有效期
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
# 查看服务端下发的完整证书链(s: 主体,i: 签发者)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | grep -E '^ [0-9]+ s:|^ i:'
如果第二条命令只输出一段 s:/CN=example.com,看不到任何中间证书的 i: 行,基本可以判定是证书链不完整。
二、证书选型:DV/OV/EV、单域名/通配符与有效期规则
选证书前先明确三件事:要覆盖几个域名、验证级别要多高、由谁负责续期。
按验证级别分:DV(域名验证)只校验域名控制权,通常几分钟内签发;OV(组织验证)额外核验企业工商信息,需要 1-3 个工作日;EV(扩展验证)审核最严。这里要纠正一个过时认知:Chrome 自 2019 年(版本 77)起已移除 EV 证书的绿色地址栏和企业名称展示,Firefox、Safari 也相继跟进,现在 EV 与 DV 在浏览器里外观完全一致。因此除非金融、支付类业务有明确的合规或合同要求,否则不必为 EV 支付溢价。
按覆盖范围分:单域名证书只保护一个 FQDN;多域名证书(SAN 证书)可在一张证书里放多个不同域名,默认 3-5 个,可扩展;通配符证书 *.example.com 只覆盖同一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com,正确做法是把 example.com 作为附加 SAN 一起签发。
按签发方式分:商业 CA 与免费 CA(Let’s Encrypt、ZeroSSL)。加密强度上两者没有区别,都是 2048 位 RSA 或 256 位 ECDSA,浏览器锁标也一致,差异在有效期(90 天 vs 398 天)、赔付保障、OCSP/CRL 服务和技术支持。还有一个容易踩坑的时效点:Let’s Encrypt 已于 2025 年 5 月 7 日停止提供 OCSP 响应,全面转向 CRL。如果 Nginx 里保留了 ssl_stapling on 而证书来自 Let’s Encrypt,日志会持续出现 stapling 相关告警,这不影响握手,但会污染日志,可以关闭 stapling 或改用支持 OCSP 的商业证书。
| 类型 | 验证方式 | 签发时长 | 有效期上限 | 典型场景 |
|---|---|---|---|---|
| DV 单域名 | DNS TXT / HTTP 文件 | 分钟级 | 398 天 | 个人站、测试环境、内部 API |
| DV 通配符 | DNS-01(强制) | 分钟级 | 398 天 | 多子域业务、SaaS 租户域名 |
| OV 多域名 | 域名 + 企业工商核验 | 1-3 工作日 | 398 天 | 企业官网、对外业务系统 |
| EV | 域名 + 企业 + 电话回访 | 3-7 工作日 | 398 天 | 有合规硬要求的金融/支付 |
| Let’s Encrypt | ACME 自动验证 | 秒级 | 90 天 | 可自动化的一切场景 |
三、实操第一步:生成私钥与 CSR(含 SAN 扩展)
CSR(Certificate Signing Request)是申请证书时提交给 CA 的文件,包含公钥和主体信息。私钥必须自己保管,绝不能上传给 CA。以下命令在 Linux/macOS 上可直接执行,Windows 建议用 WSL 或 Git Bash。
1)生成私钥。推荐 RSA 2048 位(兼容性最好)或 ECDSA P-256(性能更好、证书体积更小)。给私钥加口令可以防止文件泄露即失守,但 Nginx 每次 reload 都需要输入口令,生产环境通常用 chmod 600 加严格属主来替代口令保护。
# RSA 2048(加口令)
openssl genrsa -aes256 -out example.com.key 2048
# 或 ECDSA P-256(不加口令)
openssl ecparam -genkey -name prime256v1 -out example.com.key
chmod 600 example.com.key && chown root:root example.com.key
2)写 SAN 配置文件。现代浏览器完全忽略 CSR 里的 CN 字段,只看 subjectAltName,所以必须显式声明。新建 san.cnf:
[req]
distinguished_name = dn
req_extensions = v3_req
prompt = no
[dn]
C = CN
ST = Zhejiang
L = Hangzhou
O = Example Co., Ltd.
CN = example.com
[v3_req]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
DNS.3 = api.example.com
3)生成 CSR 并校验 SAN。
openssl req -new -key example.com.key -out example.com.csr -config san.cnf
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
4)验证私钥与证书是否配对。这一步能提前拦掉 key values mismatch 类故障,两者的模数 MD5 必须完全一致:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
ECDSA 证书没有 modulus,改用公钥比对:openssl x509 -noout -pubkey -in example.com.crt 与 openssl pkey -pubout -in example.com.key 的输出应逐字节相同。顺带一提,私钥和 CSR 建议按域名归档到独立目录,保留最近两代,便于证书更新失败时快速回滚。
四、实操第二步:CA 签发、证书链拼接与自动化续期
把 CSR 提交给 CA 后,DV 证书一般几分钟内签发,你会拿到三类文件:服务器证书(example.com.crt)、中间证书(intermediate.crt 或 ca_bundle.crt)、根证书(root.crt)。根证书不要部署,它已经在所有客户端的信任库里;多传根证书不会更安全,反而增大握手包体积,部分老客户端还会直接报错。
正确的 fullchain 顺序是:服务器证书在前,中间证书在后,多级中间证书按“由叶到根”的顺序拼接。
cat example.com.crt intermediate.crt > fullchain.crt
# 用根证书验证整条链
openssl verify -CAfile root.crt -untrusted intermediate.crt example.com.crt
# 期望输出:example.com.crt: OK
如果 CA 提供的 ca_bundle.crt 里已经包含多级中间证书,直接 cat example.com.crt ca_bundle.crt > fullchain.crt 即可,不要手工拆分,否则很容易把顺序拼反,症状是浏览器正常但 Java 客户端失败。
有脚本能力的团队直接用 ACME 协议签发,比手工上传 CSR 更可靠:
# 方式一:certbot + webroot(域名已解析到本机,80 端口可达)
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
# 方式二:acme.sh + DNS API(泛域名只能走 DNS-01)
curl https://get.acme.sh | sh -s email=ops@example.com
export Ali_Key='your_access_key'
export Ali_Secret='your_access_secret'
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
# 安装证书并配置 reload 钩子(续期后自动生效)
~/.acme.sh/acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/fullchain.crt --reloadcmd 'nginx -s reload'
acme.sh 安装时会自动写入 crontab,每天检查一次,剩余 30 天自动续期;certbot 由 systemd timer 触发,可用 certbot renew --dry-run 演练。注意 --reloadcmd 一定要配,否则证书文件更新了但 Nginx 还在用内存里的旧证书,表现为“文件明明是新的,浏览器还说过期”。
五、配置示例:Nginx / Apache / Tomcat 三套可直接套用的配置
Nginx 侧完整配置(80 强制跳转 + 443 现代套件 + HSTS):
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+;旧版本写 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.crt;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.crt;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Content-Type-Options nosniff always;
location / { proxy_pass http://127.0.0.1:8080; }
}
三个细节:ssl_trusted_certificate 指向的是中间证书链,不是 fullchain,配错会触发 stapling 告警;ssl_prefer_server_ciphers off 是把算法选择权交给客户端,配合 TLS 1.3 才能拿到 A+ 评级;HSTS 的 max-age 一旦下发就会被浏览器记住,首次上线建议先用 300 秒灰度观察。
Apache 配置:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Apache 2.4.8 之后可以把中间证书直接拼进 SSLCertificateFile,此时 SSLCertificateChainFile 已废弃,写上去会有 deprecation 提示。
Tomcat 需要先转成 PKCS12/JKS:
openssl pkcs12 -export -in fullchain.crt -inkey example.com.key -out example.com.p12 -name tomcat -passout pass:changeit
keytool -importkeystore -srckeystore example.com.p12 -srcstoretype PKCS12 -destkeystore example.com.jks -deststoretype JKS
Tomcat 的 Connector 里配 keystoreFile、keystorePass、SSLEnabled="true"、sslEnabledProtocols="TLSv1.2,TLSv1.3"。注意 Tomcat 8.5 之前的 BIO Connector 对 TLS 1.3 支持不完整,建议升级到 9.x 并确认协议参数真正生效。
六、方案对比:手工部署、自动化签发与托管服务
同一张证书,部署方式不同,长期运维成本差异很大。下表按中小团队的真实运维场景对比:
| 维度 | 手工 CSR + 商业证书 | certbot / acme.sh 自动签发 | 云厂商证书托管 |
|---|---|---|---|
| 有效期 | 最长 398 天 | 90 天(Let’s Encrypt) | 398 天 / 90 天 |
| 续期方式 | 人工提醒,极易遗漏 | cron 自动,需配 reloadcmd | 平台自动,绑定 CDN/SLB 后免运维 |
| 通配符支持 | 支持 | 支持(必须 DNS-01) | 支持 |
| 证书链 | 需手工拼接 | fullchain 自动生成 | 平台下发即完整 |
| 典型故障 | 忘记续期、链不全 | reload 未触发、DNS API 密钥失效 | 回源协议不一致、绑定域名遗漏 |
| 适用规模 | 1-5 个域名,强合规要求 | 10+ 域名,有脚本能力 | 已有云资源,追求免运维 |
选择建议:域名数量在 5 个以内且业务方坚持使用 OV 证书,走“手工 CSR + 商业 CA + 到期监控告警”;域名多、子域动态增长,直接上 acme.sh + DNS API,把续期彻底交给脚本;站点已挂在 CDN 或负载均衡后面,优先用云平台托管证书,但要特别警惕“客户端到 CDN 用 HTTPS、CDN 回源用 HTTP”这种半截 HTTPS 配置——它会让证书本身完全正常,而回源链路上的数据仍是明文。
再补一个加密算法维度的对比:RSA 2048 握手包更大、兼容性最好;ECDSA P-256 握手数据量约为 RSA 的四分之一,移动端首包更快,但 Android 4.4 以下和部分老 Java 客户端不支持。稳妥做法是双证书部署,在 Nginx 里配置两个 ssl_certificate 分别指向 RSA 与 ECDSA 证书,由服务端按客户端能力自动选择,既拿性能又不丢兼容性。
七、常见错误排查:8 个真实报错与对应命令
1. nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
证书与私钥不是一对。用第三节的 modulus 命令比对,不一致就找回与当前 CSR 匹配的那份私钥,重新签发。
2. NET::ERR_CERT_AUTHORITY_INVALID / 微信小程序 request:fail ssl hand shake error
证书链不完整,服务端只下发了叶子证书。检查 ssl_certificate 是否指向 fullchain 而非单证书文件。
3. curl: (60) SSL certificate problem: unable to get local issuer certificate
同样是链问题,也可能是客户端 CA 库过旧(如 CentOS 7 的 ca-certificates 未更新)。先用 openssl s_client -showcerts 确认服务端下发了几张证书,再用 curl -v --cacert fullchain.crt https://example.com 交叉验证。
4. SSL_ERROR_BAD_CERT_DOMAIN / Hostname mismatch
证书 SAN 不含当前访问域名。注意 *.example.com 不覆盖 example.com,也不覆盖 a.b.example.com。用 openssl x509 -noout -text -in fullchain.crt | grep -A1 'Subject Alternative Name' 逐条核对。
5. nginx: [warn] “ssl_stapling” ignored, issuer certificate not found for certificatessl_trusted_certificate 未配置或指向了错误的文件(应指向中间证书,不是 fullchain 也不是根证书)。若使用 Let’s Encrypt,因 OCSP 服务已于 2025 年 5 月停止,直接移除 stapling 配置即可。
6. javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed
Java 客户端不信任该链,通常是 JDK 的 cacerts 缺少中间证书或根证书。让服务端补齐中间证书即可解决,无需修改客户端代码。
7. Mixed Content: The page at ‘https://example.com’ was loaded over HTTPS, but requested an insecure resource ‘http://cdn.example.com/a.js’
页面内仍有 http 硬编码资源。用 grep -rn 'http://' ./templates | head -n 20 扫一遍模板,改成 https 或协议相对地址,并加 Content-Security-Policy: upgrade-insecure-requests 兜底。
8. AH01909: RSA certificate configured for example.com:443 does NOT include an ID which matches the server name
Apache 的 ServerName 与证书 SAN 不匹配,或 VirtualHost 顺序导致默认站点抢先匹配。用 apachectl -S 检查虚拟主机映射。
最后强调一点:如果现象是“连接被重置/超时”而非证书告警,先排除 ICP 备案问题。中国大陆节点的 80/443 在未备案时会被拦截,此时 openssl s_client 根本连不上,和 SSL 证书毫无关系,排查方向要立刻切换。
八、效果验证:握手测试、评级与到期监控
部署完成后按下面五步验收,每一步都有明确的期望输出。
# 1. 完整握手 + 链验证(用系统 CA 库做信任锚)
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null | tail -n 20
# 期望看到 Verify return code: 0 (ok)
# 2. 到期时间(监控脚本用这个)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate
# 3. 协议降级测试:TLS 1.0/1.1 必须握手失败
openssl s_client -connect example.com:443 -tls1_1 </dev/null
# 4. 跳转与 HSTS 头
curl -sI http://example.com | head -n 3
curl -sI https://example.com | grep -i strict-transport-security
到期监控脚本可以直接放进 crontab,每天 9 点跑一次,剩余不足 15 天就发邮件:
#!/bin/bash
DOMAIN='example.com'
END=$(echo | openssl s_client -connect $DOMAIN:443 -servername $DOMAIN 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
if [ $LEFT -lt 15 ]; then
echo "$DOMAIN SSL 证书剩余 $LEFT 天,请立即续期" | mail -s 'SSL Cert Alert' ops@example.com
fi
验收清单:Verify return code 为 0;SSL Labs 评级 A 及以上(A+ 需要 HSTS 且 max-age 不少于 6 个月);TLS 1.0/1.1 已禁用;HTTP 返回 301 跳到 HTTPS;响应头带 HSTS;服务端下发 2-3 张证书;续期钩子能正常触发 reload。做到这七条,基本可以杜绝“证书过期导致全站不可用”这类事故。
另外建议每季度演练一次 certbot renew --dry-run 或 acme.sh --renew --force。DNS API 密钥轮换、防火墙策略变更、服务器迁移都会让自动续期在某天静默失效,只有真正跑通过一次,才能确认它确实能续上。
常见问题
公有 CA 签发的 SSL 证书最长有效期为 398 天,Let’s Encrypt 免费证书为 90 天。CA/Browser Forum 已通过决议将逐步缩短至 47 天,手工续期已不可行,必须配置自动续期和到期告警。
不能。*.example.com 只匹配同一级子域,如 www.example.com、api.example.com,不匹配 example.com,也不匹配多级子域 a.b.example.com。签发时要把 example.com 作为附加 SAN 一起提交。
不需要。根证书已内置在操作系统和浏览器的信任库中,服务端只需部署“服务器证书 + 中间证书”拼接成的 fullchain。多传根证书会增大握手包体积,部分老客户端反而报错。
加密强度和浏览器锁标完全一致,都是 2048 位 RSA 或 256 位 ECDSA。差异在有效期(90 天 vs 398 天)、是否含 OV 企业信息、赔付保障、技术支持,以及 OCSP 服务(Let’s Encrypt 已于 2025 年 5 月停止 OCSP)。
取决于服务器位置。服务器在中国大陆,80/443 端口必须完成 ICP 备案,否则会被运营商拦截,表现为连接重置或超时而非证书报错;服务器在香港或海外则无需备案,可直接部署 SSL 证书。
典型症状是证书链不完整。iOS 和桌面浏览器有 AIA 补链机制,会自动下载中间证书;部分 Android 版本、Java 客户端和 curl 不做补链,直接握手失败。把中间证书拼进 fullchain 即可解决。