跳到主要内容
Apache

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

问题背景与根因:DigiCert 证书装到 Apache 为什么还是“不安全”

DigiCert 签发的是标准 X.509 证书,与 Apache 之间不存在兼容性问题。真正导致部署失败的,几乎都集中在四个根因上。

根因一:交付包里三个证书分不清。DigiCert CertCentral 或邮件附件里通常给出 example.com.crt(站点叶证书)、DigiCertCA.crt(中间证书)、TrustedRoot.crt(根证书)。Apache 2.4.8 之后只认一个 SSLCertificateFile,必须把叶证书与中间证书按“先叶、后中间”的顺序拼成 fullchain;只填叶证书时,Chrome/Edge 会自己走 AIA 补链,看起来一切正常,但 curl、Java、微信小程序、Android 7 以下一定报 unable to get local issuer certificate。

根因二:Apache 版本差异。2.4.8 起 SSLCertificateChainFile 被标记为过时,链要写进 SSLCertificateFile;2.2.x 与 2.4.8 以下则相反,必须用 SSLCertificateChainFile 单独指定中间证书。混用容易造成链重复或顺序错乱。

根因三:私钥与证书不匹配。同机多张证书、多次生成 CSR 时,很容易把 A 站点的 key 配给 B 站点的 crt,Apache 启动直接报 key values mismatch。

根因四:续期后没重载,或配置仍指向旧文件。公网受信任证书单张最长有效期 398 天(Let’s Encrypt 为 90 天),到期前必须换新文件并 systemctl reload apache2,否则进程仍持有旧证书的内存句柄。CA/B Forum 已确定继续缩短有效期(2026 年 200 天、2027 年 100 天、2029 年 47 天),手工换证频率只会更高,把配置写成可复用的模板比一次装通更重要。

下文按“文件准备 → 启用模块 → VirtualHost → 配置示例 → 版本对比 → 报错排查 → 验证”的顺序给出可直接执行的命令,环境以 Ubuntu 22.04 + Apache 2.4.52 为例,RHEL/CentOS 的差异单独标注。

第一步:准备证书文件、合并 fullchain 并核对私钥

先把 DigiCert 交付包解压到临时目录,确认每个文件到底是什么。

unzip -o DigiCert_SSL_CN_example.com.zip -d /root/digicert
cd /root/digicert && ls -l
# example.com.crt  DigiCertCA.crt  TrustedRoot.crt  example.com.key

# 逐张看主体、签发者、有效期和 SAN
openssl x509 -in example.com.crt -noout -subject -issuer -dates -ext subjectAltName

输出里 subject 应为 CN=example.com,issuer 是 DigiCert 的中间 CA(例如 DigiCert TLS RSA SHA256 2020 CA1),notAfter 与订单一致,SAN 必须覆盖你实际要用的所有域名(example.com、www.example.com)。

合并证书链,顺序不能反:

cat example.com.crt DigiCertCA.crt > example.com_fullchain.crt
# 用系统根库做信任锚,验证链是否完整
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted DigiCertCA.crt example.com.crt
# 期望输出:example.com.crt: OK

核对证书与私钥是否配对,用公钥指纹比对,RSA 与 ECDSA 证书通用:

openssl x509 -in example.com.crt -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
# 两个 md5 必须完全一致

老教程常用的 openssl rsa -noout -modulus 只对 RSA 有效,DigiCert 的 ECC 证书会直接报错,建议统一改用上面的写法。

安装到标准路径并收紧权限:

install -m 644 example.com_fullchain.crt /etc/ssl/certs/example.com_fullchain.crt
install -m 600 -o root -g root example.com.key /etc/ssl/private/example.com.key
chown root:root /etc/ssl/certs/example.com_fullchain.crt

私钥 600 且属主 root 是硬要求,否则 Apache 报 AH02560 或 permission denied。RHEL 系开启 SELinux 时还要修正上下文,否则进程读不到文件:

restorecon -Rv /etc/ssl
# 或:chcon -t cert_t /etc/ssl/certs/example.com_fullchain.crt /etc/ssl/private/example.com.key
ls -Z /etc/ssl/private/example.com.key

