跳到主要内容
Apache

Sectigo SSL 证书 Apache 部署实战:fullchain 配置、证书链排错与验证命令

一、问题背景与根因:装完证书浏览器正常,接口却报错

Sectigo(原 Comodo CA)是目前出货量最大的商业 CA 之一,DV 证书通常几分钟内签发,OV 需 1–3 个工作日,EV 需 3–5 个工作日,OV/EV 附带较高额度的保障金(DV 为数十万美元级,OV/EV 最高可达 50 万–200 万美元级,具体以产品条款为准),通配符与多域名(UCC/SAN)方案价格优势明显。先纠正一个过时认知:自 2020 年 9 月起,CA/B 论坛规定公开信任的 SSL/TLS 证书单张有效期上限为 398 天,Sectigo 的 1 年期产品实际约 397 天;作为对照,Let’s Encrypt 免费证书有效期为 90 天。这意味着每年至少重装一次,而“续期后忘记 reload”是 Apache 环境最高频的故障。

Apache 部署失败基本归为三类根因:

  • 证书链不完整:只配了叶子证书(example.com.crt),没带中间证书。Chrome 会通过 AIA 自动补链所以显示小锁,但 curl、Java、微信小程序、iOS 原生请求会直接失败。
  • 证书与私钥不匹配:CSR 与私钥不是同一次生成,或多人协作时覆盖了 .key 文件。
  • 配置未生效:VirtualHost 未被加载(缺 a2ensite 或被 000-default 抢占)、改完没 reload、SELinux 或防火墙拦截 443。

开工前先确认环境版本,不同版本配置项差异很大:

apache2 -v      # Debian/Ubuntu,需 2.4.8 以上
httpd -v        # RHEL/CentOS/Alma/Rocky
openssl version
apache2ctl -M | grep -E 'ssl|headers'

二、准备证书文件:fullchain、私钥与中间证书的正确组织

Sectigo 签发完成后,邮件或控制台下载的压缩包通常包含三个文件:example.com.crt(站点叶子证书)、example.com.ca-bundle(中间证书,有时含交叉证书)、example.com.key(私钥,仅在你自己生成 CSR 时由你保管)。Apache 需要 PEM 文本格式,用编辑器打开应能看到 -----BEGIN CERTIFICATE----- 开头。

# 1. 建立专用目录,避免和系统自签证书混在一起
sudo mkdir -p /etc/ssl/sectigo && cd /etc/ssl/sectigo
sudo unzip ~/sectigo_example.com.zip

# 2. 合并站点证书 + 中间证书(顺序不能反:叶子在前,中间在后)
sudo cat example.com.crt example.com.ca-bundle > example.com_fullchain.crt

# 3. 校验:正常应输出 2 或 3(叶子 + 1~2 张中间证书)
grep -c "BEGIN CERTIFICATE" example.com_fullchain.crt

# 4. 确认没有把根证书打进去(根证书不应由服务端下发)
openssl crl2pkcs7 -nocrl -certfile example.com_fullchain.crt | openssl pkcs7 -print_certs -noout

权限同样关键:私钥必须 600 且属主为 root,证书 644 即可。执行 chmod 600 example.com.key && chmod 644 example.com_fullchain.crt && chown root:root example.com.key。私钥权限过宽时,部分发行版的 Apache 会拒绝加载并报 Permission denied。

另外两点提醒:一是不要用 Windows 记事本另存,容易带入 BOM 导致 no start line;二是续期时新文件建议用带日期的文件名(如 example.com_fullchain_20250601.crt)再改配置指向,出问题可秒级回滚。

三、Apache 部署实操步骤(Debian/Ubuntu 与 RHEL 双路径)

第一步装模块并放行端口。Debian/Ubuntu 用 a2enmod,RHEL 系安装 mod_ssl 包:

# Debian / Ubuntu
sudo apt update && sudo apt install -y apache2 openssl
sudo a2enmod ssl headers rewrite
sudo systemctl restart apache2

# RHEL / CentOS / AlmaLinux / Rocky
sudo dnf install -y httpd mod_ssl openssl
sudo systemctl enable --now httpd
sudo firewall-cmd --permanent --add-service=https && sudo firewall-cmd --reload

第二步写 VirtualHost。Debian 系放 /etc/apache2/sites-available/example-ssl.conf,RHEL 系放 /etc/httpd/conf.d/example-ssl.conf(内容见下一节)。

第三步启用站点并做语法检查:

sudo a2ensite example-ssl          # 仅 Debian/Ubuntu
sudo apachectl configtest          # 必须输出 Syntax OK
sudo apachectl -S                  # 确认 443 端口由目标 vhost 接管
sudo systemctl reload apache2      # RHEL: systemctl reload httpd

