跳到主要内容
Apache

GeoTrust SSL 证书 Apache 部署实战:fullchain 合并、VirtualHost 配置与五类报错排查

问题背景与根因:为什么 GeoTrust 证书在 Apache 上“装了不生效”

GeoTrust 现为 DigiCert 旗下中端品牌,价格比 DigiCert 主品牌低约 40%,OV 组织验证审核稳定,是预算有限又需要展示企业实体的常见选择。但网上大量流传的 GeoTrust Apache 教程停留在 2017 年前后,存在三处已经失效的说法:一是“证书可以签发 2 年”,自 2020 年 9 月起所有公有 CA 签发的 TLS 证书最长有效期被压缩到 398 天,Apple/macOS、Chrome 均已强制;二是“必须配置 SSLCertificateChainFile”,Apache 2.4.8 起该指令被标记弃用,改为把中间证书拼进 SSLCertificateFile;三是“用 SHA-1 签名更兼容”,SHA-1 证书已被主流浏览器全面拒绝。

实际排障中,九成“部署失败”并非证书本身问题,而是落在三类根因上:文件形态错误(只部署了叶子证书,缺中间证书,浏览器能靠 AIA 自动补链而 curl/Java/微信小程序不能)、版本与指令错配(2.4.8+ 仍写 ChainFile 导致证书链重复或被忽略)、进程未真正加载新文件(reload 未生效、SELinux 上下文错误、配置被其他 vhost 覆盖)。

先用三条命令定性,再决定往哪个方向修:

# 1. 看线上实际返回的证书链条数
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"
# 2. 看本地证书与私钥是否配对
openssl x509 -noout -modulus -in /etc/ssl/example.com_fullchain.crt | openssl md5
openssl rsa  -noout -modulus -in /etc/ssl/example.com.key        | openssl md5
# 3. 看证书有效期与 SAN 是否覆盖当前域名
openssl x509 -noout -dates -ext subjectAltName -in /etc/ssl/example.com_fullchain.crt

第 1 条输出为 1 说明只发了叶子证书,是链不完整的典型特征;第 2 条两个 MD5 不一致说明证书与私钥不是同一对(ECC 证书请改用 openssl pkey -pubout 与 openssl x509 -pubkey -noout 对比);第 3 条要确认 notAfter 距今不超过 398 天,且 SAN 中同时含 example.com 与 www.example.com。把这三步做完,再谈改配置,能省掉大量反复重启。

前置准备:GeoTrust 交付包解构与 fullchain 合并

GeoTrust 签发完成后,邮件或控制台下载的压缩包通常包含四个文件:example.com.crt(站点叶子证书)、example_com.ca-bundle(中间证书,常见为 GeoTrust RSA CA 2018 接 DigiCert Global Root G2 链路)、example.com.key(私钥,须与签发 CSR 时是同一对)、example.com.csr。根证书不要放进服务器文件,客户端本地已有信任锚,多放反而会让部分老旧客户端链验证失败。

合并顺序必须是“叶子在前、中间在后”:

cd /etc/ssl
cat example.com.crt example_com.ca-bundle > example.com_fullchain.crt
grep -c "BEGIN CERTIFICATE" example.com_fullchain.crt   # 正常为 2,交叉链可能为 3
openssl crl2pkcs7 -nocrl -certfile example.com_fullchain.crt | openssl pkcs7 -print_certs -noout
chmod 644 example.com_fullchain.crt
chmod 600 example.com.key
chown root:root example.com.key

pkcs7 -print_certs 会依次列出每张证书的 subject 与 issuer,可肉眼确认链路为“example.com ← GeoTrust RSA CA 2018 ← DigiCert Global Root G2”。如果只输出一条 subject,说明 ca-bundle 没拼进去或拼反了。

接着验证整链能否用系统根库验通,这比看浏览器小锁可靠得多:

openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted example_com.ca-bundle example.com.crt
# 期望输出:example.com.crt: OK

最后确认私钥格式。GeoTrust 交付的私钥一般为 PKCS#1(-----BEGIN RSA PRIVATE KEY-----)或 PKCS#8(-----BEGIN PRIVATE KEY-----),Apache 2.4 两者都能读;若私钥带口令,须先解密,否则 Apache 启动会卡在交互输入:

openssl rsa -in example.com.key -out example.com.nopass.key   # 有口令时执行
openssl rsa -in example.com.key -check -noout                  # 期望:RSA key ok

