ZeroSSL SSL 证书 Apache 安装部署教程(2025 完整版)
问题背景与根因:为什么 ZeroSSL 证书在 Apache 上“装上了却不生效”
ZeroSSL 的免费 DV 证书有效期为 90 天,支持 ACME 自动签发,网页端流程对新手友好,签发通常在几分钟内完成。下载到的压缩包里一般有三个文件:certificate.crt(站点叶子证书)、ca_bundle.crt(中间证书)、private.key(私钥)。绝大多数“部署失败”都不是签发环节的问题,而是把这三个文件用错了。
三个高频根因:
- 证书链不完整。只把
certificate.crt写进SSLCertificateFile,桌面浏览器往往仍显示小锁(Chrome/Firefox 支持 AIA 自动抓取中间证书),但curl、Java、微信小程序、部分 Android 老机型不抓 AIA,直接报证书链错误。 - Apache 版本与指令不匹配。Apache 2.4.8 起
SSLCertificateChainFile已废弃,中间证书必须拼进SSLCertificateFile指向的文件;2.2 与 2.4.8 以下才需要单独的SSLCertificateChainFile。照抄老教程会出现“配了 ChainFile 却没生效”或启动告警。 - 私钥权限与 SELinux 上下文。私钥放在
/etc/ssl/下且权限为 644,或者文件 SELinux 上下文不是cert_t,Apache 进程读不到,日志里只会给一句含糊的 SSL 初始化失败。
另外要修正一个过时认知:自 2020 年 9 月起,公共信任的 TLS 证书单张有效期上限为 398 天,CA/B 论坛后续还会继续缩短。因此“一次买两年不用管”的做法早已失效,无论 ZeroSSL 还是其他 CA,都应按 90 天(免费 DV)或 398 天上限来规划自动续期与 reload 流程。
动手前先确认证书本身没问题:
openssl x509 -in certificate.crt -noout -subject -issuer -dates
# 输出示例
# subject=CN = example.com
# issuer=C = AT, O = ZeroSSL, CN = ZeroSSL RSA Domain Secure Site CA
# notBefore=Jun 1 00:00:00 2025 GMT
# notAfter=Aug 30 23:59:59 2025 GMT
若 subject 中的域名与 ServerName 不一致,或 notAfter 已过期,后面所有配置都是白做。
证书文件准备:fullchain 拼接、权限与一致性校验
ZeroSSL 网页端下载的 zip 解压后目录结构类似 example.com/ 下含 certificate.crt、ca_bundle.crt、private.key。Apache 2.4.8+ 需要的是“叶子证书 + 中间证书”拼接后的 fullchain 文件,顺序不能颠倒:叶子在前,中间在后。
sudo mkdir -p /etc/ssl/example.com
cd /tmp/zerossl/example.com
# 拼接 fullchain:叶子证书在前,中间证书在后
cat certificate.crt ca_bundle.crt | sudo tee /etc/ssl/example.com/fullchain.crt > /dev/null
# 私钥单独存放,权限收紧
sudo install -m 600 -o root -g root private.key /etc/ssl/example.com/private.key
ls -l /etc/ssl/example.com/
# -rw-r--r-- 1 root root 3.9K fullchain.crt
# -rw------- 1 root root 1.7K private.key
三个必做校验:
# 1) 链内证书数量,应为 2(叶子 + 中间),少于 2 说明 ca_bundle 没拼进去
grep -c 'BEGIN CERTIFICATE' /etc/ssl/example.com/fullchain.crt
# 2) 私钥与证书是否配对:两次输出的 MD5 必须完全一致
openssl x509 -in /etc/ssl/example.com/fullchain.crt -noout -modulus | openssl md5
openssl rsa -in /etc/ssl/example.com/private.key -noout -modulus | openssl md5
# 3) 用 fullchain 作为信任锚验证叶子证书
openssl verify -CAfile /etc/ssl/example.com/fullchain.crt /etc/ssl/example.com/fullchain.crt
# fullchain.crt: OK
若第 2 步两个 MD5 不同,说明私钥与证书不是同一次签发的(常见于在 ZeroSSL 后台重新签发但没换私钥,或本地误覆盖),必须重新下载或重新签发,不要试图“修”。若第 3 步报 unable to get local issuer certificate,说明 ca_bundle.crt 用了交叉签名链或下载了错误套餐的包,回到 ZeroSSL 面板重新下载“Apache/Nginx 格式”的完整包。
另外注意 ZeroSSL 的 ECC 证书(ECDSA P-256)同样可用,但私钥校验命令要换成 openssl ec -in private.key -noout -text,且 Apache 需 2.4.x + OpenSSL 1.0.2 以上;混用 RSA 证书与 ECC 私钥会直接报 key values mismatch。
完整实操步骤:从加载模块到 reload 生效
以下命令在 Debian/Ubuntu(apache2 + a2ensite)与 RHEL/CentOS(httpd)上略有差异,已分别标注。
# 1) 加载必需模块(Debian/Ubuntu)
sudo a2enmod ssl headers rewrite
# RHEL/CentOS 无需 a2enmod,确认 /etc/httpd/conf.modules.d/00-ssl.conf 存在即可
# 2) 放置站点配置
sudo vim /etc/apache2/sites-available/example.com-ssl.conf
sudo a2ensite example.com-ssl
# RHEL/CentOS:直接写入 /etc/httpd/conf.d/example.com-ssl.conf
# 3) 检查配置语法(必须先跑,不能直接 restart)
sudo apachectl configtest
# Syntax OK
# 4) 平滑重载,不断开现有连接
sudo systemctl reload apache2 # RHEL/CentOS: systemctl reload httpd
# 5) 确认 443 端口在监听
sudo ss -lntp | grep ':443'
# LISTEN 0 511 *:443 *:* users:(('apache2',pid=1234,fd=6))
防火墙与 SELinux 是两大隐形坑:
# ufw
sudo ufw allow 'Apache Full' # 或 ufw allow 443/tcp
# firewalld
sudo firewall-cmd --permanent --add-service=https && sudo firewall-cmd --reload
# SELinux(RHEL/CentOS 必查)
sudo semanage fcontext -a -t cert_t '/etc/ssl/example.com(/.*)?'
sudo restorecon -Rv /etc/ssl/example.com
sudo setsebool -P httpd_can_network_connect 1 # 仅在使用 OCSP Stapling 出网时需要
getenforce # Enforcing 时务必执行上面三条
若把证书放在 /etc/pki/tls/certs 之外的自定义目录(如 /opt/certs),SELinux 默认上下文不是 cert_t,Apache 会启动失败,journalctl -u httpd -n 20 只能看到 AH02241: Init: Unable to read server certificate from file。
最后确认 80 端口有跳转规则,否则用户从 HTTP 进入仍是明文:
<VirtualHost *:80>
ServerName example.com
ServerAlias www.example.com
Redirect permanent / https://example.com/
</VirtualHost>
注意 reload 与 restart 的区别:reload 会重读证书文件并重建 SSL 上下文,正常情况下足够;但在更换私钥算法(RSA→ECC)或修改 SSLProtocol 后,个别 2.4.x 版本存在上下文未刷新的问题,此时用 restart 更稳妥。
配置示例:一份可直接套用的 443 虚拟主机
下面这份配置覆盖 TLS 1.2/1.3、HSTS、OCSP Stapling 与安全响应头,Apache 2.4.8+ 可直接使用。请把域名、路径替换成自己的。
<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
DocumentRoot /var/www/example.com
SSLEngine on
# 2.4.8+ :fullchain.crt 内已含中间证书,不要再写 SSLCertificateChainFile
SSLCertificateFile /etc/ssl/example.com/fullchain.crt
SSLCertificateKeyFile /etc/ssl/example.com/private.key
# 仅 Apache 2.2 / 2.4.8 以下需要下面这行:
# SSLCertificateChainFile /etc/ssl/example.com/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
SSLHonorCipherOrder off
SSLSessionTickets off
# OCSP Stapling:减少客户端额外查询,需服务器可出网访问 CA 的 OCSP 地址
SSLUseStapling on
SSLStaplingResponderTimeout 5
SSLStaplingReturnResponderErrors 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'
Header always set Referrer-Policy 'strict-origin-when-cross-origin'
ErrorLog ${APACHE_LOG_DIR}/example.com-ssl-error.log
CustomLog ${APACHE_LOG_DIR}/example.com-ssl-access.log combined
</VirtualHost>
</IfModule>
# OCSP 缓存必须定义在 VirtualHost 之外,否则 configtest 报 AH01980
SSLStaplingCache shmcb:/var/run/ocsp(128000)
几个容易踩的参数细节:
SSLHonorCipherOrder off:开启 TLS 1.3 后由客户端选择套件更优,强制 on 反而可能影响性能;若需兼容合规扫描要求可设为 on。SSLSessionTickets off:关闭会话票据可避免私钥泄露后历史流量被解密,代价是握手略增。- HSTS 的
max-age=31536000是一年。首次上线建议先用max-age=300观察一周,确认所有子域都能 HTTPS 后再调大并加includeSubDomains,否则回滚困难。 - 若同一台机器上有多个站点,每个
VirtualHost *:443都必须有独立的ServerName,SNI 才能正确选证书;ServerName与证书 SAN 不一致会出现AH02032告警。
改完务必 apachectl configtest,输出 Syntax OK 再 reload。
对比表格:证书类型、Apache 版本与验证方式
表 1:ZeroSSL 与主流免费/付费方案对比(价格为常见区间,以官网为准)
| 方案 | 有效期 | 验证方式 | 通配符 | ACME 自动签发 | 适用场景 |
|---|---|---|---|---|---|
| ZeroSSL 免费 DV | 90 天 | 域名(HTTP/DNS) | 支持(需 DNS 验证) | 支持 | 个人站、测试环境 |
| Let’s Encrypt DV | 90 天 | 域名 | 支持 | 原生支持 | 自动化优先的项目 |
| ZeroSSL 付费 DV | 最长 398 天 | 域名 | 支持 | 支持 | 需要更长周期与赔付保障 |
| ZeroSSL OV | 最长 398 天 | 域名 + 企业实名 | 支持 | 部分支持 | 企业官网、B 端 |
| ZeroSSL EV | 最长 398 天 | 域名 + 严格企业核验 | 支持 | 一般不支持 | 金融、支付类 |
说明:自 2020-09 起所有公共信任证书单张有效期上限为 398 天,因此表中不再出现“2 年/3 年证书”;EV 证书的绿色地址栏在主流浏览器中已取消,EV 的实际价值体现在证书主体信息与合规审计,而不是 UI 表现。
表 2:Apache 版本与 SSL 指令对应关系
| Apache 版本 | SSLCertificateFile 内容 | SSLCertificateChainFile | 注意点 |
|---|---|---|---|
| 2.2.x | 仅叶子证书 | 必需,指向 ca_bundle.crt | 不支持 TLS 1.3 |
| 2.4.7 及以下 | 仅叶子证书 | 必需 | 升级前保持分离写法 |
| 2.4.8 – 2.4.x | 叶子 + 中间证书(fullchain) | 已废弃,写了会告警 | 推荐写法 |
| 2.4.x + OpenSSL 1.1.1+ | fullchain | 不使用 | 可启用 TLS 1.3 |
验证工具层面也有差异:浏览器(Chrome/Firefox/Edge)会自动抓取 AIA 中间证书,因此“浏览器正常”不能作为链完整的判据;curl、openssl s_client、Java 的 PKIX 校验、微信小程序与 iOS 原生请求则严格校验服务器返回的链。部署后至少用 curl 与 openssl s_client 各测一次。
常见错误排查:真实报错与对应修法
1. 配置文件路径写错或文件为空
AH00526: Syntax error on line 6 of /etc/apache2/sites-enabled/example.com-ssl.conf:
SSLCertificateFile: file '/etc/ssl/example.com.crt' does not exist or is empty
原因:路径与实际文件名不一致(ZeroSSL 包内是 certificate.crt),或拼接时 tee 写到了错误目录导致 0 字节。用 ls -l 与 grep -c 'BEGIN CERTIFICATE' 确认文件非空且含 2 段证书。
2. 证书与私钥不匹配
AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate!
SSL Library Error: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch
修法:执行前文的 -modulus | openssl md5 对比。两个 MD5 不同即不配对,重新下载私钥或重新签发,不要靠改配置绕过。
3. 证书链不完整(最典型)
$ curl -vI https://example.com
curl: (60) SSL certificate problem: unable to get local issuer certificate
javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException:
PKIX path building failed: unable to find valid certification path to requested target
原因:SSLCertificateFile 只指向叶子证书。修法:改成 fullchain,或用 openssl s_client -connect example.com:443 -servername example.com -showcerts 数返回的证书段数,正常应为 2 段。
4. 续期后浏览器仍显示旧证书
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates
若 notAfter 还是旧日期:一是没 reload(Apache 只在 reload/restart 时重读文件),二是 ACME 客户端把新证书写到了别的路径(--install-cert 的 --cert-file/--key-file 目标与 Apache 配置不一致)。检查 grep -r SSLCertificateFile /etc/apache2/。
5. 多站点串证书 / SNI 告警
AH02032: Hostname example.com provided via SNI and hostname www.example.org provided via HTTP are different
原因:同一个 IP:443 上第一个 VirtualHost 被当作默认主机,客户端 SNI 与配置不匹配。修法:为每个域名建独立 VirtualHost *:443 并写全 ServerName/ServerAlias,或显式指定默认站点。
6. SELinux 阻止读取私钥
AH02241: Init: Unable to read server certificate from file /etc/ssl/example.com/fullchain.crt
(13)Permission denied: AH00035: access to / denied
修法:restorecon -Rv /etc/ssl/example.com 并确认 ls -Z 显示 cert_t;私钥权限 600 属主 root。
效果验证:五条命令确认部署真的成功
不要只看浏览器小锁,按下面顺序逐条过。
# 1) 握手与证书链(返回 2 段证书才算链完整)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE'
# 2) 协议版本与套件
openssl s_client -connect example.com:443 -servername example.com /dev/null | grep -E 'Protocol|Cipher'
# 3) 服务端证书有效期与 SAN
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -dates -ext subjectAltName
# 4) curl 严格校验(能拿到 200/301 即通过)
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com/
# 200 0 ← 第二个 0 表示校验通过
# 5) HSTS 与跳转
curl -sI https://example.com/ | grep -i strict-transport-security
curl -sI http://example.com/ | grep -i '^location'
预期结果:第 1 条输出 2;第 2 条显示 TLSv1.3 与 TLS_AES_256_GCM_SHA384 或 TLS 1.2 的 ECDHE 套件;第 3 条 notAfter 与 ZeroSSL 面板一致;第 4 条 ssl_verify_result 为 0;第 5 条能看到 max-age=31536000 与 Location: https://example.com/。
再做一次跨客户端验证,覆盖浏览器之外的调用方:
# Java 环境(小程序/后端服务常用)
keytool -printcert -sslserver example.com:443 | head -20
# 能打印出完整证书链且不报 handshake_failure 即正常
# 在线评分(可选)
# 打开 https://www.ssllabs.com/ssltest/analyze.html?d=example.com
# 目标:A 或 A+,且 Certificate Paths 显示 2 条以上可信路径
最后检查日志没有新增 SSL 告警:sudo tail -n 50 /var/log/apache2/example.com-ssl-error.log,若持续出现 AH01980(OCSP 缓存未定义)或 AH02217,说明配置仍有遗留问题,需回退到配置示例一节核对。
续期与自动化:90 天证书必须靠脚本
ZeroSSL 免费 DV 只有 90 天,手工续期迟早出事。推荐用 acme.sh 走 ZeroSSL 的 ACME 接口,与 Apache 解耦,续期后自动 reload。
# 1) 注册 ZeroSSL 账户(首次需要邮箱,acme.sh 会自动换取 EAB 凭证)
curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --register-account -m ops@example.com --server zerossl
# 2) 用 webroot 方式签发(站点需可通过 80 端口访问 /.well-known/acme-challenge/)
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com
-w /var/www/example.com --server zerossl
# 3) 安装到 Apache 路径,并挂上 reload 钩子
~/.acme.sh/acme.sh --install-cert -d example.com --server zerossl
--key-file /etc/ssl/example.com/private.key
--fullchain-file /etc/ssl/example.com/fullchain.crt
--reloadcmd 'systemctl reload apache2'
关键点:--reloadcmd 必须写,否则证书文件更新了但 Apache 进程仍持有旧上下文,表现为“文件日期是新的、线上还是旧证书”。acme.sh 安装后会自动写入 crontab(crontab -l | grep acme 可见每日检查任务),无需额外配置。
如果必须用 certbot,ZeroSSL 需要 EAB 参数:
certbot certonly --webroot -w /var/www/example.com -d example.com
--server 'https://acme.zerossl.com/v2/DV90'
--eab-kid 'XXXXXXXX' --eab-hmac-key 'YYYYYYYY'
# EAB 凭证在 ZeroSSL 面板 Developer → EAB Credentials 生成
续期后仍需验证:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates
systemctl status apache2 --no-pager | head -5
建议再加一条监控:用脚本每日比对 notAfter 与当前时间,剩余不足 21 天时告警。openssl x509 -checkend 1814400 -noout -in /etc/ssl/example.com/fullchain.crt 返回非 0 即表示即将到期,可直接接进 Zabbix/Prometheus 的文本采集。
常见问题
免费 DV 证书有效期为 90 天,不会自动续期。必须用 acme.sh 或 certbot 配置 ACME 自动任务,并在 –install-cert 时挂上 –reloadcmd ‘systemctl reload apache2’,否则文件更新了 Apache 仍用旧证书。
因为浏览器会自动按 AIA 抓取中间证书,而 curl、Java、小程序严格校验服务器返回的链。这说明 SSLCertificateFile 只配了叶子证书,需把 certificate.crt 与 ca_bundle.crt 拼成 fullchain 后重新 reload。
不需要。从 2.4.8 起该指令已废弃,中间证书必须拼进 SSLCertificateFile 指向的 fullchain 文件,再写 SSLCertificateChainFile 会告警甚至报错。只有 2.2 与 2.4.7 及以下版本才需要单独指定。
分别执行 openssl x509 -in fullchain.crt -noout -modulus | openssl md5 和 openssl rsa -in private.key -noout -modulus | openssl md5,两次输出的 MD5 必须完全一致。不一致即不配对,只能重新下载或重新签发,改配置无法解决。
先确认是否执行过 reload 或 restart,Apache 只在重载时重读证书文件;再检查 ACME 客户端写入的路径与配置里的 SSLCertificateFile 是否一致,可用 grep -r SSLCertificateFile /etc/apache2/ 排查。
受 CA/B 论坛规则限制,公共信任证书单张有效期上限为 398 天,付费 DV/OV/EV 最长按此签发;免费 DV 固定 90 天。所谓“两年、三年证书”已不存在,只能靠自动续期维持长期可用。