跳到主要内容
SSL 证书付费服务

Nginx HTTPS 配置与 SSL 证书部署全流程:CSR 申请、证书链拼接、TLS 1.3 优化与真实报错排查

Nginx HTTPS 配置与 SSL 证书部署全流程:CSR 申请、证书链拼接、TLS 1.3 优化与真实报错排查 — 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 看握手协议 → 最后才怀疑浏览器缓存。

七、自动化续期与到期监控:别让证书在凌晨过期

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 终止,减少后端节点的证书数量。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。