跳到主要内容
Nginx

DigiCert SSL 证书 Nginx 安装部署实战:PEM 证书链、TLS 1.3 与排错验证

DigiCert 是商业 CA,CertCentral 支持 API、批量管理与 EV 审核,银行、证券、大型电商常选。本文围绕 DigiCert 签发的 SSL 证书在 Nginx 上的安装部署,覆盖证书文件准备、配置、校验、排错与效果验证。注意:公共 TLS 证书单张有效期已从 398 天缩短,2026-03-15 起最长 200 天;Let’s Encrypt 仍为 90 天。无论用哪家 CA,Nginx 的 ssl_certificate 都应指向包含站点证书和中间证书的 fullchain PEM,而不是只放叶子证书。

问题背景与根因:为什么 DigiCert 证书在 Nginx 上会“浏览器正常、程序报错”

很多部署事故不是证书没签发,而是证书链、私钥或 reload 环节出错。Nginx 的 ssl_certificate 只配置叶子证书时,浏览器可能凭缓存或 AIA 补链成功,但 curl、Java、微信小程序、Python requests 等严格校验客户端会报 curl: (60) SSL certificate problem: unable to get local issuer certificate,Java 常见 PKIX path building failed。根因通常有四类:一是 CertCentral 下载了单张证书而非 Nginx/PEM 包,缺少 DigiCert 中间证书;二是私钥与证书不匹配,reload 时报 SSL_CTX_use_PrivateKey: key values mismatch;三是配置文件未被实际 server 块加载,SNI 命中了旧站点;四是续期后只替换文件未执行 nginx -t 和 systemctl reload nginx,进程仍持有旧证书。另一个常见误区是只开 TLSv1.0/1.1,现代客户端已逐步拒绝;生产建议至少启用 TLSv1.2 与 TLSv1.3,并保留 80 端口 301 跳转。DigiCert 公共可信证书当前按 CA/B Forum 规则执行 200 天上限,运维必须把续期和 reload 纳入自动化,而不是等浏览器告警再处理。

准备 DigiCert PEM 证书文件与目录权限

在 CertCentral 下载“Nginx / PEM”格式包,通常会得到站点证书、中间证书和私钥。若压缩包已提供 fullchain,可直接使用;若只有 example.com.crt 与 DigiCertCA.crt,需按“站点证书在前、中间证书在后”合并。建议统一放到 /etc/nginx/ssl,私钥权限 600,证书 644,属主 root。命令如下:

sudo mkdir -p /etc/nginx/ssl
cat example.com.crt DigiCertCA.crt > example.com_fullchain.pem
sudo install -m 644 example.com_fullchain.pem /etc/nginx/ssl/example.com_fullchain.pem
sudo install -m 600 example.com.key /etc/nginx/ssl/example.com.key
sudo chown root:root /etc/nginx/ssl/example.com_fullchain.pem /etc/nginx/ssl/example.com.key
ls -l /etc/nginx/ssl/

随后做三项硬校验:证书主题与有效期、链中证书数量、私钥可用性。grep -c 'BEGIN CERTIFICATE' 结果应大于等于 2;如果等于 1,说明只有叶子证书,必须补中间证书。私钥用 openssl pkey -check 检查。RHEL/CentOS 开启 SELinux 时,还要让 Nginx 能读该目录:sudo restorecon -Rv /etc/nginx/ssl,否则会出现 BIO_new_file() failed。不要把私钥放 Web 根目录,也不要使用 644 权限;Nginx master 进程以 root 启动并加载证书,worker 继承句柄,600 权限通常不影响 reload。

openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -subject -issuer -dates
grep -c 'BEGIN CERTIFICATE' /etc/nginx/ssl/example.com_fullchain.pem
openssl pkey -in /etc/nginx/ssl/example.com.key -check -noout
openssl crl2pkcs7 -nocrl -certfile /etc/nginx/ssl/example.com_fullchain.pem | openssl pkcs7 -print_certs -noout

完整实操步骤:上传、校验、nginx -t 与平滑 reload

推荐先在本地或跳板机完成文件命名,再上传到服务器临时目录,避免直接覆盖线上文件。执行顺序必须是:备份配置、上传新文件、替换证书、nginx -t 语法与证书加载校验、最后 systemctl reload nginx。reload 是平滑重载,master 重新读取证书并启动新 worker,旧连接不会立即断开;只有 reload 失败或模块异常时才考虑 restart。上传与替换命令示例:

