跳到主要内容
Apache

TrustAsia(亚洲诚信)SSL 证书 Apache 部署实战:证书链配置、排错与验证

一、问题背景与根因:浏览器出现小锁,为什么 curl 和 Java 仍报错

大量运维同学在 Apache 上装完 TrustAsia(亚洲诚信)证书后,用浏览器访问看到小锁就认为部署完成,结果同一条域名在 curl、Java 后端、微信小程序、Android 低版本 WebView 中全部握手失败。根因基本集中在三处。

(1)证书链不完整。TrustAsia 的公开信任证书由 DigiCert 授权的根签发,典型链路是“站点证书 → TrustAsia RSA DV TLS CA G2(中间 CA)→ DigiCert Global Root CA”。Apache 2.4.8 之前的 SSLCertificateFile 只接受单张站点证书,中间证书必须通过 SSLCertificateChainFile 单独给出;2.4.8 及以后才支持把站点证书与中间证书拼进同一个 PEM。只配叶子证书时,浏览器会按证书里的 AIA 地址自动补链,所以“看起来正常”;而 curl(OpenSSL 后端)、Java、Python requests 默认不做 AIA 抓取,直接报 unable to get local issuer certificate。

(2)协议与套件过时。TLS 1.0/1.1 已被主流浏览器移除,沿用旧模板里的 SSLProtocol all -SSLv3 并配上 RC4/3DES 套件,现代客户端会出现 SSL_ERROR_NO_CYPHER_OVERLAP。

(3)有效期与续期管理。CA/Browser Forum 规定公开信任 TLS 证书最长有效期 398 天,2026 年 3 月 15 日起缩短至 200 天,后续再降至 100 天、47 天;Let’s Encrypt 则固定 90 天。证书到期或续期后没有 reload Apache,进程仍持有旧证书的内存副本。

先确认环境版本,后续所有配置都以版本为前提:

httpd -v
# Server version: Apache/2.4.57 (Unix)
openssl version
# OpenSSL 3.0.13 30 Jan 2024

记住关键分界:Apache 2.4.8。低于它必须用 SSLCertificateChainFile;高于它推荐 fullchain 单文件方案。

二、准备证书文件:PEM、fullchain 与私钥的正确组合

TrustAsia 签发完成后,控制台下载包或邮件里通常有四个文件:

  • example.com.crt:站点(叶子)证书,PEM 格式,以 -----BEGIN CERTIFICATE----- 开头;
  • ca_bundle.crt 或 example.com_ca.crt:中间证书,可能包含 1~2 张;
  • example.com.key:私钥,PKCS#1(BEGIN RSA PRIVATE KEY)或 PKCS#8(BEGIN PRIVATE KEY)均可;
  • example.com.csr:申请时生成的 CSR,部署不需要,但续期时建议保留。

合并顺序必须是“叶子在前、中间在后”,顺序颠倒会导致部分客户端构建链失败:

cat example.com.crt ca_bundle.crt > example.com_fullchain.crt
grep -c "BEGIN CERTIFICATE" example.com_fullchain.crt
# 输出应为 2 或 3(叶子证书 + 中间证书数量)

本地校验证书链与有效期:

openssl verify -untrusted ca_bundle.crt example.com.crt
# example.com.crt: OK

openssl x509 -in example.com.crt -noout -subject -issuer -dates -ext subjectAltName

校验证书与私钥是否匹配(RSA):

openssl x509 -in example.com.crt -noout -modulus | openssl md5
openssl rsa  -in example.com.key -noout -modulus | openssl md5
# 两行 md5 必须完全一致

ECDSA 证书改用公钥比对:openssl x509 -in example.com.crt -noout -pubkey | openssl md5 与 openssl pkey -in example.com.key -pubout | openssl md5。

放置文件并收紧权限,私钥目录只允许 root 读取:

install -m 644 example.com_fullchain.crt /etc/ssl/certs/
install -m 600 -o root -g root example.com.key /etc/ssl/private/
restorecon -Rv /etc/ssl   # SELinux 环境必须执行

不要使用带 Passphrase 的加密私钥,否则每次 Apache 启动都要交互输入口令,无法随系统自启动。

三、实操步骤:启用模块、写入 VirtualHost 并重载

Debian/Ubuntu 系:

apt update && apt install -y apache2
a2enmod ssl headers rewrite
a2ensite example.com-ssl
apachectl configtest && systemctl reload apache2

RHEL/CentOS/Rocky 系:

dnf install -y mod_ssl
systemctl enable --now httpd
# 配置文件直接放到 /etc/httpd/conf.d/example.com-ssl.conf

放行端口与 SELinux 上下文:

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

semanage fcontext -a -t cert_t "/etc/ssl/private(/.*)?"
restorecon -Rv /etc/ssl

语法检查与重载的区别必须分清:

操作 命令 适用场景 是否断开连接
语法检查 apachectl configtest 任何改动之后先执行 不适用
优雅重载 systemctl reload apache2 改证书、改 VirtualHost、改 Header 否
完全重启 systemctl restart apache2 改 Listen 端口、加载新模块、改 MPM 是

