跳到主要内容
Nginx

Sectigo SSL 证书 Nginx 部署实战:证书链、TLS 配置与续期排错

Sectigo(原 Comodo CA)是常见的商业 CA。DV 证书通常分钟级签发,OV 约 1-3 个工作日,EV 约 3-5 个工作日,保障金最高约 50 万美元(以具体产品条款为准)。本文围绕 Sectigo 证书在 Nginx 上的实际部署,给出可直接执行的命令、配置、对比表与真实报错排查。

问题背景与根因:为什么 Sectigo 证书在 Nginx 上“浏览器正常、客户端报错”

Sectigo 证书签发成功不等于部署成功。Nginx 只读取 PEM 格式,不直接使用 Windows/IIS 常见的 PFX,也不读取 JKS。部署时至少需要两个文件:包含“站点证书+中间证书”的 fullchain.pem,以及签发时匹配的私钥 example.com.key。很多故障的根因是把叶子证书当成 fullchain 上传:浏览器可能通过缓存或 AIA 补链显示正常,而 curl、Java、小程序、支付回调等严格校验证书链的客户端会报 curl: (60) SSL certificate problem: unable to get local issuer certificate 或 PKIX path building failed。另一个根因是 CSR 与私钥不匹配:提交 CSR 后重新生成私钥,会导致 Nginx 报 key values mismatch。还需注意公共信任 TLS 证书单张有效期:2020 年至 2026 年 3 月上限为 398 天,2026-03-15 起按 CA/Browser Forum SC-081 降至 200 天,2027 年起进一步缩短至 100 天;Let’s Encrypt 为 90 天。续期后必须让 Nginx 重新加载新文件。Nginx 1.25.1 起 listen 443 ssl http2 的写法已弃用,应改为 listen 443 ssl; 加 http2 on;。排查前先执行 nginx -v 与 openssl version 确认版本。

准备证书文件与私钥:PEM、fullchain 与 CSR 的关系

在 Sectigo 控制台下载“Nginx / PEM”包,通常得到站点证书、中间证书和私钥。把站点证书与中间证书按“站点证书在前、中间证书在后”合并为 fullchain.pem;不要只放叶子证书,也不要放入根证书。创建目录并上传:

sudo install -d -m 700 /etc/nginx/ssl
scp example.com_fullchain.pem example.com.key root@SERVER:/etc/nginx/ssl/
sudo chown root:root /etc/nginx/ssl/example.com.key
sudo chmod 600 /etc/nginx/ssl/example.com.key
sudo chmod 644 /etc/nginx/ssl/example.com_fullchain.pem

检查证书主题、签发者、有效期和 SAN,并确认链中证书数量:

openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
grep -c 'BEGIN CERTIFICATE' /etc/nginx/ssl/example.com_fullchain.pem

正常 fullchain 至少包含 2 张证书(叶子+中间证书)。若只有 1,说明链不完整。CSR 只用于向 CA 申请证书,不放到 Nginx;若自行生成密钥,可执行 openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj ‘/CN=example.com’ -addext ‘subjectAltName=DNS:example.com,DNS:www.example.com’。生成后必须用同一把私钥完成签发,否则后续必然出现证书与私钥不匹配。OCSP Stapling 还需要单独的 chain.pem(中间证书),可从 fullchain 中拆分。

完整实操步骤:备份、写入配置、校验与重载

先备份现有站点配置,避免 nginx -t 失败后影响线上:

sudo cp /etc/nginx/sites-available/example.com /etc/nginx/sites-available/example.com.bak.$(date +%F)
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/example.com

编辑 /etc/nginx/sites-available/example.com,写入下一节的配置。随后执行语法检查:

sudo nginx -t
sudo nginx -T | grep -nE 'ssl_certificate|server_name|listen 443'

nginx -t 输出 syntax is ok 与 test is successful 才可重载。重载不会中断现有连接:

sudo systemctl reload nginx
sudo systemctl status nginx --no-pager
sudo tail -n 50 /var/log/nginx/error.log

