HTTPS 证书配置实战:从 CSR 申请、Nginx 部署到 301 跳转与故障排查
一、问题背景:证书“买了、装了”为什么还是不安全
在 HTTPS 改造项目里,最高频的工单不是“如何申请证书”,而是“证书已经签发并上传,浏览器仍然报不安全”。典型现场有三种:Chrome 地址栏显示锁,但部分安卓机打开提示“您的连接不是私密连接”;微信小程序 wx.request 报 request:fail ssl handshake error;后端 Java 服务调用第三方 HTTPS 接口抛 PKIX path building failed。这些现象看起来各不相同,根因却高度集中。
第一类是证书链不完整。CA 签发时给出的是“服务器证书 + 中间证书”,很多人只把服务器证书写进 ssl_certificate。桌面版 Chrome 有 AIA 补链机制会自动下载中间证书,所以出现“我本地是好的”;而 Android、Java、curl、小程序、iOS 原生请求走严格校验,缺中间证书会直接握手失败。
第二类是域名不匹配。通配符证书 *.example.com 只覆盖一级子域,不覆盖裸域 example.com,也不覆盖 a.b.example.com。第三类是私钥与证书不成对,多见于 CSR 在多台机器上生成、或续期后只换了 crt 没换 key。
第四类是协议与套件过旧:服务端仍开启 TLSv1.0/1.1,或只提供 3DES/RC4 套件,现代浏览器和微信小程序(要求 TLS 1.2 及以上)会直接拒绝。第五类是环境问题:服务器时间偏差导致 certificate is not yet valid;同一 IP 承载多站点却未启用 SNI;以及最容易被误判的一种——域名未完成 ICP 备案,80/443 被运营商侧拦截,这与证书本身毫无关系,换任何 CA 都不会好。
二、准备阶段:生成 CSR、校验私钥与选对证书类型
无论走免费还是商业渠道,第一步都是生成密钥对与 CSR。推荐 RSA 2048 位(兼容性最好)或 ECDSA P-256(体积小、握手快,但需确认客户端支持)。
# RSA 2048
openssl genrsa -out example.com.key 2048
# 或 ECDSA P-256
openssl ecparam -genkey -name prime256v1 -out example.com.key
# 生成 CSR(CN 写主域名,其余域名走 SAN)
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Beijing/L=Beijing/O=Example Ltd/CN=example.com"
# 查看 CSR 内容,确认 SAN 列表
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
拿到证书后务必先做本地校验,避免“传上去才发现不对”:
# RSA:比对模数指纹,两行输出必须完全一致
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# ECDSA:比对公钥
openssl x509 -noout -pubkey -in example.com.crt | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
# 校验证书链(chain.pem 为中间证书)
openssl verify -CAfile chain.pem -untrusted chain.pem example.com.crt
选型上,DV 证书只校验域名控制权,适合个人站与内部系统;OV/EV 需要企业资质与组织核验,适合金融、电商等需要展示主体信息的场景。这里要纠正一个过时认知:主流浏览器自 2019 年起已取消 EV 证书的绿色地址栏,EV 只剩证书详情里的组织字段,加密强度与 DV 完全相同,不要被“EV 更安全”的销售话术误导。
有效期方面必须更新认知:公共信任证书单次有效期上限为 398 天(CA/B Forum 规定,2020 年 9 月起生效),Let’s Encrypt 默认 90 天,并已提供 6 天短期证书选项,行业也已确定逐步缩短至 47 天的路线。这意味着“一年一续”的人工模式必然出事故,自动化续期是硬性要求而非可选项。
三、完整实操:从签发到 Nginx 上线(命令可直接执行)
路线 A:Let’s Encrypt 自动化签发,零成本、可续期。
apt install -y certbot python3-certbot-nginx
# 单域名/多域名:HTTP-01 校验,自动改写 Nginx 并加 301
certbot --nginx -d example.com -d www.example.com
--agree-tos -m ops@example.com --redirect
# 泛域名:必须走 DNS-01
certbot certonly --manual --preferred-challenges dns
-d "*.example.com" -d example.com
路线 B:商业证书手工部署。关键动作是把服务器证书与中间证书拼成 fullchain,这是 90% 故障的分水岭:
install -m 600 example.com.key /etc/nginx/ssl/example.com.key
cat example.com.crt intermediate.crt > fullchain.pem
install -m 644 fullchain.pem /etc/nginx/ssl/fullchain.pem
install -m 644 intermediate.crt /etc/nginx/ssl/chain.pem
然后做语法检查与平滑重载,reload 不会断开现有连接:
nginx -t && nginx -s reload
若使用云负载均衡(SLB/ALB)或 CDN,则把 fullchain 与私钥上传到证书管理控制台,再绑定 443 监听;容器环境用 Ingress 的 tls 字段引用 Secret:
kubectl create secret tls example-tls
--cert=fullchain.pem --key=example.com.key -n prod
安全细节别省略:私钥必须 600 且属主为 root;证书目录绝不能放在 Web 根目录下,.key 可被直接下载是最常见的信息泄露源;证书文件不要提交进 Git 仓库。整套流程 15 分钟内可以跑完,真正的成本在后续的续期与巡检。
四、配置示例:Nginx、Apache、Spring Boot 与 301 跳转
Nginx 生产可用模板,含 HTTP 301、TLS 1.2/1.3、OCSP Stapling 与 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.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/chain.pem;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
location / {
root /var/www/example;
index index.html;
}
}
Apache 的写法差异在于需要单独指定 SSLCertificateChainFile:
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Spring Boot 内嵌 Tomcat 需先转成 PKCS12:
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key
-out example.p12 -name example -passout pass:$SSL_PASS
server:
port: 443
ssl:
enabled: true
key-store: classpath:example.p12
key-store-type: PKCS12
key-store-password: ${SSL_PASS}
enabled-protocols: TLSv1.2,TLSv1.3
关于跳转:return 301 会把 POST 降级为 GET,纯前端站点无影响,但 API 网关建议用 308 保留请求方法与请求体。HSTS 首次上线先给 max-age=300 观察一天,确认全站无混合内容后再拉到一年,否则回退极其痛苦。
五、方案对比:证书类型与部署方式怎么选
先看校验等级。下表是三类证书的实际差异,注意“浏览器展示”一列已经和很多旧文章写的不同:
| 维度 | DV 域名型 | OV 企业型 | EV 增强型 |
|---|---|---|---|
| 校验内容 | 域名控制权 | 域名 + 企业资质 | 域名 + 企业资质 + 更严格核验 |
| 签发时长 | 分钟级 | 1–3 个工作日 | 3–7 个工作日 |
| 浏览器展示 | 锁标志 | 锁标志(详情可见组织) | 锁标志(绿色地址栏已取消) |
| 典型用途 | 个人站、测试、内部系统 | 企业官网、SaaS | 金融、政务 |
| 价格区间 | 0–数百元 | 千元级 | 数千元 |
再看覆盖范围,这是“证书买错”最集中的地方:
| 类型 | 覆盖 | 不覆盖 |
|---|---|---|
| 单域名 | example.com | www.example.com |
| 多域名 SAN | 证书中列出的每个域名 | 未列出的域名 |
| 泛域名 *.example.com | www / api / shop 等一级子域 | 裸域 example.com、a.b.example.com |
最后是部署方式的选择,续期能力比价格更值得关注:
| 方式 | 续期方式 | 适合场景 | 常见坑 |
|---|---|---|---|
| Nginx 自建 + certbot | systemd timer 自动 | 自有服务器、成本敏感 | 需放行 80 端口做 HTTP-01 |
| 云 SLB / ALB | 控制台或 API 上传 | 云上多实例业务 | 证书须上传到同一地域 |
| CDN 托管证书 | 平台自动签发续期 | 静态站、高并发 | 回源须也是 HTTPS,否则混合内容 |
| K8s Ingress | cert-manager | 容器化微服务 | Secret 必须与 Ingress 同 namespace |
一句话结论:子域数量少于 5 个用多域名 SAN 更省心,子域动态增长(如每个租户一个二级域)才用泛域名;而无论选哪种,都要把“有效期上限 398 天、Let’s Encrypt 90 天”写进运维台账。
六、常见错误排查:8 个真实报错与对应处置
1)curl: (60) SSL certificate problem: unable to get local issuer certificate
缺中间证书。用 openssl s_client -showcerts 看是否只返回一张证书,修复方式是 cat example.com.crt intermediate.crt > fullchain.pem 后 reload。
2)nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
私钥与证书不匹配。用第二节的 modulus/pubkey 指纹比对,重新匹配 CSR 与 key。
3)error 20 at 0 depth lookup: unable to get local issuer certificate
chain.pem 缺中间证书,或拼接顺序错误。正确顺序是“服务器证书 → 中间证书”,不要拼根证书。
4)NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN
SAN 不含当前访问域名。执行 openssl x509 -noout -text -in example.com.crt | grep -A1 "Subject Alternative Name" 确认,泛域名证书记得补裸域。
5)curl: (35) error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure
客户端与服务端没有共同协议或套件。检查 ssl_protocols 是否已开 TLSv1.2/1.3,套件里是否只剩已被淘汰的 3DES。
6)微信小程序 request:fail ssl handshake error
逐项确认:TLS ≥ 1.2、证书链完整、域名已在微信后台配置、请求地址不带端口号、证书由公共信任 CA 签发。
7)SSL certificate problem: certificate has expired 或 certificate is not yet valid
前者是续期失败,后者是服务器时间错误。用 timedatectl status 查看,chronyd/ntpd 重新同步。
8)证书正常但站点 502 / 打不开
多为安全组未放行 443,或回源仍是 HTTP 被 CDN 拒绝;也可能是之前误配了长周期 HSTS,浏览器强制跳转 https 而 443 未监听。
七、效果验证:命令行自检 + 在线评级 + 到期巡检
部署完不要只看浏览器,用四条命令做客观验证:
# 1. 证书主题、签发者与有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 2. 链校验,期望输出 Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>/dev/null | grep "Verify return code"
# 3. 301 跳转是否生效
curl -sI http://example.com | head -2
# 4. 旧协议应握手失败(预期报 handshake failure)
openssl s_client -connect example.com:443 -tls1_1 </dev/null
把到期检查做成定时任务,比任何人工台账都可靠:
#!/bin/bash
end=$(openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
if [ "$days" -lt 15 ]; then
echo "WARN: example.com 证书剩余 ${days} 天" | mail -s "SSL 到期告警" ops@example.com
fi
写入 crontab:0 9 * * * /opt/scripts/check_ssl.sh。在线侧用 SSL Labs 做一次全量评级,拿到 A/A+ 的条件通常是:仅启用 TLS 1.2/1.3、启用 HSTS、无 RC4/3DES、开启 OCSP Stapling、RSA 密钥 ≥ 2048 位或 ECDSA P-256、支持前向保密套件。评级从 A 掉到 B 时,九成是套件列表里残留了 CBC 或密钥长度不足。
八、续期与长期运维:把“到期事故”变成不可能
证书有效期上限 398 天、Let’s Encrypt 90 天,且行业正推进缩短至 47 天,靠日历提醒续期已经不现实。certbot 用户先做一次演练,确认整个续期链路可用:
certbot renew --dry-run
systemctl list-timers | grep certbot # 确认 certbot.timer 已启用
续期成功后必须让 Nginx 重新加载,否则新证书不会生效。用 deploy hook 固化这一步:
# /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
#!/bin/bash
nginx -t && systemctl reload nginx || systemctl restart nginx
chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
泛域名证书走 DNS-01,手工模式无法自动续期,应改用 DNS 插件(如 certbot-dns-aliyun、certbot-dns-cloudflare)并配置只允许改 TXT 记录的 API 子账号,凭据文件权限设为 600。
商业证书用户的运维重点是“台账 + 灰度”:把每张证书的域名、签发日、到期日、部署位置(Nginx / SLB / CDN / Ingress)记进 CMDB;到期前 30 天完成新证书上传,先在测试域名验证链完整,再切生产。多实例场景要确保所有节点都替换,漏掉一台就会出现“刷新几次有时正常有时报错”的诡异现象。最后给证书文件加监控告警,任何节点剩余天数低于 15 天即触发工单,这样“证书过期”才会真正变成历史问题。
常见问题
问题:泛域名证书能同时覆盖 example.com 和 www.example.com 吗?
不能完全覆盖。*.example.com 只匹配一级子域,因此覆盖 www.example.com、api.example.com,但不覆盖裸域 example.com,也不覆盖 a.b.example.com。正确做法是申请时把裸域一并加入 SAN,即同时提交 *.example.com 与 example.com,大多数 CA 支持这种组合。
问题:SSL 证书有效期最长是多少天?
公共信任证书单次有效期上限为 398 天(CA/B Forum 规定,2020 年 9 月起生效),不是过去常说的一到两年。Let’s Encrypt 默认 90 天,并提供 6 天短期证书选项;行业已确定逐步缩短至 47 天的路线。因此续期必须自动化,手工续期在 47 天时代基本不可行。
问题:域名没有备案,能配 HTTPS 吗?
技术上可以签发并安装证书,但备案是 ICP 管理要求,与证书无关。域名解析到中国大陆境内服务器时,未备案会被接入商侧拦截,此时 HTTPS 同样打不开,很容易被误判为“证书问题”。若服务器在境外或使用港澳节点,则不受此限制,但访问速度与稳定性需自行评估。
问题:HTTP 301 跳转到 HTTPS 会影响接口和小程序吗?
会有影响。301 是永久重定向,部分客户端会把 POST 改写为 GET 并丢弃请求体,API 场景建议改用 308 保留方法与请求体。微信小程序要求请求地址必须是 HTTPS、TLS 1.2 及以上、证书链完整且不能带端口号,因此小程序后端应直接使用 https 地址,不要依赖 301。
问题:免费证书和付费证书的加密强度有区别吗?
没有区别。加密强度由密钥长度与协议套件决定,与是否付费无关,DV 免费证书和万元级 EV 证书用的是同一套 TLS 加密。差异在于有效期长度、泛域名支持、赔付保障、OCSP/CRL 稳定性、技术支持响应,以及 OV/EV 提供的组织身份核验信息。
问题:更换证书后需要重启 Nginx 吗?
不需要重启,nginx -t 校验配置后执行 nginx -s reload 或 systemctl reload nginx 即可平滑加载新证书,现有连接不会中断。只有在 reload 失败或需要更换监听端口、协议栈等结构性变更时才考虑 restart。