一个高频问题:a2enmod ssl 会同时启用 default-ssl 模板,模板里的 SSLSessionCache、SSLStaplingCache 是 server config 级指令,如果把它们写进 <VirtualHost>,configtest 会直接报 SSLSessionCache: cannot occur within <VirtualHost> section。正确做法是把全局指令放进 /etc/apache2/conf-available/ssl-params.conf 并执行 a2enconf ssl-params,只 include 一次。

四、配置示例:HTTP 跳转、HSTS、OCSP Stapling 与 TLS 1.2/1.3

全局参数文件(Debian 放 /etc/apache2/conf-available/ssl-params.conf,RHEL 放 /etc/httpd/conf.d/ssl-params.conf):

SSLStaplingCache            "shmcb:logs/ssl_stapling(32768)"
SSLUseStapling              on
SSLStaplingResponderTimeout 5
SSLStaplingReturnResponderErrors off

80 端口强制跳转:

<VirtualHost *:80>
    ServerName   example.com
    ServerAlias  www.example.com
    RewriteEngine On
    RewriteRule  ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
</VirtualHost>

443 端口主配置:

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

    SSLEngine on
    SSLCertificateFile    /etc/ssl/certs/example.com_fullchain.crt
    SSLCertificateKeyFile /etc/ssl/private/example.com.key
    # Apache < 2.4.8 才需要下面这行:
    # SSLCertificateChainFile /etc/ssl/certs/ca_bundle.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

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

要点说明:

  • SSLCipherSuite 只作用于 TLS 1.2 及以下,TLS 1.3 的套件由 OpenSSL 自动管理;
  • SSLHonorCipherOrder off 让客户端优先选择,移动端握手更快;
  • HSTS 的 includeSubDomains 必须先确认所有子域都已上 HTTPS,否则子域会直接无法访问;preload 更需谨慎,一旦提交很难回退;
  • Apache 2.4.8+ 不要再同时配置 SSLCertificateChainFile 与 fullchain,否则中间证书会被重复下发。

改完后执行:

apachectl configtest
# Syntax OK
systemctl reload apache2

五、对比表格:版本差异、证书类型与验证工具

表 1:Apache 版本与证书指令对应关系

Apache 版本 站点证书指令 中间证书指令 推荐做法
2.2.x SSLCertificateFile SSLCertificateChainFile 两个指令分开配置
2.4.8 以下 SSLCertificateFile SSLCertificateChainFile 分开配置,勿合并
2.4.8 及以上 SSLCertificateFile(可含链) 合并进同一文件 单文件 fullchain
2.4.8 及以上(分离式) SSLCertificateFile SSLCertificateChainFile 仍可用,但已不推荐

表 2:证书类型与 Apache 配置要点

证书类型 覆盖范围 Apache 配置要点
单域名 DV/OV example.com ServerName 精确匹配
多域名 SAN 一张证书最多 100 个域名 ServerName + ServerAlias,或按 SNI 拆多个 VirtualHost
通配符 *.example.com(仅一级) 不覆盖 a.b.example.com,需加 SAN 或单独申请

表 3:验证工具对照

工具 命令 可发现的问题
openssl s_client openssl s_client -connect example.com:443 -servername example.com -showcerts 链顺序、协议版本、套件
curl curl -vI https://example.com 应用侧信任链是否完整
Java keytool keytool -printcert -sslserver example.com:443 JVM truststore 是否缺根
SSL Labs https://www.ssllabs.com/ssltest/ 综合评级与兼容性

表 4:有效期与续期节奏

证书来源 当前最长有效期 续期建议
公开信任 CA(含 TrustAsia) 398 天(2026-03-15 起 200 天) 到期前 30 天完成重签
Let’s Encrypt 90 天 到期前 30 天自动续期

六、常见错误排查:真实报错与对应命令

报错 1:AH02565: Certificate and PrivateKey example.com:443:0 from /etc/ssl/certs/example.com_fullchain.crt and /etc/ssl/private/example.com.key do not match

私钥与证书不配对,或 fullchain 里第一张不是站点证书。用第二节的 modulus md5 比对;并确认 fullchain 首张证书的 subject 与 ServerName 一致。

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

证书链不完整。检查 SSLCertificateFile 是否指向 fullchain;Apache 2.4.8 以下检查是否漏配 SSLCertificateChainFile。

报错 3:javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed

同样说明证书链缺失;或 JDK 8 早期版本的 cacerts 中没有 DigiCert Global Root CA,可导入根证书或升级 JDK。

报错 4:AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate!

缺少中间证书导致 OCSP Stapling 无法初始化。先补齐 fullchain,再开启 SSLUseStapling on;若上游 CA 不提供 OCSP 响应,可关闭 stapling。

报错 5:AH00526: Syntax error on line 12 of /etc/apache2/sites-enabled/example.com-ssl.conf: SSLSessionCache: cannot occur within <VirtualHost> section

全局指令误写进 VirtualHost,移到 ssl-params.conf 后重新 configtest。

报错 6:SSL_ERROR_NO_CYPHER_OVERLAP 或 sslv3 alert handshake failure

