GeoTrust SSL 证书 Nginx 安装部署教程:证书链、398 天有效期与排错实战
问题背景与根因:GeoTrust 证书在 Nginx 上为什么容易部署失败
GeoTrust 现属 DigiCert 旗下,GeoTrust OV 走中端价格,通常比 DigiCert 主品牌低约 40%,审核稳定,适合需要组织验证但预算有限的企业。证书本身由公共信任链签发,Nginx 部署失败多数不是“证书不被信任”,而是文件形态、证书链顺序、私钥匹配、协议参数或续期规则处理错误。Nginx 的 ssl_certificate 需要 PEM 格式的站点证书加中间证书,通常合并为 fullchain.pem;只配置叶子证书会在浏览器中偶然正常,但 curl、Java、小程序、旧 Android 等严格校验客户端会报 unable to get local issuer certificate 或 PKIX path building failed。
第二个根因是有效期规则。公开信任 TLS 证书受浏览器与 CA/B 规则约束,当前最长有效期不超过 398 天;Let’s Encrypt 仍为 90 天。GeoTrust OV 即使购买多年期服务,实际签发到服务器上的 TLS 证书也不超过 398 天,必须按到期日续期并重新部署。把“购买年限”当成“单张证书有效期”是常见误判。第三个根因是 Nginx 版本差异:Nginx 1.25.1 起 listen 443 ssl http2 中的 http2 参数已废弃,应改为 listen 443 ssl; 与 http2 on;,否则 nginx -t 会给出 deprecated 警告。旧配置还常见 TLSv1.0/1.1 未禁用、ssl_certificate_key 指向加密私钥、目录权限导致 master 进程读不到文件。
先确认环境:
nginx -v
openssl version
nginx -T | grep -E 'ssl_certificate|ssl_protocols|http2'
如果输出中 ssl_certificate 指向 example.com.crt 而不是 fullchain,或者只出现一张证书,就应优先修正证书链。证书链检查可用 openssl s_client 看 Verify return code;返回 0 (ok) 才说明服务端发送的链能被当前信任库构建到根。若返回 21 (unable to verify the first certificate),基本是缺中间证书;返回 10 (certificate has expired) 则是续期或时间问题。把根因定位在“链、私钥、协议、有效期”四类,后续步骤才有意义。
准备 GeoTrust 证书文件与私钥
在 DigiCert/GeoTrust 控制台下载 Nginx/PEM 格式包,通常包含站点证书 example.com.crt、中间证书链 example.com.ca-bundle 或 chain.pem、私钥 example.com.key。若控制台只给一个 fullchain 包,也要确认其中证书顺序:第一张必须是站点叶子证书,后面是中间证书,根证书通常不放入 fullchain,因为客户端信任库已有根。可以用 grep 统计证书数量,用 openssl 查看第一张证书的 subject 与 SAN。
sudo install -d -m 700 /etc/nginx/ssl
sudo chown root:root /etc/nginx/ssl
sudo chmod 600 /etc/nginx/ssl/example.com.key
sudo chmod 644 /etc/nginx/ssl/example.com_fullchain.pem
cat example.com.crt chain.pem > example.com_fullchain.pem
grep -c 'BEGIN CERTIFICATE' example.com_fullchain.pem
openssl x509 -in example.com_fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
私钥必须是未加密的 PEM,Nginx 不能像 Apache 那样在启动时交互输入私钥口令;如果私钥带密码,先解密:openssl pkey -in example.com.key -out example.com.decrypted.key。然后校验证书与私钥是否匹配。原文常用 RSA modulus 比对,但 GeoTrust 也可能签发 ECC 证书,modulus 只适用于 RSA。通用做法是比较公钥 DER 的 MD5:
openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -pubkey | openssl pkey -pubin -outform DER | openssl md5
openssl pkey -in /etc/nginx/ssl/example.com.key -pubout -outform DER | openssl md5
两条命令输出必须一致。若不一致,说明证书与私钥不是同一次 CSR 生成,必须重新签发或找回原私钥。还要检查 SAN 是否包含 www 与裸域;只写 example.com 而访问 www.example.com 会报 certificate name mismatch。CSR 阶段生成的私钥应离线备份,续期时优先复用同一私钥可减少配置变更,但私钥泄露时必须重新生成 CSR。文件权限建议目录 700、私钥 600、fullchain 644;容器内非 root 运行 Nginx 时,可将私钥设为 640 并属组 nginx,但不要让私钥全局可读。
Nginx 完整配置示例与参数说明
以下配置以 example.com 为例,适用于 Nginx 1.25.1 及以上;旧版把 http2 on; 改为 listen 443 ssl http2;。关键是 ssl_certificate 指向 fullchain.pem,ssl_certificate_key 指向私钥,ssl_trusted_certificate 指向中间链 chain.pem 供 OCSP stapling 验证。TLS 只启用 1.2 与 1.3,禁用 1.0/1.1;会话缓存减少握手开销;HSTS 建议确认全站 HTTPS 后再加,且不要贸然加 includeSubDomains 与 preload。
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/chain.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
ssl_prefer_server_ciphers off;
ssl_ecdh_curve X25519:secp256r1;
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 1.1.1.1 valid=300s;
resolver_timeout 5s;
add_header Strict-Transport-Security 'max-age=31536000' always;
root /var/www/example.com;
index index.html;
location / {
try_files $uri $uri/ =404;
}
}
参数说明:ssl_certificate 只能出现叶子加中间链,不能只写叶子;ssl_certificate_key 必须是未加密私钥;ssl_trusted_certificate 不是给客户端发送的链,而是给 OCSP stapling 校验用,缺少它 stapling 可能不生效。ssl_ciphers 采用 ECDHE 前向保密套件,兼容现代浏览器;如需兼容很旧客户端,不要回退 TLSv1.0。多域名或多证书场景要在不同 server 块分别配置 ssl_certificate,并确保客户端支持 SNI。配置中 www 与裸域共用一张证书时,证书 SAN 必须同时包含两者,否则仍会域名不匹配。修改后不要直接 reload,先做语法与证书加载测试。
执行部署:校验、重载与回滚
修改配置后先执行 nginx -t。该命令会解析配置并尝试加载证书与私钥,能提前发现路径错误、PEM 格式错误、私钥不匹配。通过后再 systemctl reload nginx;reload 是优雅重载,不会中断已有连接。若 nginx -t 失败,不要 reload,直接按报错修复;生产环境建议先备份配置:cp /etc/nginx/conf.d/example.com.conf /etc/nginx/conf.d/example.com.conf.bak.$(date +%F-%H%M)。重载后确认监听与配置生效:ss -lntp | grep ‘:443’、nginx -T | grep -n ‘ssl_certificate’。nginx -T 输出的是实际加载的完整配置,能避免“改了文件但没加载”的误判。
sudo cp /etc/nginx/conf.d/example.com.conf /etc/nginx/conf.d/example.com.conf.bak.$(date +%F-%H%M)
sudo nginx -t
sudo systemctl reload nginx
sudo ss -lntp | grep ':443'
sudo nginx -T | grep -n -E 'ssl_certificate|ssl_protocols|http2'
权限与 SELinux 也要检查。Nginx master 通常以 root 启动并读取证书,worker 继承已打开的文件描述符,因此私钥 600 root:root 可行;若容器以非 root 运行,需让运行用户可读,常见做法是 chown root:nginx 与 chmod 640。SELinux 启用时,自定义目录可能被拒绝,日志会出现 permission denied,可用 getenforce 查看,并用 restorecon -Rv /etc/nginx/ssl 恢复上下文。防火墙需放行 443:firewall-cmd –permanent –add-service=https && firewall-cmd –reload。回滚策略是保留旧配置与旧证书文件,nginx -t 失败时恢复备份再 reload;不要用 restart 代替 reload,除非进程卡死。若 reload 后仍返回旧证书,检查是否有多个 server 块命中同一 server_name,或 CDN/负载均衡层仍缓存旧证书。
证书类型与有效期对比表格
GeoTrust 属于 DigiCert 体系的中端 OV 品牌,和 Let’s Encrypt DV、DigiCert 主品牌、自签名证书在审核、有效期、续期方式上差异明显。下表用于选型与部署对照,价格只给相对关系,具体以 CA 报价为准。
| 方案 | 验证类型 | 典型有效期 | 信任链 | 续期方式 | Nginx 配置差异 | 适用场景 |
|---|---|---|---|---|---|---|
| GeoTrust OV | 组织验证 OV | 不超过 398 天 | 公共信任,需 fullchain | 控制台续期或 API,手动/脚本部署 | ssl_certificate 指向 fullchain.pem | 企业官网、预算有限但需组织验证 |
| DigiCert OV/EV | OV 或 EV | 不超过 398 天 | 公共信任,链更完整 | 控制台/API,证书生命周期管理 | 同上,EV 需正确链 | 金融、政企、高信任场景 |
| Let’s Encrypt DV | 域名验证 DV | 90 天 | 公共信任,需 fullchain | ACME 自动续期,推荐 certbot | ssl_certificate 指向 live/fullchain.pem | 个人站、API、自动化程度高的业务 |
| 自签名 | 无公共验证 | 自定义 | 私有信任,浏览器默认不信任 | 手动重新生成 | 需客户端导入 CA | 内网测试、开发环境 |
有效期是选型中最容易误解的一列。公开信任 TLS 证书最长 398 天,GeoTrust 购买 2 年或 3 年服务并不等于单张证书可用 2 到 3 年,CA 会在到期前要求重签并替换服务器文件;Let’s Encrypt 90 天更适合 ACME 自动化。OV 与 DV 在 Nginx 配置上没有本质区别,差别在审核与证书主题信息;EV 也不会改变 ssl_certificate 的写法。自签名证书不能用于公网,否则 curl 报 self-signed certificate,Java 报 PKIX path building failed。若使用 CDN,证书可能部署在 CDN 边缘节点,源站 Nginx 可继续用回源证书或自签名,但浏览器看到的是 CDN 证书,验证时要区分。选型后应把到期监控接入 Zabbix/Prometheus 或 ACME 定时任务,至少提前 30 天告警。
常见错误排查:真实报错与修复命令
下面列出的报错在 GeoTrust 证书部署 Nginx 时高频出现。排查顺序建议:先看 nginx -t 是否通过,再看 openssl s_client 的 Verify return code,最后看客户端差异。不要只以浏览器能打开作为成功标准。
nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
含义是证书与私钥不匹配。用公钥指纹比对:openssl x509 -in fullchain.pem -noout -pubkey | openssl pkey -pubin -outform DER | openssl md5 与 openssl pkey -in example.com.key -pubout -outform DER | openssl md5 应一致;RSA 也可用 openssl x509 -noout -modulus | openssl md5 与 openssl rsa -noout -modulus | openssl md5。不一致只能找回原私钥或重签。
curl: (60) SSL certificate problem: unable to get local issuer certificate
openssl s_client ... Verify return code: 21 (unable to verify the first certificate)
这是证书链不完整,最常见原因是 ssl_certificate 只指向叶子证书。把站点证书与中间链合并为 fullchain.pem,并确保叶子在前、中间在后。用 grep -c ‘BEGIN CERTIFICATE’ fullchain.pem 至少为 2;用 openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep ‘Verify return code’ 验证应为 0 (ok)。
nginx: [emerg] PEM_read_bio_X509_AUX("/etc/nginx/ssl/example.com_fullchain.pem") failed (SSL: error:0909006C:PEM routines:get_name:no start line)
路径错、文件为空、下载成了 HTML 页面或不是 PEM 格式。用 file 与 head -n 2 检查,文件应以 —–BEGIN CERTIFICATE—– 开头。若私钥报 PEM_read_bio_PrivateKey() failed,常见是私钥带密码或格式为 DER,需转换:openssl pkey -in old.key -out new.key。
nginx: [warn] the "listen ... http2" directive is deprecated, use the "http2" directive instead
Nginx 1.25.1 及以上把 http2 从 listen 参数拆出。将 listen 443 ssl http2; 改为 listen 443 ssl; 并在 server 块加 http2 on;,然后 nginx -t 与 reload。旧版 Nginx 不要照抄 http2 on;,否则报 unknown directive。
Java: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
服务端链不完整或客户端 JDK 信任库过旧。先修 fullchain,再用 keytool -list -cacerts 检查根证书;旧 JDK 需更新 cacerts。小程序、Java、curl 报错而浏览器正常,几乎都是链问题。若 Verify return code: 10 (certificate has expired),检查系统时间与证书 notAfter,续期后确认 Nginx 加载的是新文件。
效果验证:命令行与 SSL Labs
部署完成后至少做四层验证:Nginx 配置加载、TLS 握手、证书链与有效期、应用层响应。第一层用 nginx -T 确认实际加载的文件路径;第二层用 openssl s_client 指定 SNI 与 TLS 版本;第三层看 Verify return code 与证书日期;第四层用 curl 访问业务 URL。命令如下,可直接执行并把 example.com 替换为你的域名。
sudo nginx -T | grep -E 'ssl_certificate|ssl_protocols|http2'
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep 'Verify return code'
curl -I https://example.com
curl -vI https://example.com 2>&1 | grep -E 'SSL connection|subject|issuer|expire'
Verify return code 应为 0 (ok);subject 应包含 CN 与 SAN;issuer 应是 GeoTrust/DigiCert 中间 CA 或根链中的签发者;dates 的 notAfter 应落在 398 天规则内。测试协议版本:openssl s_client -connect example.com:443 -servername example.com -tls1_2 应成功,-tls1_1 应失败并提示 unsupported protocol 或 handshake failure,说明旧 TLS 已禁用。测试 HTTP/2:echo | openssl s_client -connect example.com:443 -servername example.com -alpn h2 2>/dev/null | grep ALPN,输出应含 h2。若只看到 http/1.1,检查 http2 on; 是否在正确 server 块以及客户端是否支持。
最后跑 SSL Labs:https://www.ssllabs.com/ssltest/analyze.html?d=example.com。目标评级 A 或 A+;若出现链不完整、TLS1.0 启用、弱套件、HSTS 缺失等会降级。A+ 通常需要 HSTS 且无重定向问题。注意 CDN 场景要测试边缘节点而不是源站。把验证命令写入发布脚本,每次续期后自动执行 openssl s_client 与 curl,避免“续期成功但 Nginx 未加载新文件”。
常见问题
应配置 fullchain.pem,即站点叶子证书在前、中间证书在后,根证书通常不放。只配叶子证书会让浏览器偶然正常,但 curl、Java、小程序常报 unable to get local issuer certificate 或 Verify return code 21。合并后用 grep -c ‘BEGIN CERTIFICATE’ 确认至少两张,再用 openssl s_client 验证返回 0 (ok)。
公开信任 TLS 证书最长不超过 398 天,GeoTrust OV 即使购买多年期服务,实际签发到服务器的单张证书也受 398 天限制,到期需续期替换;Let’s Encrypt 为 90 天。不要把购买年限当单张证书有效期,应提前 30 天监控 notAfter 并准备续期。
比较公钥指纹:openssl x509 -in fullchain.pem -noout -pubkey | openssl pkey -pubin -outform DER | openssl md5 与 openssl pkey -in example.com.key -pubout -outform DER | openssl md5 输出应一致。RSA 也可用 modulus 比对,ECC 证书不要用 rsa -modulus。不一致只能找回原私钥或重新签发。
优先检查证书链是否完整,ssl_certificate 必须指向 fullchain.pem;再用 openssl s_client 看 Verify return code 是否为 0。若 Java 报 PKIX path building failed,更新 JDK 的 cacerts 并确认中间证书已发送。续期后还要 nginx -t 与 reload,确保加载的是新文件。
Nginx 1.25.1 起不要写 listen 443 ssl http2;,改为 listen 443 ssl; 并在 server 块增加 http2 on;。旧版 Nginx 不支持 http2 on;,仍用 listen 443 ssl http2;。修改后执行 nginx -t 校验,通过再 systemctl reload nginx。