第四步处理 SELinux(仅 RHEL 系)。把证书放在非标准路径时,SELinux 会阻止 httpd 读取,日志表现为 403 或启动失败:

sudo semanage fcontext -a -t cert_t "/etc/ssl/sectigo(/.*)?"
sudo restorecon -Rv /etc/ssl/sectigo
ls -Z /etc/ssl/sectigo

注意 configtest 通过不等于配置生效:如果 apachectl -S 里 443 端口仍指向 000-default,说明 vhost 没被加载或被 default-ssl 抢先,此时用 a2dissite 000-default 或调整 ServerName 后再 reload。

四、完整 VirtualHost 配置示例(TLS 1.2/1.3 + HSTS + OCSP Stapling)

下面这份配置可直接复制修改,覆盖证书链、协议版本、加密套件、HSTS 与 OCSP Stapling:

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

    SSLEngine on
    SSLCertificateFile      /etc/ssl/sectigo/example.com_fullchain.crt
    SSLCertificateKeyFile   /etc/ssl/sectigo/example.com.key
    # Apache 2.4.8+ 不再需要 SSLCertificateChainFile,重复配置会告警
    # SSLCertificateChainFile /etc/ssl/sectigo/example.com.ca-bundle

    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
    SSLStaplingResponderTimeout 5
    SSLStaplingReturnResponderErrors off

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

    <Directory /var/www/example>
        Require all granted
    </Directory>
</VirtualHost>

# HTTP 强制跳转 HTTPS
<VirtualHost *:80>
    ServerName example.com
    ServerAlias www.example.com
    RewriteEngine on
    RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]
</VirtualHost>

三个易错点必须注意:

  • SSLStaplingCache "shmcb:logs/ssl_stapling(32768)" 只能写在全局配置(如 /etc/apache2/mods-enabled/ssl.conf 或 conf.d/ssl.conf),写进 VirtualHost 会报 AH00526。
  • TLS 1.3 的加密套件由 OpenSSL 管理,SSLCipherSuite 只对 TLS 1.2 及以下生效,不必强行罗列 TLS 1.3 套件名。
  • 启用 HSTS 前确认全站(含子域)都已支持 HTTPS,否则 includeSubDomains 会让未加密的子域直接不可访问,且浏览器会缓存 max-age 时长。

改完后执行 apachectl configtest && systemctl reload apache2,再用 apachectl -M | grep ssl 确认 ssl_module 已加载。

五、配置方式与证书类型对比表格

不同 Apache 版本对证书链的处理方式差异极大,这是很多老教程误导人的地方,务必按下表对号入座:

Apache 版本 证书链配置方式 注意事项
2.2.x SSLCertificateFile 叶子证书 + SSLCertificateChainFile 中间证书 ChainFile 必填,不支持 fullchain 合并写法
2.4.0 – 2.4.7 同上,ChainFile 必填 升级到 2.4.8+ 前不要改成合并写法
2.4.8 及以上 SSLCertificateFile 直接指向 fullchain ChainFile 已废弃,两项同时配置会产生告警
2.4.8+ 双证书(RSA + ECDSA) 重复书写成对的 SSLCertificateFile / SSLCertificateKeyFile 顺序必须成对匹配,否则报 AH02565

选购层面,Sectigo 三条产品线的差异如下:

对比项 DV OV EV
验证内容 仅域名控制权 域名 + 企业实名信息 域名 + 企业实名 + 扩展核验
签发时效 数分钟 1–3 个工作日 3–5 个工作日
有效期上限 398 天 398 天 398 天
浏览器展示 小锁 小锁 小锁(主流浏览器已取消绿色地址栏)
典型场景 测试环境、博客、内部系统 企业官网、电商、SaaS 金融、政企门户、合规要求场景

需要强调的是:EV 证书在 Chrome、Firefox、Safari 中已不再显示绿色公司名,其价值主要体现在企业身份背书与合规审计,不要指望视觉差异。若预算有限且只需加密传输,DV 或通配符 DV 完全够用。

六、常见错误排查(真实报错对照)

报错 1:curl: (60) SSL certificate problem: unable to get local issuer certificate
根因是服务端未下发中间证书。检查 grep -c "BEGIN CERTIFICATE" example.com_fullchain.crt 是否为 2–3,若为 1 说明只放了叶子证书,重新合并 ca-bundle 即可。

报错 2:AH02565: Certificate and private key example.com:443:0 from /etc/ssl/... do not match
证书与私钥不匹配。用模数比对确认:openssl x509 -in fullchain.crt -noout -modulus | openssl md5 与 openssl rsa -in example.com.key -noout -modulus | openssl md5,两个 MD5 必须一致。

