跳到主要内容
Apache

SSL.com SSL 证书 Apache 部署实战:证书链、配置与排错全指南

问题背景与根因:为什么“浏览器正常、接口却报 SSL 错误”

SSL.com 是美国 CA,产品线覆盖 DV/OV/EV 与文档签名证书,企业采购流程和付款方式比较完整。把 SSL.com 签发的证书部署到 Apache 时,最常见的问题不是证书没签下来,而是证书链不完整、私钥不匹配、虚拟主机没加载,或者续期后没有 reload。浏览器通常带 AIA 补链能力,会自动下载中间证书,所以地址栏小锁可能正常;但 curl、Java、微信小程序、老 Android 不会自动补链,于是出现 curl: (60) SSL certificate problem: unable to get local issuer certificate、PKIX path building failed、request:fail ssl hand shake error。根因很明确:Apache 2.4.8+ 推荐让 SSLCertificateFile 指向 fullchain 文件,也就是“站点证书 + 中间证书”,而不是只配叶子证书;只有老版本 Apache 才需要单独的 SSLCertificateChainFile。另一个容易被忽略的过时点是有效期:按 CA/B 论坛规则,公共 TLS 证书单张最长已缩短到 398 天,Let’s Encrypt 等 ACME 证书为 90 天,续期频率明显提高,必须把 reload、到期监控和链完整性检查写进流程。除此之外,SAN 不匹配、只开 TLS 1.3 导致老客户端握手失败、HSTS 在未全站 HTTPS 时误开,也会造成“浏览器能开、程序调不通”的假象。

证书文件准备:PEM、fullchain、私钥与 CSR 的硬性规则

SSL.com 签发包通常包含站点证书 example.com.crt、中间证书 ca-bundle.crt 和私钥 example.com.key。Apache 使用 PEM 格式,文本开头应为 -----BEGIN CERTIFICATE-----。合并 fullchain 时顺序不能反:站点证书在前,中间证书在后,根证书不要放进去。可直接执行:

cat example.com.crt ca-bundle.crt > example.com_fullchain.crt
grep -c 'BEGIN CERTIFICATE' example.com_fullchain.crt
openssl x509 -in example.com_fullchain.crt -noout -subject -issuer -dates -ext subjectAltName

第二条命令输出应大于等于 2;如果只有 1,说明中间证书没合进去。接着检查私钥与证书是否匹配,现代做法是对公钥做指纹:

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

两个 MD5 必须一致。RSA 证书也可以用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 对比,但 ECDSA 证书不适用 rsa -modulus。私钥权限建议 600 root:root,证书 644。如果 CSR 是本地生成的,要确认签发时使用的私钥没有被覆盖;一旦私钥丢失,只能重新签发。证书类型上,DV 只验证域名控制权,OV 验证组织身份,EV 验证更严格,但三者加密强度相同,差异在身份审核和保险,不在算法。商业证书单张最长 398 天,Let’s Encrypt 为 90 天,部署前先看 Not After,避免刚上线就过期。

完整实操步骤:上传、权限、启用模块与虚拟主机

以下以 Ubuntu/Debian Apache 2.4 为例,RHEL/CentOS 路径和包名不同,后面单独说明。先安装工具并启用模块:

sudo apt update && sudo apt install -y apache2 openssl
sudo a2enmod ssl headers
sudo systemctl restart apache2

备份现有配置,上传证书到 /tmp 后合并并安装到系统目录:

sudo cp -a /etc/apache2/sites-available/000-default.conf{,.bak.$(date +%F)}
cat /tmp/example.com.crt /tmp/ca-bundle.crt > /tmp/example.com_fullchain.crt
sudo install -m 644 -o root -g root /tmp/example.com_fullchain.crt /etc/ssl/certs/example.com_fullchain.crt
sudo install -m 600 -o root -g root /tmp/example.com.key /etc/ssl/private/example.com.key
sudo chown root:root /etc/ssl/certs/example.com_fullchain.crt /etc/ssl/private/example.com.key
sudo chmod 644 /etc/ssl/certs/example.com_fullchain.crt
sudo chmod 600 /etc/ssl/private/example.com.key

写入虚拟主机配置后启用站点并重载:

sudo a2ensite example-ssl.conf
sudo apachectl configtest
sudo systemctl reload apache2
sudo apachectl -S

