跳到主要内容
Nginx

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。

内容审核

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