Nginx HTTPS 配置与 SSL 证书部署全流程:CSR 申请、证书链拼接、TLS 1.3 优化与真实报错排查
一、问题背景与根因:HTTPS 配置为什么总在浏览器里翻车
Chrome 报 NET::ERR_CERT_COMMON_NAME_INVALID 或 NET::ERR_CERT_AUTHORITY_INVALID,Firefox 报 SSL_ERROR_BAD_CERT_DOMAIN,命令行 curl: (60) SSL certificate problem: unable to get local issuer certificate——这些提示几乎覆盖了九成以上的 HTTPS 配置故障。它们看起来相似,根因却完全不同,可以归为五类:
- 证书链不完整:服务器只下发了站点证书(leaf),没有附带中间 CA 证书。桌面浏览器会通过证书里的 AIA 地址自动补链,所以你本机看着正常;但 Android 原生客户端、Java 的 HttpClient、微信小程序、严格模式的 curl 不会补链,直接握手失败。
- 域名不匹配:证书的 CN 或 SAN 扩展中没有实际访问的域名,最常见的是申请时漏填
www子域。 - 私钥与证书不配对,或私钥权限被设为 644,Nginx 出于安全考虑拒绝加载。
- 系统时间不同步:服务器时钟落后于证书的 notBefore,会报证书尚未生效。
- 协议与套件过旧:仍启用 TLSv1.0/1.1,或只支持已被移除的 3DES 套件,现代客户端报
SSL_ERROR_NO_CYPHER_OVERLAP。
还必须纠正一个普遍过时的认知:公网信任证书的最长有效期早就不是 2 年。自 2020 年 9 月 1 日起,Apple 与 Chrome 强制要求 TLS 证书有效期不超过 398 天;Let’s Encrypt 免费证书有效期固定为 90 天,官方建议每 60 天续期一次。CA/Browser Forum 已通过 SC-081 决议,将把上限分阶段压缩到 200 天(2026 年 3 月)、100 天(2027 年 3 月)乃至 47 天(2029 年 3 月)。这意味着「买一张证书管三年」的方案彻底失效,自动化续期与到期监控必须写进部署流程,而不是等告警邮件上门再处理。
二、前置准备:CSR 生成、SAN 填写与 80/443 端口放行
无论自签还是向 CA 申请,第一步都是在服务器上生成私钥和 CSR(证书签名请求)。关键是 -addext 参数里要把主域名和所有子域都写进 SAN,现代浏览器只认 SAN,不再看 CN。
mkdir -p /etc/nginx/ssl
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout /etc/nginx/ssl/example.com.key
-out /etc/nginx/ssl/example.com.csr
-subj '/C=CN/ST=Beijing/L=Beijing/O=Example Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
chmod 600 /etc/nginx/ssl/example.com.key
chown root:root /etc/nginx/ssl/example.com.key
提交给 CA 之前先自检 CSR 内容,避免因 SAN 缺失被退回:
openssl req -in /etc/nginx/ssl/example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
CA 的域名验证方式有两种:DNS TXT 记录(推荐,不受端口和跳转规则影响)与 HTTP 文件验证,后者需要能访问 http://example.com/.well-known/pki-validation/xxx.txt。因此必须提前放行端口:
firewall-cmd --permanent --add-service=http --add-service=https && firewall-cmd --reload
ufw allow 80/tcp && ufw allow 443/tcp
ss -lntp | grep -E ':80|:443'
云服务器还要在安全组入方向放行 80/443,源地址 0.0.0.0/0。注意:如果 80 端口被 CDN 回源规则或旧的全站 301 跳转拦截,HTTP 文件验证会返回 403/301 而失败,此时改用 DNS 验证;同时把 TXT 记录的 TTL 设为 600 秒以上,给海外 CA 的递归解析留出足够时间。
三、Nginx 实操:证书上传、链文件拼接与平滑重载
从 CA 下载的压缩包通常包含三个文件:example.com.crt(站点证书)、ca_bundle.crt(中间证书)、example.com.key(私钥)。Nginx 的 ssl_certificate 必须指向「站点证书 + 中间证书」的完整链,顺序不能反,否则部分客户端会报颁发者未知。
cd /etc/nginx/ssl
cat example.com.crt ca_bundle.crt > fullchain.pem
chmod 644 fullchain.pem && chmod 600 example.com.key
两条校验命令必须都通过。第一条验证链完整性,第二条验证证书与私钥是否配对(两行 MD5 必须完全一致):
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted ca_bundle.crt example.com.crt
# 期望输出:example.com.crt: OK
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
写配置后先做语法检查,再用 reload 而不是 restart——reload 是平滑加载,不会掐断已建立的连接:
nginx -t
# nginx: configuration file /etc/nginx/nginx.conf test is successful
systemctl reload nginx
echo | openssl s_client -connect 127.0.0.1:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
两个高频坑:ssl_certificate 建议一律写绝对路径,相对路径会按 Nginx 的 prefix(通常是 /etc/nginx)解析,换机器就崩;另外 Nginx 低于 1.15.9 的版本在使用 Let’s Encrypt 时不要重复拼接 chain.pem,因为 fullchain.pem 本身已包含中间证书。
四、配置示例:单域名、多域名 SAN、通配符与强制跳转
下面是一份可直接落地的生产配置,覆盖 HTTP 跳转、TLS 1.2/1.3、会话缓存、OCSP Stapling 与 HSTS。注意 http2 on; 是 Nginx 1.25.1 之后的新写法,旧版本请改用 listen 443 ssl http2;。
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com;
location ^~ /.well-known/ { root /var/www/html; }
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on;
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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384: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/ca_bundle.crt;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
add_header X-Content-Type-Options nosniff always;
root /var/www/example.com;
index index.html;
}
多域名 SAN 证书无需额外配置,把 server_name 列出全部域名即可;通配符证书 *.example.com 只能匹配一级子域,a.b.example.com 不在覆盖范围内,此时要么单独申请,要么把二级域名写进 SAN。HSTS 上线时先用 max-age=300 观察 24 小时,确认全站资源(图片、JS、API)都已走 HTTPS 再调到 31536000,否则浏览器会强制跳转且难以回滚。
五、方案对比:DV/OV/EV 与单域名、SAN、通配符怎么选
选型时先看校验强度,再看覆盖范围,最后看续期方式,三者决定成本和运维负担。
| 类型 | 校验内容 | 签发时长 | 浏览器表现 | 典型场景 |
|---|---|---|---|---|
| DV 域名型 | 仅验证域名所有权(DNS TXT / HTTP 文件) | 1-10 分钟 | 锁标 + https | 个人站、API、测试环境 |
| OV 企业型 | 域名 + 工商注册信息人工核验 | 1-3 个工作日 | 锁标,证书详情显示企业名 | 企业官网、电商 |
| EV 扩展验证 | 最严格的人工尽职调查 | 3-7 个工作日 | 主流浏览器已取消绿色地址栏 | 金融、政企合规要求 |
| 覆盖方案 | 覆盖范围 | 有效期 | 参考成本 | 续期方式 |
|---|---|---|---|---|
| Let’s Encrypt 单域名 | 1 个精确域名 | 90 天 | 免费 | certbot 自动 |
| 商业 DV 单域名 | 1 个精确域名 | ≤ 398 天 | 约 300 元/年 | 手动 + 监控 |
| 多域名 SAN | 单证书最多 100 个域名 | ≤ 398 天 | 按域名数量加价 | 手动 + 监控 |
| 通配符证书 | *.example.com(仅一级) | ≤ 398 天 | 约 700 元/年 | 手动 + 监控 |
| 代安装配置服务 | 安装 + 调优 + 到期监控 | 单次 | 约 100 元/次 | 按次 |
结论很直接:域名数量少、能改 DNS、有 CI/CD 的团队,用 Let’s Encrypt + certbot 最省成本;域名多且分散在多个业务方手里,选通配符减少管理面;对外合规审计要求高的,选 OV。无论哪种,都要把「到期前 15 天告警」写进监控,因为 398 天和 90 天都会来得比想象中快。
六、常见错误排查:真实报错与逐条修复
以下报错均来自实际生产环境,按出现频率排序。
nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: TRUSTED CERTIFICATE)——证书文件不是 PEM 格式,或含 Windows 换行、多余中文注释。用file example.com.crt和head -1确认首行是-----BEGIN CERTIFICATE-----;CRLF 用sed -i 's/r$//'清除;DER 格式用openssl x509 -inform DER -in cert.der -out cert.pem转换。nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)——证书与私钥不配对,或 fullchain 拼接顺序颠倒。用第三节的 modulus MD5 比对定位。curl: (60) SSL certificate problem: unable to get local issuer certificate——缺中间证书。执行openssl s_client -connect example.com:443 -servername example.com -showcerts,正常应返回至少 2 段证书,只有 1 段就是链不完整。NET::ERR_CERT_COMMON_NAME_INVALID——SAN 不含当前域名,重新签发并补齐DNS:www.example.com。SSL_ERROR_NO_CYPHER_OVERLAP——客户端与服务器无共同套件。检查ssl_protocols是否误删 TLSv1.2,以及ssl_ciphers是否只剩 ECDSA 套件而证书是 RSA。403 Forbidden出现在/.well-known/pki-validation/——被 location 规则或目录权限拦截,加location ^~ /.well-known/ { root /var/www/html; }并chmod -R 755。nginx: [warn] ssl_stapling ignored, issuer certificate not found——未配置ssl_trusted_certificate或缺少resolver。- Cloudflare 报 521/525——521 是源站 443 未监听,525 是源站证书不受信任(自签)。把 SSL 模式设为 Full (strict),并在源站安装 Cloudflare Origin CA 证书。
排查顺序建议固定为:nginx -t 看语法 → openssl s_client 看链与有效期 → curl -vI 看握手协议 → 最后才怀疑浏览器缓存。
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- HTTPS配置 · SSL证书安装服务(各种服务器)
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- SSL证书安装服务 · 腾讯云 HTTPS 部署 · 证书过期更新
七、自动化续期与到期监控:别让证书在凌晨过期
90 天的证书靠手工续期必然出事故。certbot 是目前最省事的方案,一条命令完成签发、写入 Nginx 配置并加跳转:
apt install -y certbot python3-certbot-nginx
certbot --nginx -d example.com -d www.example.com --agree-tos -m ops@example.com --redirect
certbot renew --dry-run
安装后会自动注册 certbot.timer,每天运行两次,可用 systemctl list-timers | grep certbot 确认。若用 cron 手动调度,务必带 --deploy-hook,因为 renew 只更新磁盘文件,Nginx 内存里仍是旧证书:
0 3 * * * /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'
商业证书没有自动续期,必须自己监控。下面这个脚本可直接放进 cron,每天 9 点检查剩余天数:
#!/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 ))
[ $LEFT -lt 15 ] && echo "$DOMAIN 证书剩余 $LEFT 天" | mail -s 'SSL 到期告警' ops@example.com
有 Prometheus 的团队更推荐 blackbox_exporter,直接采集 probe_ssl_earliest_cert_expiry 指标并配 expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 15 告警规则,可覆盖全部域名而非单点脚本。
八、效果验证:从 curl 到 SSL Labs A+
配置完成不等于生效,按下面四层逐级验证。
第一层,基础连通与协议协商。
curl -I https://example.com
curl -vI https://example.com 2>&1 | grep -E 'SSL connection|TLSv'
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# 期望:alert protocol version(即 TLS 1.1 已被正确禁用)
第二层,证书链与有效期。
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
第三层,浏览器实测。F12 → Security 面板确认 Connection 显示 TLS 1.3、Certificate 链为三级完整;Console 搜索 Mixed Content,把所有 http:// 资源改为协议相对或 https,并加 CSP upgrade-insecure-requests。
第四层,第三方评级。跑一次 SSL Labs Server Test,拿到 A 或 A+ 需同时满足:仅启用 TLS 1.2/1.3、无 RC4/3DES、密钥长度 ≥ 2048 位(或 ECDSA P-256)、启用 HSTS、OCSP Stapling 正常。若评级只有 B,多半是仍支持 TLS 1.0/1.1 或缺少 HSTS。最后用 nginx -V 确认编译时链接的 OpenSSL 版本 ≥ 1.1.1,否则无法启用 TLS 1.3。
常见问题
免费的 Let’s Encrypt 证书会被浏览器不信任吗?和付费证书差在哪?
不会。Let’s Encrypt 是受信任的公共 CA,其根证书已内置在主流操作系统和浏览器中,加密强度与商业 DV 证书完全一致。差别在于三点:有效期只有 90 天且必须自动化续期;只签发 DV,不做企业身份核验;不支持通配符之外的定制需求(通配符需走 DNS-01 验证)。需要展示企业名称或满足合规审计时,才考虑 OV/EV。
证书最长有效期到底是多久?为什么我的证书只有 90 天?
公网信任的 TLS 证书当前上限是 398 天,这是 2020 年 9 月起 Apple 与 Chrome 强制执行的规则,不是 CA 自行决定。Let’s Encrypt 主动把有效期设为 90 天,是为了配合自动化续期、缩短密钥泄露的暴露窗口。CA/Browser Forum 已通过 SC-081,未来将依次压缩到 200 天、100 天、47 天,因此「一次配置多年不管」的模式已不可行。
通配符证书能覆盖二级子域吗?
不能。*.example.com 只匹配 a.example.com 这一级,a.b.example.com 不在覆盖范围内。需要覆盖多级时,要么在证书里同时写入 *.example.com 和 *.b.example.com 两个 SAN,要么为具体域名单独签发。另外通配符证书通常不支持 IDN 泛域名,中文域名需转 punycode 后单独处理。
配置完 HTTPS 后网站打不开或返回 502,先查什么?
先执行 nginx -t 确认语法,再 systemctl status nginx 看是否启动失败。若 Nginx 正常但 502,说明是后端问题,与证书无关,检查 upstream 是否监听、proxy_pass 地址是否正确。若浏览器报 ERR_CONNECTION_REFUSED,多半是安全组或防火墙没放行 443,用 ss -lntp | grep 443 和外部 telnet example.com 443 交叉确认。
已经接入 CDN,证书应该配在哪一侧?
两侧都要配。用户到 CDN 边缘节点这一段用 CDN 平台上的证书(通常可免费申请或上传),CDN 回源到你的服务器这一段用源站证书。回源模式建议选 Full (strict),并给源站装 Cloudflare Origin CA 或商业证书;若选 Flexible,回源走 HTTP,既失去端到端加密,也容易触发重定向死循环。
同一张证书可以部署到多台服务器吗?
可以。证书本身不含服务器绑定信息,只要私钥同步到位,就能在 N 台服务器、N 个 IP 上同时使用。但私钥每多一份拷贝就多一个泄露面,建议用 Ansible Vault、KMS 或配置管理工具分发,文件权限固定 600、属主 root,并在负载均衡层统一做 TLS 终止,减少后端节点的证书数量。