若 reload 失败,用 journalctl -u nginx -n 50 –no-pager 查看 systemd 日志;容器环境应进入容器执行 nginx -t,再对容器主进程发送 HUP 或重启容器。确认配置实际加载的是新文件:nginx -T 会打印合并后的完整配置,检查 ssl_certificate 路径是否指向刚上传的 fullchain.pem。若使用负载均衡/CDN,还要在对应控制台上传证书,否则只改源站 Nginx 不会改变用户看到的证书。最后用 curl -I https://example.com 做一次快速冒烟测试。

配置示例:HTTPS 站点、HTTP 跳转与 TLS 参数

以下配置适用于 Nginx 1.25.1 及以上;旧版本把 http2 on; 改回 listen 443 ssl http2;。HSTS 仅在确认全站 HTTPS 后启用,避免回滚困难。

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    http2 on;
    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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
    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/example.com_chain.pem;
    resolver 1.1.1.1 8.8.8.8 valid=300s;
    add_header Strict-Transport-Security 'max-age=31536000' always;
    location / {
        root /var/www/html;
        index index.html;
    }
}

关键点:ssl_certificate 必须指向 fullchain,不能只写叶子证书;ssl_certificate_key 权限建议 600;TLSv1.2/TLSv1.3 已覆盖主流客户端,不要启用 TLSv1.0/1.1。ssl_ciphers 只影响 TLSv1.2,TLSv1.3 套件由 OpenSSL 管理。启用 OCSP Stapling 时 ssl_trusted_certificate 要指向中间证书链;没有 chain.pem 可先删除 stapling 两行,否则日志会出现 ssl_stapling ignored。若使用 ECDSA 证书,确认私钥类型与证书一致。配置多个域名时,server_name 与证书 SAN 必须匹配,否则客户端会报 hostname mismatch。

对比表格:Sectigo DV/OV/EV、通配符与 Let’s Encrypt

Sectigo 与 Let’s Encrypt 都受 CA/Browser Forum 有效期规则约束:2026-03-15 起公共 TLS 证书上限 200 天,旧规为 398 天;Let’s Encrypt 为 90 天。下表用于选型,价格与保障条款以购买页为准。

方案 验证与签发 有效期 适用场景
Sectigo DV 域名控制验证,分钟级 最长 200 天(旧规 398 天) 博客、测试、内部工具
Sectigo OV 企业资料审核,约 1-3 个工作日 最长 200 天(旧规 398 天) 企业官网、SaaS 登录
Sectigo EV 扩展验证,约 3-5 个工作日,保障金最高约 50 万美元 最长 200 天(旧规 398 天) 金融、电商、支付回调
Sectigo 通配符/多域名 DV 或 OV,SAN 扩展 最长 200 天(旧规 398 天) 多子域、多品牌站点
Let’s Encrypt ACME 自动验证,免费 90 天 自动化运维、容器集群

注意:现代浏览器已取消 EV 证书的绿色地址栏,EV 的价值主要在组织身份展示、合规采购和更高保障条款,不应宣传为“浏览器变绿”。通配符证书只覆盖同一级子域,例如 *.example.com 不覆盖 a.b.example.com;多域名证书要把所有 SAN 写全。Let’s Encrypt 90 天有效期适合 certbot 自动续期,Sectigo 证书则要建立到期提醒,至少在到期前 30 天续期并重新部署 fullchain。若站点同时有 RSA 与 ECDSA 证书,可在 Nginx 中配置双证书,但需确保两张证书的 SAN 一致。

常见错误排查:真实报错与定位命令

