跳到主要内容
Nginx

DigiCert SSL 证书 Nginx 安装部署教程:fullchain、TLS 1.3 与排错实战

问题背景与根因

DigiCert 是商业 CA,证书通过 CertCentral 下发。Nginx 部署失败通常不是证书本身问题,而是 PEM 文件组织、证书链和私钥匹配。常见根因:1)ssl_certificate 只填叶子证书,缺中间证书,浏览器可能正常,但 curl、Java、小程序报 unable to get local issuer certificate;2)私钥与证书不匹配,nginx -t 报 key values mismatch;3)证书有效期理解错误:公开信任 TLS 证书最长 398 天,Let’s Encrypt 为 90 天,DigiCert 商业证书按产品签发但受 398 天上限约束,2026 年 3 月起逐步缩短至 200 天、100 天、47 天,必须自动化续期;4)Nginx 版本差异:1.25.1 起用 http2 on,旧版用 listen 443 ssl http2;5)多域名或 SNI 未配 server_name,证书 SAN 不覆盖访问域名;6)文件权限过宽、路径写错;7)续期后未 reload,或 CDN、负载均衡层未更新。DigiCert 下载包通常为 Nginx/PEM 格式,含 fullchain.pem 与 .key;若只有 .crt 和 DigiCertCA.crt,需要手动合并。不要直接把 .p7b、.pfx 交给 Nginx。

准备证书文件与权限

从 CertCentral 下载 Nginx/PEM 包,解压后确认 fullchain.pem 和 example.com.key。若包内是叶子证书与中间 CA 分离文件,执行以下命令合并并收紧权限:

mkdir -p /etc/nginx/ssl/example.com
chmod 700 /etc/nginx/ssl/example.com
cd /etc/nginx/ssl/example.com
cat example.com.crt DigiCertCA.crt > fullchain.pem
chmod 600 fullchain.pem example.com.key
chown root:root fullchain.pem example.com.key
grep -c 'BEGIN CERTIFICATE' fullchain.pem
openssl x509 -in fullchain.pem -noout -subject -issuer -dates
openssl pkey -in example.com.key -noout -check

grep -c 应返回 2 或 3;返回 1 说明链不完整。RSA 证书匹配:openssl x509 -in fullchain.pem -noout -modulus | openssl md5;openssl rsa -in example.com.key -noout -modulus | openssl md5,两个 MD5 必须一致。ECDSA 证书用:openssl x509 -in fullchain.pem -noout -pubkey | openssl md5;openssl pkey -in example.com.key -pubout | openssl md5。检查 SAN 是否覆盖 www:openssl x509 -in fullchain.pem -noout -text | grep -A1 ‘Subject Alternative Name’。私钥不要放在 Web 根目录,权限 600,属主 root。容器部署时挂载为只读。CertCentral 包内若含 chain.pem,保留给 OCSP stapling 使用。

Nginx 配置示例

以下配置同时处理 HTTP 跳转、TLS 1.2/1.3、会话缓存与 OCSP stapling。Nginx 1.25.1 及以上用 http2 on;旧版改为 listen 443 ssl http2,二者不要重复写,否则报 duplicate parameter。

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/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 223.5.5.5 8.8.8.8 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
location / {
root /var/www/example.com;
index index.html;
}
}

改完先执行 nginx -t && nginx -s reload。ssl_certificate 必须指向 fullchain.pem;ssl_trusted_certificate 填中间 CA 链 chain.pem,不要填 fullchain,否则 OCSP stapling 可能失败。HSTS 首次上线建议先用 max-age=300 观察,再逐步调大。TLS 1.3 的套件由 OpenSSL 控制,无需在 ssl_ciphers 中列出。

证书链与私钥匹配校验

部署前先确认 fullchain 顺序:叶子证书在前,中间证书在后。执行 openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout,输出中第一个 subject 应为 example.com,后续为 DigiCert 中间 CA。若顺序反了,部分客户端会握手失败。验证链完整性可用:openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem leaf.pem,其中 leaf.pem 为单独叶子证书。私钥匹配复核:RSA 用 openssl x509 -in fullchain.pem -noout -modulus | openssl md5 与 openssl rsa -in example.com.key -noout -modulus | openssl md5 对比;ECDSA 用 openssl x509 -in fullchain.pem -noout -pubkey | openssl md5 与 openssl pkey -in example.com.key -pubout | openssl md5 对比。两个哈希不一致时,nginx -t 会报 key values mismatch。还要检查 notAfter:openssl x509 -in fullchain.pem -noout -enddate,避免上传旧证书。

DigiCert 与其他 CA 及部署方式对比

