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 承载。