configtest 必须输出 Syntax OK;apachectl -S 用来确认 443 虚拟主机和 ServerName 没写错。RHEL/CentOS 使用 sudo dnf install -y mod_ssl openssl,证书放 /etc/pki/tls/certs/,私钥放 /etc/pki/tls/private/,配置放 /etc/httpd/conf.d/ssl.conf,重载用 sudo systemctl reload httpd。如果启用了 SELinux,执行 sudo restorecon -Rv /etc/pki/tls,否则 Apache 可能读不到私钥。防火墙也要放行:Ubuntu 用 sudo ufw allow 'Apache Full',RHEL 用 sudo firewall-cmd --add-service=https --permanent && sudo firewall-cmd --reload。最后确认 443 在监听:sudo ss -lntp | grep ':443'。

Apache 配置示例:2.4.8+ 单文件 fullchain 与旧版 ChainFile

推荐配置如下,HTTP 强制跳转 HTTPS,443 使用 fullchain 单文件。注意 HSTS 的 includeSubDomains 只在所有子域都支持 HTTPS 时加,初次上线可先把 max-age 设小一点测试:

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

<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com
    SSLEngine on
    SSLCertificateFile      /etc/ssl/certs/example.com_fullchain.crt
    SSLCertificateKeyFile   /etc/ssl/private/example.com.key
    # Apache < 2.4.8 才需要下面这行;2.4.8+ 已合并进 SSLCertificateFile
    # SSLCertificateChainFile /etc/ssl/certs/ca-bundle.crt
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite HIGH:!aNULL:!MD5:!3DES:!RC4
    SSLHonorCipherOrder off
    Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
    Header always set X-Content-Type-Options "nosniff"
    ErrorLog ${APACHE_LOG_DIR}/example-ssl_error.log
    CustomLog ${APACHE_LOG_DIR}/example-ssl_access.log combined
</VirtualHost>

关键点:Apache 2.4.8+ 如果 SSLCertificateFile 已经指向 fullchain,就不要再重复配置 SSLCertificateChainFile;老版本 Apache 2.2/2.4.8 以下必须用 SSLCertificateFile 配叶子证书、SSLCertificateChainFile 配中间证书,顺序不能反。TLS 1.3 需要 Apache 与 OpenSSL 1.1.1+ 支持,老系统上不要强行只开 TLS 1.3,否则小程序和老 Java 客户端可能握手失败。改完执行 sudo apachectl configtest,通过后再 sudo systemctl reload apache2。如果 80 和 443 写在同一个文件里,确保 a2ensite 启用的是这个文件,而不是默认站点覆盖了 ServerName。

对比表格:部署方式、证书类型与有效期选择

不同 Apache 版本的证书链配置方式不同,选错就会出现“浏览器正常、接口报错”。对照下表排查:

部署方式 适用 Apache 关键指令 主要风险
fullchain 单文件 2.4.8+ SSLCertificateFile 指向 fullchain.crt 合并时漏中间证书,链不完整
叶子证书 + ChainFile 2.4.8 以下或兼容写法 SSLCertificateFile 配叶子;SSLCertificateChainFile 配中间证书 2.4.8+ 重复配置可能告警
只配叶子证书 不推荐 SSLCertificateFile 只配 cert.crt curl/Java/小程序报 unable to get local issuer certificate

证书类型与有效期也要分清。公共 TLS 证书自 2020 年 9 月起单张最长 398 天,不要再按“两年有效期”做续期计划:

证书类型 验证内容 单张最长有效期 典型场景
DV 域名控制权 398 天 测试、普通站点、API
OV 组织身份 398 天 企业官网、业务系统
EV 严格组织验证 398 天 金融、电商(浏览器 UI 不再显著展示)
Let’s Encrypt ACME 域名控制权 90 天 自动化站点,需自动续期
SSL.com 商业证书 DV/OV/EV 398 天 企业采购、文档签名等

选择时不要误以为 OV/EV 的加密强度更高,它们与 DV 使用同样的 TLS 加密,差异在身份审核、保险和合规展示。真正影响可用性的是证书链、SAN 覆盖范围和续期自动化。SSL.com 商业证书按 398 天规则签发,Let’s Encrypt 为 90 天,建议到期前 30 天完成续期并 reload。

常见错误排查:真实报错与逐条修复

1. curl: (60) SSL certificate problem: unable to get local issuer certificate:服务端没发中间证书。检查 grep -c 'BEGIN CERTIFICATE' fullchain.crt 是否大于等于 2,用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 看返回链,修复后 reload。

2. Java 报 PKIX path building failed: unable to find valid certification path to requested target:Java 不依赖浏览器 AIA 补链,必须由服务端发送完整中间证书。先换 fullchain;若仍报错,检查 JDK 信任库是否缺根证书,可用 keytool -importcert 导入企业根或升级 JDK,不要关闭证书校验。