报错 3:AH00526: Syntax error on line 8 of ...: SSLCertificateFile: file '/etc/ssl/example.com.crt' does not exist or is empty
路径写错、文件为空或权限不足。用 ls -l 核对路径,RHEL 系再用 ls -Z 检查 SELinux 上下文是否为 cert_t。

报错 4:unable to load certificate ... error:0909006C:PEM routines:get_name:no start line
文件不是 PEM 格式(可能是 DER 二进制或混入了 HTML 页面内容)。转换命令:openssl x509 -inform DER -in cert.der -out cert.pem。

报错 5:java.security.cert.CertificateException: PKIX path building failed: unable to find valid certification path to requested target
Java 客户端不自动补链。补齐 fullchain 后仍报错,则需把根证书导入 JDK 信任库:keytool -importcert -alias sectigo_root -file root.crt -keystore $JAVA_HOME/lib/security/cacerts。

报错 6:微信小程序 request:fail ssl handshake error 或 errCode:-1
通常是 TLS 版本低于 1.2、证书链不完整、域名与 SAN 不匹配三者之一。用 openssl s_client -connect example.com:443 -servername example.com -tls1_2 与 -ext subjectAltName 逐项核对。

报错 7:AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate!
OCSP Stapling 找不到签发者,多为链不完整;若链完整仍报错,是服务器出网访问 OCSP 响应者被限制,可先关闭 SSLUseStapling。

续期后不生效:先 apachectl -S 确认 vhost 指向的文件路径,再 systemctl reload apache2;若前面挂了 CDN 或反向代理,还需刷新边缘缓存,并用源站 IP 直连验证。

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

不要只看浏览器小锁,服务端视角的验证才可靠:

# 1. 证书链完整性,期望输出 Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | grep -E "Verify return code|^ *[si]:"

# 2. 有效期、颁发者与 SAN 域名
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

# 3. 协议版本:TLS 1.1 应握手失败,TLS 1.2 应成功
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null

# 4. OCSP Stapling 是否生效
openssl s_client -connect example.com:443 -servername example.com -status </dev/null | grep -A1 "OCSP Response Status"

# 5. 模拟真实客户端并指定源站 IP
curl -vI https://example.com --resolve example.com:443:203.0.113.10

# 6. Apache 侧自查
apachectl -t && apachectl -S && apachectl -M | grep ssl

判读要点:第 1 条若出现 Verify return code: 20 (unable to get local issuer certificate) 或 21 (unable to verify the first certificate),说明链仍不完整;第 3 条 TLS 1.1 握手成功则需回头检查 SSLProtocol;第 4 条若输出 OCSP Response Status: successful 说明 Stapling 生效,输出 no response sent 则是未开启或被 CDN 接管。

最后用 Qualys SSL Labs 跑一次完整评分,目标为 A 及以上;出现 B 通常是因为仍支持 TLS 1.0/1.1 或使用了 RC4、3DES 等弱套件。生产环境建议再加一条到期监控,例如 echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate 配合告警,剩余天数小于 30 天即触发续期,避免 398 天有效期到期后业务中断。

常见问题

不需要。2.4.8 起 SSLCertificateFile 可直接指向“站点证书 + 中间证书”合并的 fullchain 文件,SSLCertificateChainFile 已标记废弃,同时配置两项可能产生告警。2.2 与 2.4.8 以下版本必须单独指定 ChainFile,否则 curl、Java 会报证书链不完整。

受 CA/B 论坛规则限制,公开信任证书单张最长 398 天,Sectigo 1 年期产品实际约 397 天;作为对照,Let’s Encrypt 免费证书为 90 天。到期必须更换新证书文件并 reload Apache,建议提前 30 天续期并配置到期监控。

典型原因是证书链不完整。浏览器会通过 AIA 自动补链,而 curl、Java、微信小程序、iOS 原生网络栈不会。用 grep -c “BEGIN CERTIFICATE” fullchain.crt 检查是否为 2–3,再用 openssl s_client -showcerts 确认服务端确实下发了完整链。

分别计算模数并比对 MD5:openssl x509 -in fullchain.crt -noout -modulus | openssl md5 与 openssl rsa -in example.com.key -noout -modulus | openssl md5,两个值一致即匹配。Apache 2.4.8+ 启动时也会自动校验,不匹配会报 AH02565 并拒绝加载。

先确认配置文件指向的是新文件路径,再执行 apachectl configtest 后 systemctl reload apache2。若仍为旧证书,检查是否有多个 VirtualHost 抢占 443 端口、前面是否挂了 CDN 或反向代理缓存,最后用 openssl s_client 直连源站 IP 复核。

该错误表示 Apache 找不到证书签发者,通常是 fullchain 缺少中间证书,补齐后重启即可。若链完整仍报错,多为服务器出网 80 端口受限,无法访问 OCSP 响应者,可放行出网或暂时关闭 SSLUseStapling。

内容审核

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