跳到主要内容
Apache

ZeroSSL 证书 Apache 部署实战:fullchain 配置、证书链排查与自动续期

ZeroSSL 签发的 DV 证书在 Apache 上部署并不复杂,但真正让人卡住的往往是证书链不完整、私钥权限错误和 90 天续期失效这三类问题。本文从根因讲到命令级实操,覆盖 Apache 2.2 与 2.4 的配置差异、可复制的 VirtualHost 示例、真实报错定位,以及 acme.sh 自动续期方案。

一、问题背景与根因:为什么“浏览器有锁、接口却报错”

ZeroSSL 免费 DV 证书有效期为 90 天,签发完成后网页控制台会给出三个文件:certificate.crt(站点叶子证书)、ca_bundle.crt(中间证书,通常是 Sectigo/UserTrust 的中间 CA)、private.key(私钥)。绝大多数部署失败的原因在于只把 certificate.crt 写进了 SSLCertificateFile,并非私钥配错。

浏览器(Chrome、Firefox、Safari)内置 AIA Fetching 机制,遇到证书链不完整时会主动下载中间证书补齐,所以你看到的是正常小锁;而 curl、Java HttpClient、Python requests、微信小程序、Android OkHttp 不做这件事,会直接抛错:

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

这条报错九成以上指向链不完整。第二个根因是 Apache 版本差异:Apache 2.2 必须用 SSLCertificateChainFile 单独指定中间证书;2.4.8 起该指令被标记为废弃,官方推荐把中间证书直接拼接进 SSLCertificateFile。若在 2.4.8+ 上继续写 ChainFile,configtest 会给出废弃警告。

第三个根因是有效期管理。CA/Browser Forum 规定公开信任的 TLS 证书最长有效期为 398 天,Chrome 与 Safari 强制执行这一上限;ZeroSSL 免费 DV 只发 90 天,Let’s Encrypt 同样是 90 天。纯手工部署的站点一年内必然过期,表现为浏览器报 NET::ERR_CERT_DATE_INVALID。因此本文在配置之外,还会给出 acme.sh 自动续期与 reload 钩子的完整方案。

二、准备证书文件:合并 fullchain、校验私钥与权限

先把三个文件集中到受控目录,避免散落在下载目录导致路径混乱:

sudo mkdir -p /etc/ssl/zerossl
sudo cp certificate.crt ca_bundle.crt private.key /etc/ssl/zerossl/
cd /etc/ssl/zerossl

拼接 fullchain,顺序必须是“叶子证书在前、中间证书在后”,顺序反了同样会报链错误:

sudo cat certificate.crt ca_bundle.crt > example.com_fullchain.crt

校验拼接后的链是否可用:

openssl verify -untrusted ca_bundle.crt certificate.crt
# certificate.crt: OK

查看证书主体、签发者、有效期与 SAN 列表:

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

统计链中证书数量,正常是 2;ZeroSSL 走交叉签名时可能是 3:

grep -c "BEGIN CERTIFICATE" example.com_fullchain.crt

校验私钥与证书是否配对。RSA 证书用模数对比:

openssl x509 -noout -modulus -in example.com_fullchain.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key           | openssl md5

两个 md5 必须完全一致。如果私钥是 ECDSA,上面第二条会报 Not an RSA key,改用公钥对比:

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

最后收紧权限,私钥只允许 root 读取:

sudo chown root:root example.com.key
sudo chmod 600 example.com.key
sudo chmod 644 example.com_fullchain.crt

私钥权限若为 644 或 777,部分发行版的 Apache 会拒绝加载并报 AH02203: Init: Private key not found。这一步做完再动配置文件,能省掉大量无效排查。

三、完整实操步骤:启用模块、写 VirtualHost、configtest、reload

Debian/Ubuntu 先启用依赖模块并确认加载状态:

sudo a2enmod ssl headers rewrite
sudo apache2ctl -M | grep -E "ssl|headers|rewrite"

RHEL/Rocky/Alma 走 mod_ssl 包:

sudo dnf install -y mod_ssl
sudo systemctl enable --now httpd
sudo httpd -M | grep ssl_module

改动前先备份原配置,出问题能秒回滚:

sudo cp /etc/apache2/sites-available/000-default.conf /root/000-default.conf.bak

写入站点配置。Debian 系放 /etc/apache2/sites-available/example.com-ssl.conf,RHEL 系放 /etc/httpd/conf.d/example.com-ssl.conf,指令完全相同:

sudo vim /etc/apache2/sites-available/example.com-ssl.conf

Debian 系还需启用站点:

sudo a2ensite example.com-ssl

语法检查是必做步骤,只有输出 Syntax OK 才继续:

sudo apache2ctl configtest
# Syntax OK

平滑重载,不中断现有连接:

sudo systemctl reload apache2

如果 reload 报 Job for apache2.service failed,立即看日志定位:

sudo journalctl -u apache2 -n 50 --no-pager
sudo tail -n 50 /var/log/apache2/error.log