交付包里的 .pfx/.p12 留给 IIS 或 Java 用,Apache 不要用 PKCS#12,多一层转换就多一次出错机会。

第二步:启用模块并让 VirtualHost 真正生效

先确认模块状态,再启用站点,最后才是 reload——顺序错了会白折腾。

# Debian / Ubuntu
a2enmod ssl headers
apache2ctl -M | grep -E 'ssl|headers'
# 期望看到 ssl_module (shared) / headers_module (shared)

# RHEL / CentOS / Rocky
dnf install -y mod_ssl
httpd -M | grep -E 'ssl_module|headers_module'

把 VirtualHost 写进 /etc/apache2/sites-available/example.com-ssl.conf,启用并检查语法:

a2ensite example.com-ssl.conf
apachectl configtest
# 必须看到 Syntax OK 才继续

systemctl reload apache2
ss -lntp | grep ':443'
# LISTEN 0 511 *:443 *:* users:(("apache2",pid=...))

RHEL 系没有 a2ensite,直接把 conf 放进 /etc/httpd/conf.d/,再 systemctl reload httpd。

reload 与 restart 的差别要清楚:reload 让主进程重读配置、worker 平滑重启,证书续期后用它就够,连接不会中断;如果换了私钥路径、改了模块加载或文件权限,restart 更稳妥。systemd 下 apache2 的 ExecReload 实际执行的是 apachectl graceful。

别忘了防火墙与云安全组:

firewall-cmd --permanent --add-service=https && firewall-cmd --reload   # RHEL
ufw allow 443/tcp && ufw reload                                          # Ubuntu

如果站点有 AAAA 记录,确认 ss -lntp 里除了 0.0.0.0:443 还有 [::]:443,否则部分移动网络会连不上。同时确认 ServerName 与证书 SAN 完全一致:证书签的是 example.com,用户访问 www.example.com 就会报名称不匹配,需要用 ServerAlias 配合证书覆盖该域名,或做 301 跳转。

验证 vhost 是否按预期绑定:

apachectl -t -D DUMP_VHOSTS | grep -A3 ':443'
# port 443 namevhost example.com (/etc/apache2/sites-enabled/example.com-ssl.conf:5)

如果 DUMP_VHOSTS 里出现 default ssl vhost,说明别的站点先匹配上了,需要给默认站点补 ServerName 或调整加载顺序。

完整配置示例:HTTP 跳转、TLS 参数与 HSTS

下面这份配置可直接替换域名后使用,分 80 与 443 两个 VirtualHost。

<VirtualHost *:80>
    ServerName example.com
    ServerAlias www.example.com
    Redirect permanent / https://example.com/
</VirtualHost>

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

    SSLEngine on
    # 2.4.8+:叶证书 + 中间证书合并后的 fullchain
    SSLCertificateFile    /etc/ssl/certs/example.com_fullchain.crt
    SSLCertificateKeyFile /etc/ssl/private/example.com.key
    # Apache < 2.4.8 才需要下面这行
    # SSLCertificateChainFile /etc/ssl/certs/DigiCertCA.crt

    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

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

    ErrorLog  ${APACHE_LOG_DIR}/example.com-ssl_error.log
    CustomLog ${APACHE_LOG_DIR}/example.com-ssl_access.log combined
</VirtualHost>

几个参数值得说明。SSLProtocol 只留 TLSv1.2 / TLSv1.3,TLSv1.0/1.1 早已被主流浏览器弃用,开着只会让 PCI DSS 扫描不通过。SSLCipherSuite 只保留 AEAD 套件,ECDSA 与 RSA 各留一组,兼容两种证书类型。SSLHonorCipherOrder off 让客户端优先选 ChaCha20,移动端握手更省电。

HSTS 要谨慎。先在测试环境用 max-age=300 观察,确认所有子域都支持 HTTPS 后再加 includeSubDomains;一旦提交 preload 列表,回退周期以月计。HSTS 头只能出现在 443 的 VirtualHost 里,写在 80 端口上无效。

