跳到主要内容
Nginx

GeoTrust SSL 证书 Nginx 安装部署实战:证书链、TLS 1.3 与常见报错排查

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

GeoTrust 现属 DigiCert 旗下,定位中端 OV 证书,价格通常低于 DigiCert 主品牌,具体折扣随渠道和年限变化。很多站点在 Nginx 上只配置了站点叶子证书,浏览器因 AIA 补链能正常显示锁标,但 curl、Java、微信小程序、Python requests 会严格校验证书链,于是出现 curl: (60) SSL certificate problem: unable to get local issuer certificate 或 Java PKIX path building failed。根因不是 GeoTrust 证书无效,而是 ssl_certificate 指向了不含中间证书的 PEM。另一个常见根因是私钥权限过宽、证书与私钥不匹配、TLS 协议过旧。需要同时修正事实:公共信任 TLS 证书单张最长有效期已按 CA/B 论坛规则限制为 398 天,Let’s Encrypt 默认 90 天;GeoTrust/DigiCert 实际到期日以签发结果为准,部署后必须做到期监控。Nginx 侧还要注意 SNI:同一 IP 多域名时,server_name 与证书 SAN 必须一致;80 端口未做 301 跳转会导致 HSTS 预加载失败。下面先检查当前链:openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -E 'Verify return code|s:|i:',若返回 Verify return code: 20 (unable to get local issuer certificate),即可确认缺中间证书。

准备证书文件:PEM、fullchain.pem 与私钥权限

在 GeoTrust/DigiCert 控制台下载 Nginx/PEM 格式包,通常包含站点证书 example.com.crt、中间证书 ca-bundle.crt 和私钥 example.com.key。Nginx 的 ssl_certificate 应使用“站点证书+中间证书”合并后的 fullchain,顺序为叶子证书在前、中间证书在后。可直接执行:cat example.com.crt ca-bundle.crt > example.com_fullchain.pem。不要只上传叶子证书;也不要把根证书塞进 fullchain,根证书应由客户端信任库提供。检查文件:openssl x509 -in example.com_fullchain.pem -noout -subject -issuer -dates -ext subjectAltName,确认 CN/SAN 覆盖 example.com 与 www.example.com,并确认 notAfter 在 398 天规则内。若需重新生成 CSR,可用 openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'。私钥权限建议 install -m 600 example.com.key /etc/nginx/ssl/example.com.key,属主 root:root;目录 chmod 700 /etc/nginx/ssl。用 grep -c 'BEGIN CERTIFICATE' example.com_fullchain.pem 应返回 2 或更多,表示链已合并。若返回 1,说明仍是叶子证书。最后确认私钥未加密,Nginx 启动时不会交互输入密码;如私钥带密码,需先 openssl rsa -in enc.key -out example.com.key 解密并限制权限。

完整实操步骤:上传、校验、配置与平滑 reload

先创建目录并上传:mkdir -p /etc/nginx/ssl && chmod 700 /etc/nginx/ssl,将 example.com_fullchain.pem 与 example.com.key 放入该目录,执行 chmod 600 /etc/nginx/ssl/example.com.key。修改配置前备份:cp /etc/nginx/conf.d/example.com.conf /etc/nginx/conf.d/example.com.conf.bak.$(date +%F)。写入配置后先做语法检查:nginx -t,期望输出 nginx: configuration file /etc/nginx/nginx.conf test is successful。不要直接 restart,生产环境优先平滑重载:systemctl reload nginx 或 nginx -s reload。重载后检查监听与进程:ss -lntp | grep ':443',并查看错误日志 tail -n 50 /var/log/nginx/error.log。若 nginx -t 报 cannot load certificate ... PEM_read_bio_X509_AUX() failed,优先检查路径、文件权限和 PEM 头尾是否完整。若报 SSL_CTX_use_PrivateKey_file() failed ... key values mismatch,说明证书与私钥不配对。续期场景不要只替换文件,必须 reload;Kubernetes Ingress 或负载均衡后面还有一层 TLS 终止时,要在对应入口更新证书。最后用 nginx -T | grep -nE 'ssl_certificate|ssl_protocols|http2' 确认生效配置没有被其他 server 块覆盖。

Nginx 配置示例:TLS 1.2/1.3、HTTP/2 与 80 跳转

