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 评级来自协议过旧或链不完整。