若采购的是 ECC 证书(GeoTrust 也提供 ECC 链,文件名多为 _ecc.ca-bundle),合并逻辑相同,但校验证书与私钥必须用公钥比对,modulus 对 ECC 无效。

实操步骤一:启用 SSL 模块、放行端口与 SELinux 上下文

Debian/Ubuntu 与 RHEL/CentOS 的启用方式不同,先确认发行版与 Apache 版本,因为 2.4.8 是配置写法的分水岭:

httpd -v        # 或 apache2 -v,确认 2.4.x 具体小版本
head -n 2 /etc/os-release

Debian/Ubuntu 系:

a2enmod ssl headers rewrite
apache2ctl -M | grep -E "ssl|headers|rewrite"   # 三个模块都应出现
systemctl restart apache2

RHEL/CentOS/Rocky 系:

dnf install -y mod_ssl
httpd -M | grep ssl_module
systemctl restart httpd

确认 443 端口处于监听状态且防火墙放行:

ss -lntp | grep ':443'
firewall-cmd --permanent --add-service=https && firewall-cmd --reload   # firewalld
ufw allow 443/tcp                                                       # ufw

RHEL 系最容易被忽略的是 SELinux。把证书放到 /etc/ssl 以外的自建目录后,若上下文不是 cert_t,Apache 进程读取会被拒绝,日志里出现 AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate!,或者干脆报文件不存在。修复方式:

semanage fcontext -a -t cert_t "/etc/ssl/example.com_fullchain.crt"
semanage fcontext -a -t cert_t "/etc/ssl/example.com.key"
restorecon -Rv /etc/ssl
ls -Z /etc/ssl/example.com_fullchain.crt    # 期望 system_u:object_r:cert_t:s0

如果私钥放在 /etc/pki/tls/private 之外,还要确认目录本身对 httpd_t 可读。先做权限、再写 VirtualHost,可以避免把权限问题误判成证书问题——这是排查顺序上最常见的时间浪费。

实操步骤二:VirtualHost 完整配置示例(含 80 跳转与 HSTS)

下面是 Apache 2.4.8+ 的推荐写法。关键点:只用一个 SSLCertificateFile 指向 fullchain,不再写 SSLCertificateChainFile;协议只保留 TLS 1.2/1.3;HSTS 建议先用较短 max-age 灰度,再拉长到一年。

<VirtualHost *:80>
    ServerName example.com
    ServerAlias www.example.com
    RewriteEngine on
    RewriteRule ^/(.*)$ https://example.com/$1 [R=301,L]
</VirtualHost>

<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com
    DocumentRoot /var/www/html

    SSLEngine on
    SSLCertificateFile      /etc/ssl/example.com_fullchain.crt
    SSLCertificateKeyFile   /etc/ssl/example.com.key

    SSLProtocol             -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite          ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305
    SSLHonorCipherOrder     off
    SSLSessionTickets       off

    SSLUseStapling          on

    Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
    Header always set X-Content-Type-Options "nosniff"
</VirtualHost>

# 必须写在 VirtualHost 之外的全局作用域
SSLStaplingCache "shmcb:/var/run/ocsp(128000)"

OCSP Stapling 需要证书链中带 AIA 扩展,GeoTrust 证书满足条件。若把 SSLStaplingCache 写进 vhost,apachectl configtest 会报 AH02217: ssl_stapling_init_cert 或 AH01980: SSLStaplingCache is not configured。

老版本(2.2 或 2.4.8 以下)必须额外一行,且 SSLCertificateFile 只放叶子证书:

SSLCertificateFile      /etc/ssl/example.com.crt
SSLCertificateChainFile /etc/ssl/example_com.ca-bundle

写完后按顺序执行,不要跳过 configtest:

apachectl configtest      # 期望 Syntax OK
apachectl -S              # 确认 443 vhost 的 ServerName 与配置文件路径正确
systemctl reload apache2  # 首次加载新模块时用 restart

若 apachectl -S 显示 443 上的 default server 是别的站点,说明存在 000-default.conf 或 ssl.conf 抢占,需要 a2dissite 或调整加载顺序——这类“配置改了没生效”往往不是缓存问题。

版本差异与品牌选型:两张对照表

先看 Apache 版本对配置的影响,这是照抄旧教程最容易踩的坑:

Apache 版本 证书文件写法 链证书指令 OCSP Stapling 备注
2.2.x 叶子证书 + 独立中间证书 SSLCertificateChainFile 必需 支持较差 已 EOL,不建议继续使用
2.4.0–2.4.7 叶子证书 + 独立中间证书 SSLCertificateChainFile 必需 支持 旧教程多基于此版本
2.4.8+ fullchain 单文件 已弃用,写了也生效但易重复 支持 本文推荐写法
2.4.30+ fullchain 单文件 不再依赖 支持,可配 SSLStaplingResponderTimeout 建议升级到此版本以上

再看证书类型选择,GeoTrust 的定位是“比 DV 多一层组织验证,比 DigiCert 主品牌便宜”:

类型 典型产品 最长有效期 验证内容 浏览器展示 适用场景
DV Let’s Encrypt、GeoTrust DV 系列 90 天(LE)/ 398 天 仅域名控制权 小锁 个人站、测试环境、可自动化续期
OV GeoTrust TrueBusinessID 398 天 域名 + 企业工商实体 小锁(详情可见组织) 企业官网、B2B 平台、小程序后端
EV DigiCert Secure Site Pro 等 398 天 OV + 更严格核验 小锁(绿色地址栏已取消) 金融、政务
通配符 OV GeoTrust Wildcard 398 天 OV + *.example.com 小锁 多子域统一管理

两点提醒:一是 398 天是硬上限,任何 CA 都不能签发更长的公有证书,续期必须靠自动化或提前 30 天人工更换;二是 Let’s Encrypt 为 90 天,与商业证书 398 天在运维节奏上完全不同,混用时要分别配置监控。EV 证书的绿色地址栏在 Chrome 77 之后已取消,选型时不要再把它当卖点。

常见错误排查:五条真实报错与对应修法

1)curl 报 SSL certificate problem: unable to get local issuer certificate,浏览器却正常。浏览器会通过证书里的 AIA 地址自动下载中间证书,curl/Java/Python requests 不会。修法是合并 fullchain 后 reload,并用 openssl s_client -showcerts 确认返回两条以上证书。微信小程序、老版本 Android WebView 报同类错误也源于此。

2)Apache 启动失败:SSL Library Error: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch。证书与私钥不配对,通常是续期时只换了 crt 没换 key。执行第一节的 modulus 对比;ECC 证书用:

openssl x509 -in example.com_fullchain.crt -pubkey -noout | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5

3)AH00526: Syntax error on line 12 of /etc/apache2/sites-enabled/example-ssl.conf: SSLCertificateFile: file '/etc/ssl/example.com_fullchain.crt' does not exist or is empty。路径拼错、文件 0 字节,或 SELinux 阻止读取被 Apache 报成不存在。用 ls -lZ 同时确认大小与上下文,再以服务账号身份 sudo -u apache cat 文件 验证可读性。

4)AH02032: Hostname example.com provided via SNI and hostname www.example.com provided via HTTP are different。客户端用 SNI 连了 example.com,但请求头 Host 是另一个域名,通常是 80 跳转规则写错或 CDN 回源 Host 未对齐。检查 ServerName/ServerAlias 与跳转目标是否一致。

5)Java 客户端报 javax.net.ssl.SSLHandshakeException: PKIX path building failed。服务端未发全链,客户端信任库又无法补链。除了修 fullchain,也可在客户端导入中间证书,但正确做法永远是服务端把链发全。用 openssl s_client -verify 5 -CAfile /etc/ssl/certs/ca-certificates.crt 复现,输出 Verify return code: 0 (ok) 才算修好。

另有一类隐蔽问题:续期后浏览器仍显示旧证书。原因多为多进程未重载(systemctl reload 对部分 MPM 才平滑生效)、配置指向的软链接未更新、或前面有 Nginx/CDN 终止了 TLS。排查顺序是先在服务器本机 openssl s_client -connect 127.0.0.1:443,再对比公网 IP 结果,逐跳定位。

效果验证:从命令行到评分的三层校验

第一层,本地链路校验,不依赖任何外部服务:

openssl s_client -connect example.com:443 -servername example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt -verify 5 </dev/null
# 关注三行:Verify return code: 0 (ok) / Protocol : TLSv1.3 / Cipher : TLS_AES_256_GCM_SHA384

第二层,用 curl 强制指定 TLS 版本,模拟真实客户端:

curl -vI https://example.com --tlsv1.2 --tls-max 1.2
curl -vI https://example.com --tlsv1.3
curl -vI https://example.com --tlsv1.0    # 期望失败:alert protocol version

