SSL 证书申请、部署与续费全流程实战:CSR 生成、Nginx/Apache/Tomcat 配置与真实报错排查
一、问题背景与根因:HTTPS 能打开不等于配置正确
站点换上 HTTPS 后仍然报错,绝大多数不是「证书买错了」,而是下面三类根因之一。先把根因分清,后面每一步操作才有落点。
根因一:信任链断裂。CA 签发的不只是服务器证书(leaf),还有一到两张中间证书。部署时只贴了 leaf,浏览器靠缓存或 AIA 补链可能侥幸能打开,但微信小程序、iOS 原生请求、Java 客户端、curl 往往直接失败,典型报错是 unable to get local issuer certificate。正确做法是部署 fullchain(leaf + 中间证书),顺序必须是 leaf 在前、中间证书在后,根证书不要放进去。
根因二:身份不匹配。证书的 CN 只保留一个域名,真正生效的是 SAN 扩展。只签 example.com 却用 www.example.com 访问,就会命中 ERR_CERT_COMMON_NAME_INVALID。通配符 *.example.com 只覆盖一级子域,不覆盖 a.b.example.com,也不覆盖裸域 example.com(需要单独加一条 SAN)。
根因三:时效与协议失效。CA/Browser Forum 规定公有 TLS 证书单张有效期上限为 398 天,自 2020-09-01 起强制,任何宣称「一张证书管三年」的都是过时信息;Let’s Encrypt 免费证书有效期为 90 天。同时 TLS 1.0/1.1 已被 Chrome、Safari 与微信小程序拒绝,服务端必须开启 TLS 1.2/1.3。证书过期与协议过旧,是「昨天还好、今天全站白屏」最常见的原因。
先用一条命令把现状看清楚,再决定改哪里:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
输出里 subject 看域名、issuer 看签发 CA、notAfter 看到期时间。若 -showcerts 只打印出一张证书,基本可以断定中间证书缺失。微信小程序侧还有额外硬性要求:域名已备案、证书由受信任 CA 签发、不支持自签名、服务端必须支持 TLS 1.2 及以上;否则 wx.request 会直接返回 request:fail ssl hand shake error。
二、证书选型:DV/OV/EV 与单域名/多域名/通配符的边界
选型只需要回答两个问题:要覆盖哪些域名,需不需要组织身份背书。
按覆盖范围分三类:单域名证书只保护一个 FQDN;多域名证书(SAN 证书)在一张证书里塞多个不同域名,主流 CA 默认给 5 个左右、可扩展到 100 个;通配符证书 *.example.com 覆盖该层级下所有二级子域,但不覆盖多级子域和裸域。生产上最常见的组合是「通配符 + 裸域」两条 SAN 一起签。
按验证等级分三类:DV 只验证域名控制权,几分钟签发;OV 需要核验企业工商信息,通常 1-3 个工作日;EV 验证最严,过去会在地址栏显示公司名——这一点已经过时,Chrome 77 起移除了 EV 的绿色公司名 UI,Safari、Firefox 也早已不再展示,EV 现在的价值在于合规审计与保险条款,而不是视觉差异。
有效期方面,所有公有 CA 的证书都不能超过 398 天,商业 CA 通常按「1 年(实为 397/398 天)」售卖,Let’s Encrypt 为 90 天。因此无论买哪种,都必须把续期自动化纳入交付范围,否则 398 天后必然二次故障。
| 等级 | 验证内容 | 签发时长 | 有效期上限 | 价格量级 | 典型场景 |
|---|---|---|---|---|---|
| DV | 域名控制权(DNS TXT / HTTP 文件) | 5 分钟 – 2 小时 | 398 天(LE 90 天) | 免费 – 数百元/年 | 小程序后端、API、个人站 |
| OV | 域名 + 企业工商信息 | 1 – 3 工作日 | 398 天 | 千元级/年 | 企业门户、B 端系统 |
| EV | 域名 + 深度组织核验 | 3 – 7 工作日 | 398 天 | 数千元/年 | 金融、电商合规场景 |
结论:小程序后端、API 网关、个人站点用 DV 通配符即可,成本最低、签发最快;只有金融、电商、招投标等明确要求组织身份或需要合规审计的场景才值得上 OV/EV。把钱花在自动化续期和监控上,收益远大于证书等级。
三、生成私钥与 CSR:openssl 可直接执行的命令
CSR(证书签名请求)包含公钥和主体信息,私钥必须留在自己服务器上,任何情况下都不要发给 CA 或代购服务商。
mkdir -p /etc/ssl/private/example.com && cd /etc/ssl/private/example.com
# 1) 生成 2048 位 RSA 私钥(4096 亦可,握手开销略高)
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
chmod 600 example.com.key
# 2) 生成 CSR(-subj 里 CN 只填主域名)
openssl req -new -key example.com.key -out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/OU=IT/CN=example.com'
注意 -subj 只写了 CN,现代证书必须靠 SAN 扩展生效,所以要用配置文件把 SAN 一起写进 CSR:
cat > san.cnf <<'EOF'
[req]
distinguished_name = dn
req_extensions = ext
prompt = no
[dn]
CN = example.com
[ext]
subjectAltName = @alt
[alt]
DNS.1 = example.com
DNS.2 = www.example.com
DNS.3 = api.example.com
EOF
openssl req -new -key example.com.key -out example.com.csr -config san.cnf
提交前自检,确认 SAN 已写入:
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
如果服务端是 Nginx 1.11+ 且客户端支持,可以改用 ECDSA P-256 私钥,握手更快、包更小:
openssl ecparam -genkey -name prime256v1 -out example.com.ec.key
常见坑:chmod 600 漏做,Nginx worker(nobody/www-data)读不到私钥,启动时报 BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied);证书与私钥不配对时,用下面两条命令比对 modulus 校验:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
四、域名验证与签发:DNS-01 与 HTTP-01 双路径实操
签发前先确认两件事:CAA 记录没有拦住你的 CA,以及验证通道可达。
dig +short CAA example.com
dig +short TXT _acme-challenge.example.com @8.8.8.8
如果 CAA 里只写了某一家 CA,换别家签发会直接被拒,报 CAA record forbids issuance。
路径 A:DNS-01(推荐,支持通配符)。以 acme.sh + 阿里云 DNS API 为例,全程无需开放 80 端口,也适合走 CDN 的站点:
curl https://get.acme.sh | sh -s email=ops@example.com
export Ali_Key='你的AccessKeyId'
export Ali_Secret='你的AccessKeySecret'
~/.acme.sh/acme.sh --issue --dns dns_ali
-d example.com -d '*.example.com' --keylength ec-256
~/.acme.sh/acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd 'systemctl reload nginx'
--install-cert 会把证书复制到指定路径并注册续期钩子,续期后自动 reload,这才是「一次配置、长期免维护」的关键;直接在 Nginx 里引用 ~/.acme.sh/ 下的文件,续期后可能因路径变化失效。
路径 B:HTTP-01(通用)。需要 80 端口对外可达,且 CDN 回源不能改写 /.well-known/acme-challenge/:
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
# 或临时停掉 web 服务独占 80
certbot certonly --standalone -d example.com
商业 CA 的 DV 证书流程类似:在 DNS 服务商处添加 CA 指定的 TXT 记录(形如 _dnsauth.example.com),等 TTL 生效后回控制台点验证。TTL 建议临时调到 60 秒,通过后再改回;Cloudflare 的橙云代理会隐藏源站,务必先切灰或直接改用 DNS-01。
常见失败:Error getting validation data(80 端口不通或被 WAF 拦截)、too many failed authorizations recently(同一账户失败过多,需等待 1 小时)、Invalid response ... 404(webroot 路径与实际站点根目录不一致)。
五、服务端配置示例:Nginx、Apache、Tomcat
Nginx 建议把 80 与 443 拆成两个 server 块,80 只做跳转。注意 http2 的写法在 1.25.1 之后变了:
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/example.com.fullchain.pem;
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_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/trusted.pem;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
}
改完必须先 nginx -t 再 systemctl reload nginx,不要 restart,避免连接中断。
Apache 关键指令如下,httpd 2.4.8+ 只需把 fullchain 写进 SSLCertificateFile:
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- HTTPS配置 · SSL证书安装服务(各种服务器)
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# httpd < 2.4.8 才需要额外指定:
# SSLCertificateChainFile /etc/httpd/ssl/chain.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
Tomcat 需要先转成 PKCS12,再改 Connector:
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key
-out /opt/tomcat/conf/example.p12 -name tomcat -passout pass:ChangeMe123
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol'
maxThreads='200' SSLEnabled='true' scheme='https' secure='true'>
<SSLHostConfig protocols='TLSv1.2,TLSv1.3'>
<Certificate certificateKeystoreFile='/opt/tomcat/conf/example.p12'
certificateKeystorePassword='ChangeMe123'
certificateKeystoreType='PKCS12'/>
</SSLHostConfig>
</Connector>
Tomcat 的坑集中在两处:一是 JDK 8 早期版本默认不启用 TLS 1.3;二是 PKCS12 里必须包含完整链,用 keytool -list -v -keystore example.p12 应能看到 3 条证书条目,少于 3 条大概率缺中间证书。
六、HTTP 301 跳转与 TLS 加固:参数逐项说明
跳转只有一行,但写错会带来两类问题:重定向循环,以及 CDN 场景下把用户跳到源站域名。
第一,用 $host 而不是 $http_host。$host 是规范化后的 Host(去端口、按 server_name 匹配),$http_host 是客户端原始 Host 头,可能带端口或被伪造,用于跳转就是开放重定向漏洞。第二,HTTPS 挂在非 443 端口时跳转要显式带端口:return 301 https://$host:8443$request_uri;。第三,CDN 回源若也走 80,源站不能无条件 301,否则 CDN 跟随跳转拿到的是 HTML 而非静态资源,应按转发头判断:
if ($http_x_forwarded_proto = 'http') {
return 301 https://$host$request_uri;
}
HSTS 要灰度下发。Strict-Transport-Security 一旦下发,浏览器在 max-age 内不会再发任何 HTTP 请求。首次上线建议 max-age=300 跑一周,确认所有子域都能走 HTTPS 再改成 31536000;加了 includeSubDomains 意味着所有子域(包括没配证书的测试域、内网域)都必须支持 HTTPS,这是「上线后子域全挂」最常见的事故源。提交 preload 列表后撤销极慢,务必最后做。
OCSP Stapling 依赖链文件。ssl_stapling on 必须有 ssl_trusted_certificate 指向包含中间与根证书的 PEM,否则 Nginx 只打警告不生效:[warn] 'ssl_stapling' ignored, issuer certificate not found。链文件可用 cat chain.crt root.crt > trusted.pem 拼出。开启后握手少一次外网 OCSP 请求,客户端查询失败也不会阻塞握手。
TLS 1.3 的套件不受 ssl_ciphers 控制。要单独用 ssl_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256;(需 OpenSSL 1.1.1+)。多数场景保持默认即可,强行收窄反而会让部分安卓 WebView 握手失败。
会话复用别关。ssl_session_cache shared:SSL:10m 约可容纳 4 万个会话,配合 ssl_session_timeout 1d 能显著降低 TLS 握手 CPU 开销,对高并发 API 网关收益明显。
七、方案对比表格:证书类型、验证方式与部署成本
选型决策可以拆成三张表:覆盖范围决定买几张,验证等级决定审核周期,验证方式决定运维通道。
| 覆盖类型 | 示例 | 覆盖范围 | 不覆盖 | 适用 |
|---|---|---|---|---|
| 单域名 | example.com |
1 个 FQDN | 任何子域、裸域之外的域名 | 单站点、独立 API |
| 多域名 SAN | a.com, b.com, api.a.com |
默认 5 个,可扩至 100 个 | 未列出的域名 | 多品牌、多业务线 |
| 通配符 | *.example.com |
所有一级子域 | 裸域 example.com、a.b.example.com |
子域多、频繁新增 |
| 验证方式 | 原理 | 是否支持通配符 | 前置条件 | 失败高发点 |
|---|---|---|---|---|
| HTTP-01 | 访问 /.well-known/acme-challenge/ 文件 |
否 | 80 端口公网可达 | CDN 回源改写、WAF 拦截、webroot 路径错 |
| DNS-01 | 校验 _acme-challenge TXT 记录 |
是 | DNS API 权限 | TTL 未生效、多值 TXT 冲突、CAA 拦截 |
| 邮件/文件(商业 CA) | 管理员邮箱或指定文件 | 视 CA 而定 | WHOIS 邮箱可用 | 邮箱不可达、隐私保护屏蔽 WHOIS |
| 方案 | 有效期 | 成本 | 续期方式 | 适合团队 |
|---|---|---|---|---|
| Let’s Encrypt + acme.sh | 90 天 | 0 元 | cron 自动,60 天续 | 有运维能力的团队 |
| 商业 DV(单域/通配符) | ≤398 天 | 数百至数千元/年 | 手动或 API 重签 | 需要发票、SLA、责任赔付 |
| 商业 OV/EV | ≤398 天 | 千元至数千元/年 | 人工审核后重签 | 金融、电商、招投标 |
一个容易被忽略的成本项:OV/EV 每年续期都要重新走企业审核,1-3 个工作日的空窗必须提前排期;DV 与 Let’s Encrypt 则可完全自动化,故障率反而更低。
八、常见错误排查:真实报错与定位命令
下面这些报错在工单里出现频率最高,按「报错原文 → 根因 → 修复动作」对照处理即可。
| 报错原文 | 根因 | 修复 |
|---|---|---|
nginx: [emerg] cannot load certificate ... BIO_new_file() failed |
路径写错或 worker 无读权限 | ls -l 核对路径,chmod 600 key、目录 chmod 755 |
SSL_CTX_use_PrivateKey(...) failed: key values mismatch |
证书与私钥不配对 | 比对 modulus md5,重新签发 |
curl: (60) SSL certificate problem: unable to get local issuer certificate |
缺中间证书 | 改用 fullchain 部署 |
NET::ERR_CERT_COMMON_NAME_INVALID |
SAN 未包含访问域名 | 重签并补 SAN |
NET::ERR_CERT_DATE_INVALID |
证书过期或服务器时间偏移 | timedatectl 校时,立即续期 |
curl: (35) ... sslv3 alert handshake failure |
协议/套件不匹配 | 开启 TLS 1.2/1.3,放宽 ssl_ciphers |
request:fail ssl hand shake error(小程序) |
链不完整或仅支持 TLS 1.0/1.1 | 补 fullchain,改协议版本 |
[warn] 'ssl_stapling' ignored, issuer certificate not found |
缺 ssl_trusted_certificate |
拼接 trusted.pem 并指向 |
证书链是否完整,可用一条命令验证,输出 OK 才算通过:
openssl verify -CAfile root.crt -untrusted chain.crt example.com.crt
# example.com.crt: OK
443 端口不通时先分层排查,不要一上来就改配置:
ss -lntp | grep ':443'
telnet example.com 443
# 云上还需确认安全组放行入方向 443,且未被 iptables/firewalld 拦截
firewall-cmd --list-ports
Let’s Encrypt 报 Error getting validation data 时,用 curl -v http://example.com/.well-known/acme-challenge/test 手工复现验证路径,能最快区分是 DNS、端口还是 WAF 的问题。
九、效果验证与续费自动化
配置完成后至少做三层验证:证书信息、协议能力、跳转行为。
# 1) 看主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 2) 确认 TLS 1.0/1.1 已被拒绝
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null 2>&1 | grep -i 'alert|error'
# 3) 确认 80 跳 301 到 https
curl -sI http://example.com | head -n 5
curl -sI https://example.com | grep -i 'strict-transport-security'
续期必须自动化。acme.sh 安装时会写入 crontab,确认存在这一行:
crontab -l | grep acme.sh
0 3 * * * '/root/.acme.sh'/acme.sh --cron --home '/root/.acme.sh' > /dev/null
certbot 用户用 systemd timer,并做一次 dry-run 演练,避免真到过期才发现钩子失效:
systemctl list-timers | grep certbot
certbot renew --dry-run
再加一个独立的到期监控,任何非 200 或剩余天数低于阈值就告警,比依赖 CA 邮件更可靠:
#!/usr/bin/env bash
HOST=example.com
END=$(echo | openssl s_client -servername $HOST -connect $HOST:443 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ $LEFT -lt 15 ] && echo "WARN $HOST expires in $LEFT days"
最后用 SSL Labs 或 testssl.sh 做一次全量体检,重点看三项:证书链是否完整、是否支持 TLS 1.2/1.3、是否启用了 HSTS。三项全绿,微信小程序与苹果 ATS 侧基本不会再有握手类问题。
常见问题
SSL 证书最长能用多久?为什么有人说是 398 天、有人说是 1 年?
公有 CA 签发的 TLS 证书单张有效期上限是 398 天,自 2020-09-01 起由 CA/Browser Forum 强制,超出该期限的证书会被 Chrome、Safari 直接判为不受信任。商业 CA 售卖的「1 年证书」实际签发天数就是 397/398 天;Let’s Encrypt 免费证书固定 90 天。所谓「三年期证书」现在只是把三年拆成三张 398 天的证书分批签发,本质仍需每年更换。
一张通配符证书能覆盖 www.example.com 和 example.com 吗?
不能。*.example.com 只匹配一级子域,裸域 example.com 必须作为独立 SAN 一起签发,所以正确写法是 -d example.com -d '*.example.com'。同理 *.example.com 也不覆盖 a.b.example.com,多级子域要单独列 SAN 或另签一张 *.b.example.com。
证书链不完整,为什么浏览器能开、小程序却报错?
桌面浏览器会缓存中间证书,并通过证书里的 AIA 地址自动下载补链,所以看起来「正常」;微信小程序、iOS 原生请求、Java 客户端、curl 等不做补链,缺中间证书就直接握手失败。判断方法:openssl s_client -showcerts 只输出一张证书即为缺链,改用 fullchain(leaf + 中间证书,leaf 在前)重新部署即可。
更换证书后需要重启 Nginx / Tomcat 吗?
Nginx 用 systemctl reload nginx 即可平滑加载新证书,不要 restart,避免连接中断;acme.sh 的 --reloadcmd 就是干这件事。Tomcat 需要重新加载 Connector,通常是重启服务,因此更推荐用 PKCS12 + 版本化文件名,重启前先 keytool -list -v 确认链完整,减少停机排错时间。
免费 Let’s Encrypt 证书和付费 DV 证书在安全性上有区别吗?
加密强度没有区别,两者都是 DV 级别、都走同样的 ACME 或人工验证、都能签 ECDSA P-256 或 RSA 2048。差异在有效期(90 天 vs 398 天)、是否有商业 SLA 与责任赔付、是否提供发票、是否支持自定义有效期和证书透明度日志定制。技术选型上,只要续期自动化到位,免费证书完全能满足小程序与生产 API 的需求。
开启 HSTS 之后,子域访问不了 HTTPS 怎么办?
这是 includeSubDomains 带来的典型事故:浏览器在 max-age 内强制所有子域走 HTTPS,而某个子域没有证书或只支持 HTTP。应急办法是给该子域补一张证书(通配符最省事),或在确认风险后用 max-age=0 覆盖响应头清除缓存。规范做法是先以 max-age=300 灰度一周,逐个确认子域可用后再提升到 31536000,最后才考虑提交 preload。