scp example.com_fullchain.pem example.com.key root@server:/tmp/
ssh root@server
sudo cp -a /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak.$(date +%F)
sudo install -m 644 /tmp/example.com_fullchain.pem /etc/nginx/ssl/example.com_fullchain.pem
sudo install -m 600 /tmp/example.com.key /etc/nginx/ssl/example.com.key
sudo nginx -t
sudo systemctl reload nginx
sudo systemctl status nginx --no-pager

如果 nginx -t 失败,不要继续 reload。先看完整报错,再检查 nginx -V 是否带 --with-http_ssl_module,以及 443 是否被其他进程占用:ss -lntp | grep ':443'。若 reload 后仍是旧证书,用 nginx -T | grep -n 'ssl_certificate' 确认实际加载的配置块,检查是否有 include 顺序、默认 server、SNI 多站点覆盖。生产变更建议在低峰执行,并保留回滚文件;替换后立即用 openssl 验证证书序列号和到期时间,而不是只看浏览器锁标。

sudo nginx -T | grep -n 'ssl_certificate'
sudo journalctl -u nginx -n 50 --no-pager
ss -lntp | grep ':443'

Nginx 配置示例:TLS 1.2/1.3、OCSP Stapling、HSTS 与 80 跳转

下面配置适用于 Nginx 1.25.1 及以上版本,使用 http2 on;;旧版本可改为 listen 443 ssl http2;。ssl_certificate 必须指向 fullchain,ssl_trusted_certificate 指向中间证书链,用于 OCSP Stapling 验证。TLS 只保留 1.2 与 1.3,关闭 session tickets,开启共享会话缓存。HSTS 建议在 HTTPS 稳定运行后再加,先短 max-age 灰度,避免子域未全 HTTPS 时锁死。80 端口统一 301 到 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_trusted_certificate /etc/nginx/ssl/example.com_chain.pem;
    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;
    resolver 223.5.5.5 119.29.29.29 valid=300s;
    resolver_timeout 5s;
    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    location / { root /var/www/html; index index.html; }
}

若没有单独的 chain 文件,可让 ssl_trusted_certificate 也指向 fullchain;但不要指向私钥。OCSP Stapling 出现 ssl_stapling ignored, issuer certificate not found 时,优先检查 trusted 文件是否含中间证书与 resolver 是否可达。修改后仍按 sudo nginx -t && sudo systemctl reload nginx 执行,不要直接 restart 掩盖配置问题。

证书链、密钥匹配与有效期对比表

部署时最容易混淆三个文件:站点证书、fullchain、私钥。下表可直接作为交付检查清单。DigiCert 与 Let’s Encrypt 在 Nginx 文件结构上相同,但有效期和管理方式不同;公共 TLS 证书已不是 398 天长期有效,2026-03-15 起 DigiCert 公共可信证书单张最长 200 天,Let’s Encrypt 为 90 天,二者都应提前 30 天续期。

文件/项目 内容 Nginx 指令 常见错误
example.com.crt 仅站点叶子证书 不单独用于 ssl_certificate curl 报 unable to get local issuer certificate
example.com_fullchain.pem 叶子证书+中间证书 ssl_certificate 链不完整时 Java 报 PKIX path building failed
example.com.key 私钥 ssl_certificate_key key values mismatch
example.com_chain.pem 中间证书链 ssl_trusted_certificate OCSP Stapling 警告 issuer certificate not found
对比项 DigiCert 公共 TLS Let’s Encrypt
单张有效期 2026-03-15 起最长 200 天,此前 398 天 90 天
管理方式 CertCentral、API、批量管理 ACME 客户端自动签发
Nginx 文件 fullchain.pem + key fullchain.pem + key
续期策略 API 拉取并 reload,提前 30 天 certbot renew –deploy-hook 自动 reload

密钥匹配不要只比文件大小,使用公钥摘要比对,RSA 与 ECDSA 都适用:

openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in /etc/nginx/ssl/example.com.key -pubout | openssl md5

常见错误排查(含真实报错)