第三条必须失败,若仍能握手说明 SSLProtocol 没生效,常见原因是另一处 ssl.conf 里的全局 SSLProtocol all -SSLv3 覆盖了 vhost 设置。用 apachectl -S 与 grep -rn "SSLProtocol" /etc/apache2 /etc/httpd 定位重复项。

第三层,检查协议细节与评分:

# 是否启用 HSTS
curl -sI https://example.com | grep -i strict-transport-security
# 是否启用 OCSP Stapling(应出现 OCSP Response Status: successful)
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -A3 "OCSP response"
# 证书剩余天数,接入监控
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -enddate

对外可用 SSL Labs(ssllabs.com/ssltest)或 testssl.sh 打分:./testssl.sh --fast https://example.com。Apache 2.4.30+ 配合上述配置一般能拿到 A 或 A+;若只有 B,多半是仍支持 TLS 1.0/1.1、保留了 CBC 套件、或未开 HSTS。A+ 要求 HSTS 的 max-age 不低于 15768000 秒并带 preload 语义,正式提交 preload 列表前务必确认所有子域都已支持 HTTPS,否则回滚成本很高。

最后把校验脚本化:把剩余天数写入 Zabbix 或 Prometheus 的 textfile collector,阈值设 30 天告警。398 天有效期意味着一年只续一次,纯靠人工记忆几乎必然会漏。

续期与运维:398 天周期下的替换流程

GeoTrust OV 续期需重新走组织验证(部分资料可复用,但仍需人工确认),签发后拿到的新文件不一定同名,因此建议在服务器上固定“稳定文件名 + 时间戳归档”的约定:

/etc/ssl/example.com_fullchain.crt          -> 软链接到当前版本
/etc/ssl/archive/example.com_fullchain_20260101.crt
/etc/ssl/example.com.key                    -> 软链接到当前私钥

标准替换流程:

cp example.com_fullchain_20260101.crt /etc/ssl/archive/
ln -sfn /etc/ssl/archive/example.com_fullchain_20260101.crt /etc/ssl/example.com_fullchain.crt
apachectl configtest && systemctl reload apache2
openssl s_client -connect 127.0.0.1:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -enddate

要点有三:一是用 reload 而非 restart,避免中断长连接,但首次加载新模块或改了监听端口必须 restart;二是若私钥同时更换,先换 key 再换 crt 会出现短暂 mismatch,正确顺序是同一批文件同时替换并一次性 reload;三是 CDN 或负载均衡后面有多台源站时,逐台替换、逐台验证,不要一次性全量下发。

另外两项常被忽略:开启证书透明度监控(把域名加入 crt.sh 监控或自建 CT 日志告警),可以发现未授权的误签发;为 OCSP 失败准备 soft-fail 策略,Apache 默认 SSLStaplingReturnResponderErrors off,stapling 失败时仍能握手,不要改成 on,否则 OCSP 服务器抖动会直接导致站点不可用。若使用 ECC 证书,确认客户端群(尤其老 Android、早期 Java 8)支持相应曲线,必要时同时部署 RSA 与 ECC 双证书并配合多行 SSLCertificateFile 写法。

常见问题

不能超过 398 天。自 2020 年 9 月起所有公有 CA 的 TLS 证书有效期上限为 398 天,GeoTrust 作为 DigiCert 旗下品牌同样受限,购买页写的“1 年”实际约 398 天,到期必须重新签发并替换服务器文件。

不需要。2.4.8 起该指令已弃用,把中间证书与站点证书合并成 fullchain 写入 SSLCertificateFile 即可;同时保留 ChainFile 可能导致链重复,个别客户端报证书链错误。老版本仍需单独配置。

说明服务端只发了叶子证书。执行 cat example.com.crt ca-bundle > fullchain.crt,把 SSLCertificateFile 指向 fullchain 并 reload,再用 openssl s_client -showcerts 确认返回两条以上证书即可解决。

先确认配置路径指向新文件、软链接已更新,再 systemctl reload,仍无效则 restart;前面有 CDN 或 Nginx 时需在对应层同步替换,并用本机 openssl s_client -connect 127.0.0.1:443 对比公网结果逐跳排查。

用 openssl s_client -connect example.com:443 -servername example.com -showcerts,输出中 BEGIN CERTIFICATE 出现两次以上且 Verify return code 为 0 即完整;也可用 openssl verify -untrusted ca-bundle example.com.crt 在本地验证。

内容审核

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