跳到主要内容
Apache

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 天。所谓“两年、三年证书”已不存在,只能靠自动续期维持长期可用。

内容审核

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