OCSP Stapling 现在可选。CA/B Forum 已推动 OCSP 逐步退场,部分新签发证书不再提供 responder,强行开启会在日志里刷 AH02217。确实要开时加:

SSLUseStapling on
SSLStaplingCache "shmcb:/var/run/apache2/ssl_stapling(32768)"
SSLStaplingResponderTimeout 5

改完统一执行 apachectl configtest && systemctl reload apache2,再用日志确认没有新的 TLS 告警。

对比表格:Apache 版本、文件类型与验证手段

先把版本与证书链的对应关系固定下来,这是最容易踩坑的地方:

Apache 版本 证书链配置方式 关键指令 注意事项
2.4.8 及以上 叶证书 + 中间证书合并为一个文件 SSLCertificateFile 指向 fullchain.crt SSLCertificateChainFile 已标记过时,混用易造成链重复
2.2.x / 2.4.8 以下 叶证书与中间证书分开 SSLCertificateFile=叶,SSLCertificateChainFile=中间 漏配或顺序写反都会导致链不完整
任意版本 私钥单独文件 SSLCertificateKeyFile 私钥文件中不能夹带任何证书
任意版本 根证书 不使用 根证书由客户端信任库提供,下发反而增大握手包

再对照 DigiCert 交付包里每个文件的用途:

交付文件 内容 Apache 是否使用 放置位置
example.com.crt 站点叶证书 合并进 fullchain /etc/ssl/certs
DigiCertCA.crt 中间证书 合并进 fullchain /etc/ssl/certs
TrustedRoot.crt 根证书 不使用,仅存档 /root/digicert
example.com.key 私钥 使用 /etc/ssl/private(600)
example.com.pfx PKCS#12 打包 不使用 留给 IIS / Java

最后是三种验证手段的分工,别只会用浏览器看小锁:

目的 命令 正常结果
链是否完整 openssl verify -CAfile … -untrusted DigiCertCA.crt example.com.crt example.com.crt: OK
握手与信任 openssl s_client -connect example.com:443 -servername example.com Verify return code: 0 (ok)
实际生效有效期 s_client 输出管道给 openssl x509 -noout -dates notAfter 为新到期日
老协议是否关闭 openssl s_client -tls1_1 … 握手失败 / no protocols available

三张表配合使用:先按版本表确定写法,再按文件表核对交付物,最后用验证表逐条打勾。多数“部署失败”其实卡在第一张表——把 fullchain 配成了叶证书。

常见错误排查:真实报错与修复命令

下面这些报错都能在 Apache error_log 或客户端输出里直接搜到,按关键词定位即可。

1)文件路径错或内容为空

AH00526: Syntax error on line 5 of /etc/apache2/sites-enabled/example.com-ssl.conf:
SSLCertificateFile: file '/etc/ssl/example.com_fullchain.crt' does not exist or is empty

先 ls -l 看文件是否存在,再 grep -c "BEGIN CERTIFICATE" example.com_fullchain.crt,fullchain 应该输出 2 或 3,输出 1 说明根本没合并中间证书。

2)私钥与证书不匹配

AH02564: Failed to configure encrypted (?) private key example.com:443:0,
check /etc/ssl/private/example.com.key
SSL Library Error: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch

用前面公钥 md5 比对法确认;如果私钥带密码,Apache 启动时需要 SSLPassPhraseDialog,生产环境不建议给私钥加密。

3)客户端报链不完整

curl: (60) SSL certificate problem: unable to get local issuer certificate

Java 侧对应 PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target,Android 7 以下与微信小程序同理。用 openssl s_client -showcerts 看服务端返回几张证书,只有一张就是没配 fullchain。

4)SNI 与 vhost 不匹配

AH02032: Hostname example.com provided via SNI and hostname www.example.com
provided via HTTP have no compatible SSL setup

检查 ServerName/ServerAlias,或确认 80 端口跳转目标写错(跳到了未配置证书的域名)。

5)证书不含当前主机名

AH01909: RSA certificate configured for example.com:443 does NOT include
an ID which matches the server name