最常见的三行是 AH00558(ServerName 未设置)、AH02559(证书文件内容不对)、AH02203(私钥路径或权限错)。RHEL 系的检查命令是 sudo apachectl configtest,重载用 sudo systemctl reload httpd。注意:修改 SSLProtocol、SSLCipherSuite 这类指令必须 reload 才生效,只改文档根目录同样 reload 即可,不必 restart。

四、可直接套用的配置示例(含跳转、HSTS、OCSP Stapling)

下面这份配置已在 Apache 2.4 上验证可用,80 端口做 301 跳转,443 端口启用 TLS 1.2/1.3 与现代套件:

<VirtualHost *:80>
    ServerName example.com
    ServerAlias www.example.com
    RewriteEngine On
    RewriteCond %{HTTPS} !=on
    RewriteRule ^/?(.*) https://%{SERVER_NAME}/$1 [R=301,L]
</VirtualHost>

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

    SSLEngine on
    SSLCertificateFile    /etc/ssl/zerossl/example.com_fullchain.crt
    SSLCertificateKeyFile /etc/ssl/zerossl/example.com.key

    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"
    Header always set X-Content-Type-Options "nosniff"
    Header always set Referrer-Policy "strict-origin-when-cross-origin"

    <Directory /var/www/example>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog  ${APACHE_LOG_DIR}/example_error.log
    CustomLog ${APACHE_LOG_DIR}/example_access.log combined
</VirtualHost>

# 全局指令,必须写在 VirtualHost 之外
SSLStaplingCache shmcb:/var/run/ocsp(128000)

几个必须注意的点:TLS 1.0/1.1 已被主流浏览器标记为不安全,这里用 -all 直接关闭;HSTS 首次上线只写 max-age,不要立刻加 includeSubDomains 与 preload,否则某个仍走 HTTP 的子域会让用户被锁死一年;SSLStaplingCache 是全局指令,写进 VirtualHost 会报 AH02206: SSLStaplingCache is not allowed here;如果前面挂了 CDN,CDN 侧也要上传 fullchain,否则边缘节点到源站这一段仍可能报链错误。

五、对比表格:版本差异、有效期与 CA 选型

先看 Apache 版本与证书链写法,这是最容易踩坑的地方:

Apache 版本 中间证书配置方式 相关指令 备注
2.2.x 单独文件 SSLCertificateChainFile 必须配置,否则 curl 报错
2.4.0 – 2.4.7 单独文件 SSLCertificateChainFile 与 2.2 相同
2.4.8 及以上 合并进证书文件 SSLCertificateFile ChainFile 已废弃
2.4.8+ 误用 ChainFile 可工作但告警 SSLCertificateChainFile 不推荐

再看有效期上限与续期节奏:

证书类型 有效期上限 建议续期节点 适用场景
公开信任 DV/OV/EV 398 天 到期前 30 天 所有公网站点
ZeroSSL 免费 DV 90 天 第 60 天 个人站、测试环境
Let’s Encrypt 90 天 第 60 天 通用站点

最后是 ZeroSSL 与 Let’s Encrypt 的选型对比:

维度 ZeroSSL 免费 DV Let’s Encrypt
有效期 90 天 90 天
验证方式 HTTP-01 / DNS-01 HTTP-01 / DNS-01 / TLS-ALPN-01
常用客户端 acme.sh、ZeroSSL 面板 certbot、acme.sh
单证书 SAN 数 以套餐为准 100
可视化面板 有 无
通配符证书 支持(DNS-01) 支持(DNS-01)

结论:如果团队没有成熟的自动化运维体系,ZeroSSL 的网页面板对新手更友好;如果有 CI/Ansible 流水线,两者都能用 acme.sh 统一管理。注意 acme.sh 从 2021 年起默认 CA 已切换为 ZeroSSL,若你要签发 Let’s Encrypt 证书,必须显式加 --server letsencrypt,否则会发现证书签发来源与预期不符。

六、常见错误排查:6 条真实报错与定位命令

1. curl: (60) SSL certificate problem: unable to get local issuer certificate
原因:服务器只发送了叶子证书。验证命令:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | grep -c "BEGIN CERTIFICATE"

输出为 1 说明链缺失,输出 2 或以上才正常。修复方式是重新拼接 fullchain 并 reload。

2. AH02559: The SSLCertificateFile directive does not contain a certificate
原因:SSLCertificateFile 指向了私钥、空文件,或 PEM 头被编辑器破坏。用 head -1 example.com_fullchain.crt 确认第一行是 -----BEGIN CERTIFICATE-----。

3. AH02203: Init: Private key not found 或 AH02564: Failed to configure encrypted (?) private key
原因:私钥路径错,或私钥带 passphrase 导致 Apache 启动时卡住等待输入。用 openssl rsa -in example.com.key -check 检查。

4. AH01909: example.com:443:0 server certificate does NOT include an ID which matches the server name
原因:ServerName 与证书 SAN 不一致。用 openssl x509 -in example.com_fullchain.crt -noout -ext subjectAltName 核对,补上缺失的 ServerAlias。

5. AH02032: Hostname example.com provided via SNI and hostname www.example.com provided via HTTP are different
原因:SNI 与 Host 头不一致,多发生在反向代理或 CDN 回源场景。检查回源 Host 配置与 ServerName/ServerAlias 是否对齐。