排错时先看 nginx -t 和 journalctl -u nginx,再用 openssl 从客户端视角验证。以下报错在 DigiCert 证书部署中高频出现:nginx: [emerg] cannot load certificate ... BIO_new_file() failed 多为路径错误、权限不足或 SELinux 拒绝,执行 namei -l /etc/nginx/ssl/example.com_fullchain.pem 与 restorecon -Rv /etc/nginx/ssl;SSL_CTX_use_PrivateKey: key values mismatch 表示证书与私钥不配对,用上面的公钥摘要命令核对;curl: (60) SSL certificate problem: unable to get local issuer certificate 与 Verify return code: 21 (unable to verify the first certificate) 表示只发了叶子证书,必须改用 fullchain;Java 报 PKIX path building failed 同理。OCSP 警告 nginx: [warn] ssl_stapling ignored, issuer certificate not found 需配置 ssl_trusted_certificate 与可达 resolver。旧版本 Nginx 报 unknown directive http2 时,改用 listen 443 ssl http2;。若报 no ssl_certificate is defined,检查指令是否写在 server 块内、include 是否被加载。

sudo nginx -t
sudo journalctl -u nginx -n 80 --no-pager
namei -l /etc/nginx/ssl/example.com_fullchain.pem
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

效果验证:openssl、curl、SSL Labs 与 OCSP 状态检查

验证要覆盖证书链、协议版本、主机名和 OCSP。先用 openssl 查看服务端实际下发的证书主题、签发者与有效期,并检查 Verify return code 是否为 0。再用 curl 分别测试 TLSv1.2 可用、TLSv1.1 被拒绝;最后用 SSL Labs 或内部扫描确认评级与 HSTS。OCSP Stapling 可看到 OCSP Response Status: successful,若为 tryLater 或没有响应,检查 resolver、防火墙出站和 trusted 证书链。

openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep 'Verify return code'
curl -I https://example.com
curl -I --tlsv1.2 https://example.com
curl -I --tls-max 1.1 https://example.com
echo | openssl s_client -connect example.com:443 -servername example.com -status 2>/dev/null | grep -A1 'OCSP Response Status'

预期结果:Verify return code 为 0 (ok);TLSv1.2 请求返回 200/301;TLSv1.1 请求失败;响应头含 Strict-Transport-Security;SSL Labs 证书链显示完整。若 curl 正常但 Java 仍失败,重点查中间证书顺序和客户端信任库,而不是重复换私钥。

续期与自动化:200 天、90 天有效期下的运维要点

DigiCert 公共 TLS 证书当前单张最长 200 天,Let’s Encrypt 为 90 天,手工续期很容易遗漏。建议在到期前 30 天触发续期,使用 CertCentral API 拉取新 PEM 包,或对 Let’s Encrypt 使用 certbot renew --deploy-hook 'systemctl reload nginx'。部署时采用“新目录+软链”方式,先写入新版本文件,校验通过后再原子切换软链,最后 reload。关键检查命令是 openssl x509 -checkend 2592000,返回非 0 表示 30 天内到期。不要把新证书直接覆盖正在使用的文件后不 reload;Nginx master 不会自动感知文件变化。

openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/example.com_fullchain.pem || echo '30天内到期'
sudo nginx -t && sudo systemctl reload nginx
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates

自动化脚本要记录证书序列号、到期时间、reload 退出码,并在失败时告警。多域名站点逐个检查 SNI,避免只更新默认站点。私钥仍保持 600,软链目录不要让 Nginx 读到旧版本;回滚时切回上一版本软链并再次 reload。

常见问题

填 fullchain。单张叶子证书缺少中间证书,浏览器可能正常,但 curl、Java、小程序常报 unable to get local issuer certificate 或 Verify return code 21。DigiCert 的 Nginx/PEM 包应把站点证书与中间证书按顺序合并后配置。

通常不会。Nginx master 以 root 启动并加载证书与私钥,worker 继承已打开的句柄;reload 时 master 重新读取。只要 nginx -t 通过且 SELinux 上下文正确即可。不要为了省事改成 644。

这是证书链不完整的典型表现。浏览器可能通过缓存或 AIA 补链成功,严格客户端不会。检查 ssl_certificate 是否指向 fullchain,链中证书数量是否大于等于 2,并用 openssl s_client 查看服务端实际下发链。

不是。公共 TLS 证书单张有效期已缩短,2026-03-15 起 DigiCert 公共可信证书最长 200 天,此前为 398 天;Let’s Encrypt 仍为 90 天。建议提前 30 天续期并自动 reload Nginx。

先确认是否执行了 systemctl reload nginx,再用 nginx -T | grep ssl_certificate 查看实际加载配置,检查 SNI、默认 server 和 include 顺序是否命中旧站点。最后用 openssl s_client 查看服务端证书序列号与日期。

内容审核

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