Sectigo SSL 证书 Nginx 安装部署教程:证书链、TLS 1.3 与排错实战
1. 问题背景与根因:为什么证书装了还会报链错误
Sectigo(原 Comodo CA)的 DV 证书通常分钟级签发,OV 约 1-3 个工作日,EV 约 3-5 个工作日;部分产品保障金最高约 50 万美元。公开信任 TLS 证书单次有效期已从 398 天收紧:2026 年 3 月 15 日起上限 200 天,2027 年 3 月 15 日起 100 天,2029 年 3 月 15 日起 47 天;Let’s Encrypt 仍为 90 天。Nginx 部署最常见的故障不是证书没签发,而是只配置了叶子证书,没有把中间证书合并进 fullchain.pem。浏览器可能通过 AIA 自动补链,所以“浏览器正常”;但 curl、Java、微信小程序、部分 SDK 不会自动下载中间证书,于是报 curl: (60) SSL certificate problem: unable to get local issuer certificate 或 PKIX path building failed。根因有三类:链不完整、证书与私钥不匹配、SNI/端口/旧 TLS 协议不匹配。Nginx 的 ssl_certificate 只发送你给它的证书,不会自动把同目录的中间证书拼上去。先用 openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep 'Verify return code' 看是否为 0 (ok),再用 -showcerts 数 BEGIN CERTIFICATE,正常应至少 2 张。
2. 准备证书文件:从 Sectigo 控制台到 PEM 的完整命令
Sectigo 控制台下载时选 Nginx/PEM 包,常见文件为 example.com.crt(叶子证书)、example.com.ca-bundle(中间证书)和 example.com.key(私钥)。Nginx 需要 PEM 格式,私钥不能带口令,否则 reload 会交互失败。操作如下:
sudo install -d -m 700 /etc/nginx/ssl
sudo unzip ~/sectigo_nginx_pem.zip -d /tmp/sectigo
ls -l /tmp/sectigo
cat /tmp/sectigo/example.com.crt /tmp/sectigo/example.com.ca-bundle > /tmp/sectigo/example.com_fullchain.pem
openssl crl2pkcs7 -nocrl -certfile /tmp/sectigo/example.com_fullchain.pem | openssl pkcs7 -print_certs -noout
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted /tmp/sectigo/example.com.ca-bundle /tmp/sectigo/example.com.crt
sudo cp /tmp/sectigo/example.com_fullchain.pem /etc/nginx/ssl/
sudo cp /tmp/sectigo/example.com.key /etc/nginx/ssl/
sudo chmod 644 /etc/nginx/ssl/example.com_fullchain.pem
sudo chmod 600 /etc/nginx/ssl/example.com.key
合并顺序必须是叶子证书在前、中间证书在后,根证书不要放进 fullchain。若压缩包已带 fullchain.pem,可直接使用,但仍要执行 openssl verify 确认输出 OK。再核对私钥:
openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -pubkey | openssl pkey -pubin -outform der | openssl sha256
sudo openssl pkey -in /etc/nginx/ssl/example.com.key -pubout -outform der | openssl sha256
openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
两条 SHA-256 必须一致;RSA 证书也可用 openssl x509 -noout -modulus | openssl md5 与 openssl rsa -noout -modulus | openssl md5 比对。SAN 必须包含实际访问域名,通配符证书只匹配一级子域。
3. 完整实操步骤:目录、权限、语法检查与平滑重载
文件就位后不要直接 restart。先确认 Nginx 版本,因为 1.25.1 起 listen 443 ssl http2; 中的 http2 参数被废弃,应改为 listen 443 ssl; 加 http2 on;。执行 nginx -v 查看版本。将配置放到 /etc/nginx/conf.d/example.com.conf,然后按顺序执行:
sudo nginx -t
sudo systemctl reload nginx
sudo systemctl status nginx --no-pager
sudo ss -ltnp | grep ':443'
curl -I https://example.com
curl -I --http2 https://example.com
nginx -t 必须看到 syntax is ok 和 test is successful 才能 reload;reload 不会断开现有连接,restart 会。若报 nginx: [emerg] cannot load certificate ... BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory),用 namei -l /etc/nginx/ssl/example.com_fullchain.pem 检查每一级目录权限,确保 Nginx master 进程可读。SELinux 环境还要看 sudo ausearch -m avc -ts recent,必要时给证书目录打 httpd_sys_content_t 标签。最后确认 80 端口只做 301 跳转,不要同时暴露 HTTP 明文业务。
4. 配置示例:TLS 1.2/1.3、HTTP/2 与完整证书链
以下配置适用于 Nginx 1.25.1 及以上;旧版本把 http2 on; 删掉,并把 listen 443 ssl; 改为 listen 443 ssl http2;。证书路径按实际域名替换。
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: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;
add_header Strict-Transport-Security max-age=31536000;
add_header X-Content-Type-Options nosniff;
location / {
root /var/www/example.com;
index index.html;
}
}
ssl_ciphers 只控制 TLS 1.2 及以下;TLS 1.3 的套件由 OpenSSL 默认策略管理,不要再用旧教程里的 ssl_ciphers HIGH:!aNULL:!MD5 覆盖。若开启 OCSP stapling,需额外配置 ssl_trusted_certificate /etc/nginx/ssl/example.com_chain.pem; 与 resolver 1.1.1.1 8.8.8.8 valid=300s;,否则可能报 nginx: [warn] "ssl_stapling" ignored, issuer certificate not found。生产环境先不要加 includeSubDomains 和 preload,确认所有子域都上 HTTPS 后再加。
5. 对比表格:Sectigo 证书类型与 Nginx 文件用途
Sectigo 的 DV 适合博客、测试环境、API 网关;OV 需要企业资料核验,适合企业官网和电商;EV 核验更严,但现代浏览器已不再普遍展示绿色企业名称,是否选择应看合规要求而非“地址栏变绿”。公开信任证书有效期已进入 200 天阶段(2026-03-15 起),2027-03-15 起 100 天,2029-03-15 起 47 天;OV/EV 续期还要重新核验企业信息。
| 类型 | 验证内容 | 典型签发时间 | 适用场景 |
|---|---|---|---|
| DV | 域名控制权 | 分钟级 | 博客、测试、API、内部工具 |
| OV | 域名+企业资料 | 1-3 个工作日 | 企业官网、电商、SaaS |
| EV | 严格企业核验 | 3-5 个工作日 | 金融、高信任/合规场景 |
部署文件也别混淆:
| 文件 | 内容 | Nginx 指令 | 误用后果 |
|---|---|---|---|
| fullchain.pem | 叶子证书+中间证书 | ssl_certificate | 正确做法 |
| example.com.crt | 仅叶子证书 | 不要单独用于 ssl_certificate | curl/Java 报 unable to get local issuer certificate |
| example.com.key | 私钥 | ssl_certificate_key | 与证书不匹配时报 key values mismatch |
| chain.pem | 仅中间证书 | ssl_trusted_certificate(OCSP) | 当作站点证书会握手异常 |
通配符证书 *.example.com 只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com;需要多域名时用 SAN 或 UCC 方案。
6. 常见错误排查:真实报错与修复命令
报错 1:nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。说明证书与私钥不是一对。用第 2 节的公钥 SHA-256 比对,重新从 Sectigo 控制台下载私钥,别把旧域名的 key 复制过来。
报错 2:curl: (60) SSL certificate problem: unable to get local issuer certificate 或 Java 报 PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target。九成是只配了叶子证书。把中间证书按顺序合并成 fullchain.pem,执行 openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted ca-bundle.crt example.com.crt 应为 OK。
报错 3:nginx: [emerg] cannot load certificate ... BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory)。路径写错或权限不足;用 namei -l 逐级检查,私钥 chmod 600,fullchain chmod 644,属主 root。
报错 4:nginx: [emerg] unknown directive "http2"。Nginx 低于 1.25.1 不认识 http2 on;,改回 listen 443 ssl http2;;反之新版本会提示 http2 参数废弃。
报错 5:nginx: [warn] "ssl_stapling" ignored, issuer certificate not found。补 ssl_trusted_certificate 指向中间证书链,或暂时关闭 ssl_stapling。续期后不生效则检查配置是否仍指向旧文件,执行 nginx -t && systemctl reload nginx,有 CDN 时同步更新边缘证书。
7. 效果验证:从握手到浏览器评级
先看服务端实际发送的链和验证结果:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep 'Verify return code'
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
curl -sI https://example.com | grep -i strict-transport-security
curl -I --http2 https://example.com
第一条应为 Verify return code: 0 (ok);第二条正常应大于等于 2,只有 1 说明没发中间证书;第三条核对 SAN 和到期时间。再验证协议版本:openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | grep 'Protocol' 与 -tls1_3 应分别显示 TLSv1.2、TLSv1.3。最后用 SSL Labs 输入域名,目标 A 或 A+;若出现 “Chain issues: Incomplete”,回到第 2 节补链。生产环境再加一条到期监控:echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate,剩余天数小于 30 天触发告警。
8. 续期与上线检查清单:避免“续了但没生效”
Sectigo 公开信任证书受 CA/B 论坛新规约束:2026-03-15 起单次有效期上限 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天;OV/EV 续期还需重新核验企业资料;Let’s Encrypt 为 90 天。建议到期前 30 天完成续签,并用版本目录+软链接原子切换:
sudo mkdir -p /etc/nginx/ssl/2026-05
sudo cp /tmp/sectigo/example.com_fullchain.pem /etc/nginx/ssl/2026-05/fullchain.pem
sudo cp /tmp/sectigo/example.com.key /etc/nginx/ssl/2026-05/example.com.key
sudo chmod 600 /etc/nginx/ssl/2026-05/example.com.key
sudo ln -sfn /etc/nginx/ssl/2026-05 /etc/nginx/ssl/current
sudo nginx -t && sudo systemctl reload nginx
配置里统一写 /etc/nginx/ssl/current/fullchain.pem 与 /etc/nginx/ssl/current/example.com.key。切换后必须重新执行 openssl s_client 看线上证书序列号和到期时间,不能只看本地文件。回滚只需把软链接指回旧目录再 reload。检查清单:nginx -t 通过、443 监听正常、80 跳转 301、fullchain 至少 2 张证书、私钥权限 600、HSTS 按需开启、监控剩余天数、CDN/负载均衡证书同步更新。若使用 Sectigo ACME 或经销商 API,可把下载、校验、reload 写成脚本;否则用日历+监控双保险。
常见问题
应配置 fullchain.pem,即叶子证书+中间证书的完整链;私钥单独写在 ssl_certificate_key。只配叶子证书时,浏览器可能正常,但 curl、Java、小程序常报 unable to get local issuer certificate。
受 CA/B 论坛新规限制,公开信任 TLS 证书有效期已从 398 天降至 200 天(2026-03-15 起),2027 年起 100 天、2029 年起 47 天;Let’s Encrypt 为 90 天。建议到期前 30 天续签并核对线上到期时间。
先看服务端是否只发了一张证书。把站点证书与中间证书按“叶子在前、中间在后”合并为 fullchain.pem,openssl verify 输出 OK 后 reload,再用 openssl s_client 确认 Verify return code 为 0 (ok)。
这是证书与私钥不匹配。分别计算证书公钥和私钥公钥的 SHA-256 哈希,结果必须一致;RSA 也可比对 modulus 的 MD5。续期后要确认 Nginx 指向新私钥,避免新旧文件混用。
Nginx 1.25.1 及以上用 listen 443 ssl; 加 http2 on;;旧版本不认 http2 on;,会报 unknown directive,应继续用 listen 443 ssl http2;。升级后记得删掉旧参数,否则有废弃警告。
先执行 openssl x509 -enddate 看线上证书,再确认 Nginx 配置路径指向新 fullchain,nginx -t 通过后 systemctl reload nginx。若前面有 CDN 或负载均衡,还要在边缘节点更新证书,否则源站更新不会生效。