先跑 sudo nginx -t,再看 error.log。以下是部署 Sectigo 证书时最常见的问题:

  • nginx: [emerg] cannot load certificate … No such file or directory:路径错误或文件未上传。执行 nginx -T | grep ssl_certificate 核对绝对路径,检查 ls -l /etc/nginx/ssl。
  • nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed … key values mismatch:证书与私钥不匹配。执行 openssl x509 -noout -pubkey -in fullchain.pem | openssl sha256 与 openssl pkey -pubout -in example.com.key | openssl sha256,两行哈希必须一致;RSA 旧方法可用 modulus 比对。
  • curl: (60) SSL certificate problem: unable to get local issuer certificate 或 Java 报 PKIX path building failed:证书链不完整。用 openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep -c ‘BEGIN CERTIFICATE’,结果应大于等于 2;把 ssl_certificate 改为 fullchain。
  • nginx: [warn] ssl_stapling ignored, issuer certificate not found:缺少中间证书或 ssl_trusted_certificate 路径错误;补 chain.pem 或暂时关闭 stapling。
  • nginx: [emerg] PEM_read_bio_X509_AUX(…) failed … no start line:文件不是 PEM,可能误传 PFX/DER。执行 file 与 head -1 检查是否以 —–BEGIN CERTIFICATE—– 开头,必要时用 openssl x509 -in cert.cer -out cert.pem 转换。

续期后仍旧证书:先看 openssl x509 -in fullchain.pem -noout -dates 是否为新日期,再执行 systemctl reload nginx;若前面有 CDN/负载均衡,需同步更新证书。浏览器正常但小程序报 hand shake error,优先查链和 TLS 版本,不要先怀疑域名解析。

效果验证:从本机 curl 到 SSL Labs 评级

先验证证书链和主机名:

curl -sI https://example.com
curl -v https://example.com 2>&1 | grep -E 'SSL certificate verify|subject:|issuer:'
openssl s_client -connect example.com:443 -servername example.com /dev/null | grep 'Verify return code'

期望输出 Verify return code: 0 (ok)。再验证协议版本与证书有效期:

openssl s_client -connect example.com:443 -servername example.com -tls1_3 /dev/null | grep 'Protocol'
openssl s_client -connect example.com:443 -servername example.com -tls1_2 /dev/null | grep 'Protocol'
openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -enddate
curl -sI https://example.com | grep -i strict-transport-security

如果 curl 报证书错误,用 -CAfile /etc/ssl/certs/ca-certificates.crt 指定系统信任库再测;Java 客户端需确认 JDK 信任库包含对应根证书。自动化检查可用 testssl.sh –fast https://example.com,或把站点提交 SSL Labs,目标为 A/A+;A+ 通常需要 HSTS 且无已知漏洞。最后做一次 HTTP 跳转检查:curl -I http://example.com 应返回 301 且 Location 为 https://example.com/。监控层面建议每天检查证书剩余天数,低于 30 天告警,避免有效期到期导致业务中断。

常见问题

是。fullchain.pem 包含站点证书和中间证书,Nginx 的 ssl_certificate 应指向它;只放叶子证书会让 curl、Java、小程序因链不完整报错。根证书通常不需要放入,除非客户端信任库缺失。

公共信任 TLS 证书有效期已从 398 天降至 200 天(2026-03-15 起),2027 年起将降至 100 天;Let’s Encrypt 为 90 天。建议到期前 30 天续期并重新部署 fullchain,不要等最后一天。

说明证书与私钥不匹配。分别执行 openssl x509 -noout -pubkey -in fullchain.pem | openssl sha256 和 openssl pkey -pubout -in example.com.key | openssl sha256,哈希必须一致;不一致就重新下载匹配的私钥或重新签发。

优先检查证书链是否完整:用 openssl s_client -showcerts 确认至少两张证书,并把 ssl_certificate 改成 fullchain。若链已完整,再检查 Java 信任库是否包含根证书,或服务端是否只支持了客户端不支持的 TLS 版本。

Nginx 1.25.1 起该写法已弃用,建议改为 listen 443 ssl; 并单独写 http2 on;。旧版本仍可用原写法,但升级后会出现警告;改完先 nginx -t,再 systemctl reload nginx。

先执行 openssl x509 -in fullchain.pem -noout -dates 确认文件已是新证书,再 nginx -T | grep ssl_certificate 核对路径,最后 systemctl reload nginx。若前面有 CDN 或负载均衡,必须在对应平台同步更新证书。

内容审核

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