CA/方案 验证类型 最长有效期 完整链下载 API/批量 价格档位 适用场景
DigiCert OV/EV 398 天 是 CertCentral API 高 银行、证券、大型电商
Let’s Encrypt DV 90 天 是 ACME 免费 自动化站点、测试环境
Sectigo DV/OV/EV 398 天 是 REST API 中 中小企业、多域名
GlobalSign OV/EV 398 天 是 API 中高 企业官网、跨境业务
自签证书 内部 自定义 手动 无 免费 内网、开发测试

DigiCert 的优势在 EV 审核、CertCentral 批量管理和商业支持,价格较高;Let’s Encrypt 适合 ACME 自动化,但有效期仅 90 天;Sectigo、GlobalSign 属于中端选择。注意 CA/B Forum 已通过证书有效期缩短计划:2026 年 3 月起 200 天,2027 年 100 天,2029 年 47 天,所有公开信任 CA 都受影响。无论选哪家,都应把续期、部署、reload 做成流水线,而不是手工上传。

常见错误排查

报错 1:nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:0A080006:SSL routines::EVP_PKEY_CTX_ctrl():key values mismatch)。修复:用上一节 modulus 或 pubkey 命令比对证书与私钥,重新从 CertCentral 下载匹配的 .key。

报错 2:curl: (60) SSL certificate problem: unable to get local issuer certificate;Java 报 javax.net.ssl.SSLHandshakeException: PKIX path building failed。修复:ssl_certificate 改为 fullchain.pem,grep -c ‘BEGIN CERTIFICATE’ 应大于 1,再用 openssl s_client -showcerts 确认服务端发送了中间证书。

报错 3:nginx: [emerg] cannot load certificate PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line)。修复:file fullchain.pem 检查是否为 PEM 文本,确认文件以 —–BEGIN CERTIFICATE—– 开头,路径无拼写错误。

报错 4:浏览器正常但小程序、Android 报证书链错误。修复:检查 fullchain 是否包含 DigiCert Global Root G2 对应的中间 CA,必要时用 openssl s_client -connect example.com:443 -servername example.com -showcerts 对比本地链。

报错 5:续期后仍返回旧证书。修复:nginx -s reload;确认配置指向新文件;用 openssl s_client 查看 notAfter;若前面有 CDN、SLB,逐层更新证书。

报错 6:SSL: error:0A00018E:SSL routines::ca md too weak。修复:旧 SHA-1 中间证书导致,更新为 DigiCert 新链并重启 Nginx。

效果验证

先验证链:echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep ‘Verify return code’,应为 0 (ok)。查看证书信息:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates。检查 TLS 1.3:openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null 2>/dev/null | grep ‘Protocol’。curl 验证:curl -vI https://example.com 2>&1 | grep -E ‘SSL certificate verify|subject:|issuer:’。HSTS:curl -sI https://example.com | grep -i strict-transport-security。SSL Labs 评级:curl -s ‘https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off&all=done’ | jq ‘.status,.endpoints[0].grade’,目标 A 或 A+。到期监控脚本:end=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2); echo $end; 再用 date -d “$end” +%s 与 date +%s 计算剩余天数,低于 30 天告警。

常见问题

必须配置 fullchain.pem,即叶子证书加中间证书。只配叶子证书时浏览器可能正常,但 curl、Java、小程序会严格校验证书链并报 unable to get local issuer certificate。ssl_certificate 指向 fullchain,ssl_certificate_key 指向私钥,OCSP stapling 的 ssl_trusted_certificate 用中间证书链。

RSA 证书执行 openssl x509 -in fullchain.pem -noout -modulus | openssl md5 和 openssl rsa -in example.com.key -noout -modulus | openssl md5,两个 MD5 必须一致;ECDSA 证书比较 pubkey 的 MD5。不一致时 nginx -t 会报 key values mismatch,需重新下载匹配私钥。

公开信任 TLS 证书当前最长 398 天,DigiCert 商业证书按产品签发但受该上限约束;Let’s Encrypt 为 90 天。2026 年 3 月起逐步缩短至 200 天、100 天、47 天,建议用 CertCentral API 或 ACME 自动化续期并自动 reload Nginx。

通常是服务端只发送了叶子证书,缺少中间证书,或客户端不信任所用根证书。将 ssl_certificate 改为 fullchain.pem,确保链中包含 DigiCert 中间 CA;用 openssl s_client -showcerts 检查服务端实际发送的证书数量。

先执行 nginx -t 和 nginx -s reload,确认配置路径指向新 fullchain;再用 openssl s_client 查看 notAfter。若前面有 CDN、负载均衡或容器镜像,需要逐层更新证书并重启对应进程,不能只更新源站。

不是必须,但推荐开启。Nginx 需配置 ssl_stapling on、ssl_stapling_verify on,ssl_trusted_certificate 指向中间 CA 链,并保证服务器能访问 OCSP 响应器。网络受限或解析失败时可先关闭,不影响证书基本校验。

内容审核

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