协议/套件不匹配。用 openssl s_client -connect example.com:443 -tls1_1 复现,确认 SSLProtocol 已禁用 TLS 1.0/1.1。

报错 7:SSL received a record that exceeded the maximum permissible length

用 https 访问了 80 端口,或反向代理把明文请求转发到 443。检查 apachectl -S 输出的端口映射。

报错 8:浏览器返回 403,错误日志出现 avc: denied { read } for ... ssl

SELinux 上下文错误,执行 restorecon -Rv /etc/ssl,或用 ausearch -m avc -ts recent 定位。

报错 9:续期后浏览器仍显示旧证书

忘记 reload;或配置仍指向旧文件名;若前面有 CDN/SLB,还需在云平台侧更新证书。

七、效果验证:五条命令确认部署真的成功

1. 检查虚拟主机解析:

apachectl -S
# 确认 *:443 对应 example.com,且 SSLCertificateFile 路径正确

2. 检查服务端下发的完整链:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E "^ *[is]:"
# i: 行应依次出现站点证书、中间 CA,最后是根 CA(可选)

3. 检查协议与套件:

openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# 预期失败:no protocols available 或 handshake failure
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null
# 预期成功

4. 检查应用侧信任与到期时间:

curl -sSI https://example.com | head -1
# HTTP/2 200

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates -checkend 2592000
# notAfter=...;30 天内到期时 checkend 返回非 0

5. 检查 OCSP Stapling 与 HSTS:

openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -A1 "OCSP Response Status"
# OCSP Response Status: successful (0x0)

curl -sI https://example.com | grep -i strict-transport-security
# strict-transport-security: max-age=31536000; includeSubDomains

最后用 SSL Labs 跑一次完整评估,目标评级 A 或 A+。若出现 “Chain issues: Incomplete”,回到第二节重新合并 fullchain;若出现 “Certificate is not valid for the domain”,检查 ServerName/ServerAlias 与证书 SAN 是否一致。

八、续期与自动化:398 天之后不要靠记忆

TrustAsia 证书当前最长有效期 398 天,2026 年 3 月 15 日起缩短到 200 天,后续还会继续压缩。建议在到期前 30 天完成重签,并把“替换文件 + configtest + reload + 验证”写成脚本:

#!/usr/bin/env bash
set -euo pipefail
DOMAIN=example.com
install -m 644 /tmp/${DOMAIN}_fullchain.crt /etc/ssl/certs/${DOMAIN}_fullchain.crt
install -m 600 -o root -g root /tmp/${DOMAIN}.key /etc/ssl/private/${DOMAIN}.key
apachectl configtest
systemctl reload apache2
echo | openssl s_client -connect ${DOMAIN}:443 -servername ${DOMAIN} 2>/dev/null 
  | openssl x509 -noout -subject -enddate

监控侧用 -checkend 做告警,剩余天数低于 30 天即触发:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -checkend 2592000 || echo "证书将在 30 天内到期"

注意事项:

  • 重签时建议重新生成 CSR(openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr),避免复用旧私钥;
  • 替换文件后必须 apachectl configtest,配置错误时 reload 会失败但旧进程仍在跑,容易误判为“已生效”;
  • 使用 systemctl reload 而非 restart,避免中断在线连接;
  • 前置 CDN、WAF、SLB 时,证书要在每一层同步更新,否则边缘节点仍返回旧证书;
  • 多台后端批量替换时,用 Ansible 等工具统一分发并逐台执行验证命令。

常见问题

不需要。根证书(DigiCert Global Root CA)已内置于操作系统和浏览器信任库,你只需部署站点证书与中间证书。把叶子证书和 ca_bundle 合并成 fullchain 后由 SSLCertificateFile 指向即可,额外下发根证书反而会增加握手体积。


不能。2.4.8 之前的 SSLCertificateFile 只读取第一张证书,必须额外配置 SSLCertificateChainFile 指向中间证书文件。若只配 fullchain,服务端只会下发叶子证书,curl 与 Java 会报 unable to get local issuer certificate。


先确认新文件已覆盖旧路径,再执行 apachectl configtest 与 systemctl reload apache2,因为 Apache 进程会把证书缓存在内存中。若前置了 CDN 或负载均衡,还需在云平台控制台同步更新证书,否则边缘节点仍返回旧证书。


几乎都是证书链不完整:浏览器会按 AIA 地址自动补链,JVM 不会。检查 SSLCertificateFile 是否指向 fullchain;另外 JDK 8 早期版本的 cacerts 可能缺少 DigiCert Global Root CA,可导入根证书或升级 JDK。


不建议贸然添加。preload 会把域名写入浏览器内置列表,要求所有子域长期只走 HTTPS,一旦有子域回退到 HTTP 就会直接不可访问,且从列表移除需要数月。先只配 max-age=31536000,稳定运行数月后再评估。


不能。*.example.com 只匹配 a.example.com 这一级,不匹配 a.b.example.com。若业务存在多级子域,需要在签发时把这些域名加入 SAN 列表,或为对应层级单独申请通配符证书,并在 Apache 中用 ServerAlias 或独立 VirtualHost 承载。

内容审核

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