对照 openssl x509 -ext subjectAltName 的输出,补齐 SAN 或改用跳转。

6)续期后浏览器仍显示旧证书,先查实际生效日期:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -dates
# 若 notAfter 仍是旧日期,说明未 reload 或配置指向旧文件
grep -r SSLCertificateFile /etc/apache2/sites-enabled/

效果验证:五条命令确认部署成功

# 1. 服务端实际下发的证书与链
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -E 'depth=|verify return|subject=|issuer='

# 2. 浏览器视角的信任校验
openssl s_client -connect example.com:443 -servername example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>/dev/null | grep 'Verify return code'
# 期望:Verify return code: 0 (ok)

# 3. 实际生效的有效期(续期后必查)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 4. HTTP 跳转与 HSTS 头
curl -sSI http://example.com | head -3
curl -sSI https://example.com | grep -iE 'strict-transport-security|^HTTP'

# 5. 老协议是否已关闭
echo | openssl s_client -connect example.com:443 -servername example.com -tls1_1 2>&1 
  | grep -iE 'alert|no protocols'

期望结果:第 1 条输出 depth=0(站点证书)、depth=1(DigiCert 中间证书);第 2 条返回 0 (ok);第 3 条 notAfter 是新的到期日;第 4 条 80 端口返回 301 且 Location 指向 https://example.com/,443 返回 HTTP/2 200 且带 HSTS 头;第 5 条握手失败。

再用 curl 模拟“浏览器正常但程序报错”的客户端,强制走完整链校验:

curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com
# 200 0 —— 第二列必须是 0
curl --cacert /etc/ssl/certs/ca-certificates.crt -sSI https://example.com | head -1

接着看日志确认没有 TLS 层告警:

tail -n 30 /var/log/apache2/example.com-ssl_error.log
journalctl -u apache2 --since '10 min ago' | grep -iE 'ssl|tls|stapling'

最后用 testssl.sh 或 SSL Labs 做一次全量扫描,重点看证书链、协议版本、前向保密、HSTS 四项。内部系统不便暴露公网时本地跑:

./testssl.sh --fast https://example.com

上线检查清单:fullchain 含两张及以上证书、私钥权限 600、configtest 通过、DUMP_VHOSTS 绑定正确、Verify return code 为 0、80→443 跳转生效、notAfter 与订单一致、日志无 stapling 告警。

常见问题

是。Apache 2.4.8 及以上要把叶证书与中间证书按“先叶后中间”合并进 SSLCertificateFile。只放叶证书时浏览器会自动补链看不出问题,但 curl、Java、小程序会报 unable to get local issuer certificate。


比对公钥指纹:openssl x509 -in cert.crt -noout -pubkey | openssl md5 与 openssl pkey -in key.pem -pubout | openssl md5,两个值一致即匹配。老教程的 openssl rsa -noout -modulus 只对 RSA 有效,ECC 证书会报错。


两种情况:没执行 systemctl reload apache2,进程仍持有旧证书;或 vhost 里的 SSLCertificateFile 仍指向旧文件。执行 grep -r SSLCertificateFile /etc/apache2/sites-enabled/ 核对路径,再用 openssl s_client 查 notAfter 确认。


公网受信任证书单张最长有效期 398 天,DigiCert 常规订单按此签发;Let’s Encrypt 免费证书为 90 天。CA/B Forum 已确定继续缩短至 2026 年 200 天、2027 年 100 天、2029 年 47 天,建议提前做自动化续期。


需要。2.2.x 与 2.4.8 以下版本必须在 SSLCertificateFile 填叶证书,另用 SSLCertificateChainFile 指定 DigiCertCA.crt。2.4.8 起该指令被标记过时,链应合并进 SSLCertificateFile,混用易造成链重复或顺序错乱。


不建议一步到位。先用 max-age=300 在测试环境验证,确认所有子域都支持 HTTPS 后再加 includeSubDomains 并逐步提高 max-age。一旦提交 preload 列表,回退周期以月计,且 HSTS 头只能写在 443 的 VirtualHost 里。

内容审核

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