3. 微信小程序 request:fail ssl hand shake error:常见于只开 TLS 1.3、套件过窄或证书链不完整。用 openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 测试 TLS 1.2,确认 SSLProtocol 没有禁用 TLS 1.2,并保证域名已备案、证书 SAN 包含请求域名。

4. AH00526: Syntax error … SSLCertificateFile: file does not exist or is empty:路径写错、文件为空或权限不足。执行 ls -l /etc/ssl/certs/example.com_fullchain.crt 和 sudo apachectl configtest;RHEL 上再执行 sudo restorecon -Rv /etc/pki/tls。

5. AH02564: Failed to configure certificate … certificate and private key do not match:证书与私钥不是一对。用公钥 MD5 对比,恢复签发时对应的私钥;私钥丢失只能重签。改完必须 configtest 通过再 reload。

6. NET::ERR_CERT_COMMON_NAME_INVALID 或 no alternative certificate subject name matches target host name:SAN 没覆盖当前域名。用 openssl x509 -in fullchain.crt -noout -ext subjectAltName 检查,重新签发包含 www、api 等实际域名的证书。

7. Address already in use: AH00072: make_sock: could not bind to address [::]:443:443 被 Nginx 或其他进程占用。执行 sudo ss -lntp | grep ':443' 定位并停止冲突服务,或调整监听端口。

效果验证:openssl、curl、浏览器与日志四层验收

第一层看 Apache 自身:sudo apachectl configtest 必须输出 Syntax OK,sudo apachectl -S 确认 443 虚拟主机、ServerName 和证书路径正确。第二层验证证书链和有效期:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:443 -servername example.com -verify 5 -verify_return_error </dev/null

期望看到 Verify return code: 0 (ok),并且 issuer 是中间 CA 而不是站点证书自己。第三层用 curl 模拟非浏览器客户端:

curl -I https://example.com
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|subject:|issuer:'
curl --tlsv1.2 -I https://example.com
curl -sI https://example.com | grep -i strict-transport-security

如果 curl -I 返回 200 或 301/302,且没有证书校验错误,说明链和 SAN 基本正确。第四层看浏览器和日志:地址栏小锁正常、证书链完整、SAN 包含当前域名;在线 SSL Labs 评级达到 A 或 A+ 更稳妥。日志用 tail -f /var/log/apache2/error.log 观察握手错误,用 sudo ss -lntp | grep ':443' 确认监听。续期后不要只看文件时间,执行 openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -enddate 核对实际返回的到期日,再 systemctl reload apache2。如果前面有 CDN 或负载均衡,所有节点都要同步更新,否则不同出口会返回不同证书。

常见问题

Apache 2.4.8+ 推荐把站点证书和中间证书合并为 fullchain,SSLCertificateFile 指向它;旧版才用 SSLCertificateChainFile。只配叶子证书浏览器可能正常,但 curl、Java、小程序会报 unable to get local issuer certificate。合并顺序是站点证书在前、中间证书在后,不要放根证书。


用公钥指纹对比:openssl x509 -in fullchain.crt -noout -pubkey | openssl pkey -pubin -outform DER | openssl md5;openssl pkey -in example.com.key -pubout -outform DER | openssl md5。两个 MD5 一致才匹配。RSA 证书也可用 modulus 对比,但 ECDSA 不适用 rsa -modulus。


先确认配置指向新文件,再 apachectl configtest 通过后 systemctl reload apache2。若前面有 CDN 或负载均衡,要同步更新所有节点。用 openssl s_client -connect 域名:443 -servername 域名 | openssl x509 -noout -dates 验证实际返回的到期日,并清理本地 DNS 缓存。


Java 不依赖浏览器 AIA 补链,必须由服务端发送完整中间证书。把 fullchain 配到 Apache 后重试;若仍报错,检查 JDK 信任库是否缺少根证书,可用 keytool -importcert 导入企业根或升级 JDK,不要通过关闭证书校验解决。


该报错表示 SSLCertificateFile 与 SSLCertificateKeyFile 不是同一对。用公钥 MD5 对比确认,恢复签发时对应的私钥;若私钥丢失,只能重新签发证书。改完后 apachectl configtest 必须显示 Syntax OK,再 reload。


公共 TLS 证书单张最长 398 天,SSL.com 商业 DV/OV/EV 按此规则签发;Let’s Encrypt 为 90 天。建议到期前 30 天续期,ACME 证书在到期前 30 天自动续。续期后务必 reload Apache 并用 openssl s_client 验证新到期日。

内容审核

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