以下配置可直接作为 /etc/nginx/conf.d/example.com.conf 模板。Nginx 1.25.1 及以上推荐 http2 on;;旧版本可把 listen 443 ssl; 改为 listen 443 ssl http2;,不要两种写法混用。示例: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'; 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' always; location / { root /var/www/example; index index.html; } }。80 跳转单独写:server { listen 80; server_name example.com www.example.com; return 301 https://$host$request_uri; }。HSTS 首次上线建议先用 max-age=300 验证,再逐步增加,避免配置错误后难以回退。若使用 OCSP Stapling,可加 ssl_stapling on; ssl_stapling_verify on; ssl_trusted_certificate /etc/nginx/ssl/ca-bundle.pem;,但必须确保中间证书链正确,否则可能报 SSL_CTX_set1_chain 相关错误。TLS 1.3 的套件由 OpenSSL 自动协商,ssl_ciphers 主要影响 TLS 1.2。

证书链与私钥匹配:三条命令定位 90% 部署问题

第一条查链:openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | openssl x509 -noout -subject -issuer -dates,再执行 openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep 'Verify return code',应为 0 (ok);若为 20,缺中间证书;若为 21,证书过期或系统时间错误;若为 10,证书已过期。第二条查链文件:openssl verify -CAfile /etc/nginx/ssl/ca-bundle.pem /etc/nginx/ssl/example.com.crt,应返回 OK。第三条查私钥匹配:RSA 证书可用 openssl x509 -noout -modulus -in example.com_fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5,两个 MD5 必须一致;ECDSA 证书改用公钥比对:openssl x509 -pubkey -noout -in example.com_fullchain.pem | openssl pkey -pubin -outform der | openssl dgst -sha256 与 openssl pkey -pubout -in example.com.key | openssl pkey -pubin -outform der | openssl dgst -sha256。还要确认 fullchain 中证书数量:grep -c 'BEGIN CERTIFICATE' example.com_fullchain.pem,GeoTrust OV 通常为 2 张(叶子+中间),若为 1 张就是浏览器正常、程序报错的典型原因。检查 SAN:openssl x509 -in example.com_fullchain.pem -noout -ext subjectAltName,域名不匹配时 curl 会报 no alternative certificate subject name matches target host name。

对比表格:GeoTrust OV、DigiCert OV 与 Let’s Encrypt 的 Nginx 部署差异

下表用于选型和部署检查。GeoTrust 现属 DigiCert,OV 审核稳定,适合预算有限但需要组织验证的企业;DigiCert 主品牌价格更高、行业认知度更强;Let’s Encrypt 适合自动化程度高的站点。公共信任 TLS 证书最长有效期 398 天,Let’s Encrypt 默认 90 天,二者都必须做续期和 reload。表格:

项目 GeoTrust OV DigiCert OV Let’s Encrypt
证书类型 OV,组织验证 OV,组织验证 DV,域名验证
有效期 最长 398 天,以签发为准 最长 398 天,以签发为准 默认 90 天
Nginx 证书文件 fullchain.pem + key fullchain.pem + key fullchain.pem + privkey.pem
证书链 需合并中间证书 需合并中间证书 certbot 自动生成 fullchain
续期方式 控制台重签后手工/脚本 reload 控制台重签后手工/脚本 reload certbot renew 自动
适用场景 企业官网、预算敏感 OV 品牌要求高的企业站点 测试、自动化、个人站点

部署差异的核心不在证书品牌,而在链文件和续期流程。GeoTrust/DigiCert 下载包通常需要手工合并 cat crt ca-bundle > fullchain.pem;Let’s Encrypt 的 /etc/letsencrypt/live/example.com/fullchain.pem 已包含链。价格方面,GeoTrust 通常低于 DigiCert 主品牌,但“低约 40%”会随渠道、年限、是否含通配符变化,应以购买页为准。若使用通配符 OV,Nginx 配置中的 server_name 仍要覆盖实际域名,证书 SAN 为 *.example.com 时不自动包含 example.com。

常见错误排查:从 nginx -t 报错到 curl 60/PKIX 失败

错误 1:nginx: [emerg] cannot load certificate '/etc/nginx/ssl/example.com_fullchain.pem': PEM_read_bio_X509_AUX() failed (SSL: error:0A000086:SSL routines::certificate verify failed)。多为文件不存在、权限不足或 PEM 内容损坏。执行 ls -l /etc/nginx/ssl、head -n 1 fullchain.pem 应为 -----BEGIN CERTIFICATE-----。错误 2:nginx: [emerg] SSL_CTX_use_PrivateKey_file('/etc/nginx/ssl/example.com.key') failed (SSL: error:0A00018A:SSL routines::ee key too small),说明 RSA 位数过低,改用 2048 位以上并重签。错误 3:key values mismatch,证书与私钥不配对,用上一节 modulus/公钥比对命令。错误 4:curl: (60) SSL certificate problem: unable to get local issuer certificate,缺中间证书,改用 fullchain。错误 5:Java 报 sun.security.validator.ValidatorException: PKIX path building failed,同样是链不完整,需把中间证书合并到服务端发送链中。错误 6:Nginx 新版本提示 the 'listen ... http2' directive is deprecated, use 'http2' directive instead,把 listen 443 ssl http2; 改为 listen 443 ssl; http2 on;。错误 7:续期后仍显示旧证书,执行 nginx -T | grep ssl_certificate 确认路径,再 systemctl reload nginx;若前面有 CDN/负载均衡,需在入口层同步更新。

效果验证与上线检查:openssl、curl、SSL Labs 与到期监控

先验证 TLS 握手和链:openssl s_client -connect example.com:443 -servername example.com -tls1_2 2>/dev/null | grep -E 'Protocol|Cipher|Verify return code',应看到 TLSv1.2 与 Verify return code: 0 (ok);再测 TLS 1.3:openssl s_client -connect example.com:443 -servername example.com -tls1_3 2>/dev/null | grep 'Protocol'。用 curl 验证 HTTP 跳转和证书:curl -I http://example.com 应返回 301 且 Location: https://example.com/;curl -I https://example.com 应返回 200。检查配置:nginx -T | grep -E 'ssl_certificate|ssl_protocols|http2'。检查端口:ss -lntp | grep ':443'。上线后跑一次 SSL Labs,目标 A/A+;若评级低,常见原因是 TLS 1.0/1.1 未关闭、RC4/3DES 套件、缺 HSTS。到期监控可用 openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -checkend 2592000,返回 Certificate will not expire 表示 30 天内不过期;否则触发告警。cron 示例:0 3 * * * openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -checkend 2592000 || echo 'GeoTrust cert expiring' | mail -s 'SSL expiry' ops@example.com。最后确认证书链中无根证书、私钥权限 600、reload 后错误日志无 SSL 报错。

常见问题

是。Nginx 的 ssl_certificate 应指向站点证书加中间证书合并的 fullchain.pem;只配叶子证书时浏览器可能正常,但 curl、Java、小程序会因链不完整报 unable to get local issuer certificate。合并命令为 cat example.com.crt ca-bundle.crt > example.com_fullchain.pem,并用 grep -c ‘BEGIN CERTIFICATE’ 确认至少 2 张。

不是。公共信任 TLS 证书单张最长有效期已限制为 398 天,GeoTrust/DigiCert 实际到期日以签发结果为准;Let’s Encrypt 默认 90 天。部署后应使用 openssl x509 -checkend 做到期监控,续期替换文件后必须 reload Nginx。

说明证书与私钥不匹配。RSA 证书执行 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 和 openssl rsa -noout -modulus -in key.pem | openssl md5,两个 MD5 必须一致;ECDSA 证书用公钥摘要比对。不一致时重新下载匹配的私钥或重新签发,不要混用不同 CSR 的文件。

通常是服务端只发送了叶子证书,未发送中间证书。浏览器会通过 AIA 自动补链,curl/Java 不会。将中间证书合并进 fullchain.pem,确保 ssl_certificate 指向合并文件,再 reload;用 openssl s_client -showcerts 和 Verify return code: 0 (ok) 验证。

Nginx 1.25.1 及以上推荐 listen 443 ssl; 加 http2 on;,旧写法 listen 443 ssl http2; 会提示 deprecated。不要在同一 server 重复开启 http2,也不要混用新旧指令;改完执行 nginx -t 和 systemctl reload nginx,再用 curl -I –http2 https://example.com 验证。

内容审核

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