6. curl: (7) Failed to connect to example.com port 443: Connection refused
原因:安全组或防火墙未放行 443,或 Apache 未监听。用 sudo ss -lntp | grep :443 确认监听状态,再检查 firewall-cmd --list-ports。

7. 续期成功但站点仍是旧证书
用 echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates 看到期时间。常见原因是 reloadcmd 未执行、配置指向路径与 acme.sh 安装路径不一致(手工部署用 /etc/ssl/zerossl/,acme.sh 却装到 /root/.acme.sh/),或 CDN 缓存了旧证书。

七、效果验证:openssl、curl、testssl.sh 三件套

部署完成后按顺序执行以下验证,任何一步不通过都不要急着上线。

第一,完整握手并输出证书链,重点看 Verify return code:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
# 关键输出:Verify return code: 0 (ok)

第二,核对证书主体、签发者与到期时间:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates

第三,确认旧协议已关闭,TLS 1.1 握手应当失败:

openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null

第四,检查 OCSP Stapling 是否生效:

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

第五,检查 HSTS 头与 HTTP 跳转:

curl -sI https://example.com | grep -i strict-transport-security
curl -sI http://example.com | head -3
# 期望:301 Moved Permanently 且 Location 指向 https

第六,用系统 CA 库做严格校验,模拟 Java 与小程序的校验行为:

curl -vI https://example.com --cacert /etc/ssl/certs/ca-certificates.crt

最后跑 testssl.sh 做全面体检:

git clone --depth 1 https://github.com/drwetter/testssl.sh.git
cd testssl.sh && ./testssl.sh --fast https://example.com

重点看 Certificate Validation、Chain of Trust、Protocols 三段,全部 OK 才算通过。再用浏览器打开 SSL Labs 输入域名,评级 A 或 A+ 为合格;只拿到 B 通常是因为仍支持 TLS 1.0/1.1,或启用了 RC4、3DES 等弱套件。

八、自动续期:acme.sh 接 ZeroSSL 并自动 reload Apache

90 天有效期的证书必须自动化,否则第 91 天必然事故。acme.sh 是零依赖的纯 Shell 客户端,适合与 Apache 配合。

curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc

acme.sh 默认 CA 已是 ZeroSSL,显式设置一次更保险:

~/.acme.sh/acme.sh --set-default-ca --server zerossl

用 webroot 方式签发,要求 80 端口对外可达:

~/.acme.sh/acme.sh --issue -d example.com -d www.example.com --webroot /var/www/example

安装证书到固定路径,并挂上 reload 钩子,这是自动续期能生效的关键:

~/.acme.sh/acme.sh --install-cert -d example.com --key-file /etc/ssl/zerossl/example.com.key --fullchain-file /etc/ssl/zerossl/example.com_fullchain.crt --reloadcmd "systemctl reload apache2"

确认定时任务已写入:

crontab -l | grep acme.sh
# 15 0 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null

演练一次续期流程,不真正签发:

~/.acme.sh/acme.sh --renew -d example.com --dry-run

要点:--install-cert 会把证书复制到指定路径,之后每次续期自动覆盖并执行 reloadcmd,所以 Apache 配置里应永远指向这个固定路径,不要指向 ~/.acme.sh 目录下的软链。如果服务器无法开放 80 端口,改用 DNS-01 验证,例如 --dns dns_ali(阿里云)或 --dns dns_cf(Cloudflare),需先在环境变量中配置对应的 API Key。

常见问题

免费 DV 证书有效期为 90 天,建议在第 60 天完成自动续期,留出 30 天缓冲。用 acme.sh 的 cron 任务配合 –reloadcmd 挂上 Apache reload,续期后无需手工干预。


不需要。Apache 2.4.8 起该指令已废弃,把中间证书拼接进 fullchain 后由 SSLCertificateFile 一并加载即可。只有 2.2 及 2.4.8 以下版本必须单独指定 ChainFile。


几乎都是证书链不完整。浏览器会通过 AIA Fetching 自动补齐中间证书,而 curl、Java、小程序严格校验链,缺少中间 CA 就报 unable to get local issuer certificate。把 ca_bundle.crt 拼进 fullchain 即可解决。


公开信任的 TLS 证书最长有效期为 398 天,由 CA/Browser Forum 规定,Chrome 与 Safari 强制执行。ZeroSSL 免费 DV 与 Let’s Encrypt 都只签发 90 天,因此必须做自动化续期。


先用 openssl s_client 查看到期时间确认。常见原因是 reloadcmd 未执行、Apache 配置路径与 acme.sh 安装路径不一致,或 CDN 缓存了旧证书。执行 systemctl reload apache2 并核对配置路径。


关闭 TLS 1.0/1.1,配置 SSLProtocol -all +TLSv1.2 +TLSv1.3,禁用 RC4 与 3DES,启用 HSTS 和 OCSP Stapling,并确保证书链完整。多数 B 评级来自协议过旧或链不完整。

内容审核

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