跳到主要内容
Apache

Let’s Encrypt SSL 证书 Apache 安装部署教程:fullchain、自动续期与报错排查

问题背景与根因:为什么 Apache 部署 Let’s Encrypt 后仍报证书链错误

Let’s Encrypt 是免费 DV 证书,当前仍为 90 天有效期,通过 ACME 客户端(certbot、acme.sh、Win-ACME)自动完成 CSR、域名验证、签发与续期。Apache 部署失败通常不是证书没签发,而是文件选错或服务未重载:浏览器能容忍部分链问题,curl、Java、微信小程序、Android 旧版本会直接报 unable to get local issuer certificate 或 PKIX path building failed。根因包括:只部署了 leaf 证书 cert.pem 而未部署 fullchain.pem;Apache 2.4.8 以下未配置 SSLCertificateChainFile;SNI 多站点指向了默认证书;续期后未 reload;系统时间偏差;中间证书过期。还需注意公开信任 TLS 证书最长有效期为 398 天(CA/B 论坛规则),Let’s Encrypt 90 天更短,旧教程中的 825 天已不适用。部署前先确认 Apache 版本与证书文件:apache2 -v 或 httpd -v,ls -l /etc/letsencrypt/live/example.com/,重点看 fullchain.pem、privkey.pem、chain.pem、cert.pem 四个文件。不要把 privkey.pem 放在 Web 根目录,权限建议 600,属主 root。若使用 CDN 或负载均衡,证书应同时部署在边缘节点和回源链路,否则会出现边缘正常、回源 526 或 502。先定位是链不完整、私钥不匹配还是配置未生效,再进入实操。

完整实操步骤:用 Certbot 申请并部署到 Apache(命令可直接执行)

以 Debian/Ubuntu 为例,先安装 Certbot 与 Apache 插件,启用 SSL、Headers、Rewrite 模块。命令如下:

sudo apt update
sudo apt install -y certbot python3-certbot-apache
sudo a2enmod ssl headers rewrite
sudo systemctl reload apache2
sudo certbot --apache -d example.com -d www.example.com --redirect
sudo certbot renew --dry-run

Certbot 会自动生成 CSR 与私钥,签发后写入 /etc/letsencrypt/live/example.com/。若不想让 Certbot 改 Apache 配置,用 webroot 模式:

sudo mkdir -p /var/www/html/.well-known/acme-challenge
sudo certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
sudo apachectl configtest
sudo systemctl reload apache2

检查文件:

sudo ls -l /etc/letsencrypt/live/example.com/
sudo openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -subject -issuer -dates

续期由 systemd timer 或 cron 触发,Certbot 包通常已自带 certbot.timer。执行 systemctl list-timers | grep certbot 确认。若使用 acme.sh,签发命令为 acme.sh –issue -d example.com -w /var/www/html,安装命令为 acme.sh –install-cert -d example.com –key-file /etc/ssl/example.com.key –fullchain-file /etc/ssl/example.com_fullchain.crt –reloadcmd ‘systemctl reload apache2’。注意:CSR、私钥、fullchain 必须成对保存;不要把 cert.pem 当 fullchain 用;reload 不是 restart,但配置大改时用 restart。最后 apachectl configtest 必须返回 Syntax OK。

配置示例:Apache 443 虚拟主机与证书链写法

Apache 2.4.8+ 推荐把 SSLCertificateFile 指向 fullchain.pem,私钥指向 privkey.pem,无需再写 ChainFile。示例:

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

<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com
    SSLEngine on
    SSLCertificateFile      /etc/letsencrypt/live/example.com/fullchain.pem
    SSLCertificateKeyFile   /etc/letsencrypt/live/example.com/privkey.pem
    SSLProtocol             all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite          HIGH:!aNULL:!MD5:!3DES
    Header always set Strict-Transport-Security max-age=31536000
    DocumentRoot /var/www/html
</VirtualHost>

Apache 2.2 或 2.4.8 以下需要单独链文件:

SSLCertificateFile      /etc/letsencrypt/live/example.com/cert.pem
SSLCertificateKeyFile   /etc/letsencrypt/live/example.com/privkey.pem
SSLCertificateChainFile /etc/letsencrypt/live/example.com/chain.pem

保存后执行 sudo apachectl configtest,返回 Syntax OK 再 sudo systemctl reload apache2。若开启 HSTS,先确保全站 HTTPS 与子域可用,否则 max-age 会把浏览器锁死。多域名站点用 ServerAlias 或独立 VirtualHost,但每个 443 VirtualHost 必须配置对应证书;没有 SNI 的旧客户端会命中默认站点。检查虚拟主机:apachectl -S。若使用 CDN,回源证书也要按 fullchain 配置,否则边缘回源校验失败。

文件与参数对比:fullchain、chain、leaf、privkey 怎么选

Let’s Encrypt 目录下四个文件最容易混用。对比表如下:

文件 内容 Apache 2.4.8+ 指令 旧版指令 误用后果
fullchain.pem 站点证书 + 中间证书 SSLCertificateFile 可拆为 cert + chain 正确推荐
cert.pem 仅站点 leaf 证书 不单独用于公网 SSLCertificateFile curl/Java 报链不完整
chain.pem 中间证书链 2.4.8+ 一般不用 SSLCertificateChainFile 与 cert 配错顺序会失败
privkey.pem 私钥 SSLCertificateKeyFile SSLCertificateKeyFile 泄露即证书失效,权限应 600

参数选择原则:公网 HTTPS 优先 fullchain.pem;只有旧版 Apache 才把 cert.pem 与 chain.pem 分开;私钥必须与证书模数一致;不要手工编辑 fullchain 顺序,必须 leaf 在前、中间证书在后。证书有效期方面,Let’s Encrypt 为 90 天,公开信任 TLS 证书上限为 398 天,二者不冲突;398 天是监管上限,不是 Let’s Encrypt 的签发时长。若使用 acme.sh 安装到 /etc/ssl,建议文件名带域名和 fullchain 标识,例如 example.com_fullchain.crt,避免续期脚本覆盖错文件。配置中路径必须绝对路径,相对路径在 reload 后可能因工作目录变化失效。多证书站点可用 apachectl -S 查看每个 VirtualHost 命中的证书文件,再用 openssl x509 -in 文件 -noout -subject 核对域名。

常见错误排查:真实报错与定位命令

报错 1:curl: (60) SSL certificate problem: unable to get local issuer certificate。说明服务端未发送中间证书,检查 SSLCertificateFile 是否误用 cert.pem。验证:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,输出中应看到 leaf 后跟中间证书;若只有一张,改用 fullchain.pem。报错 2:Java 或小程序 PKIX path building failed,处理同上,并检查客户端信任库是否包含根证书。报错 3:证书与私钥不匹配,Apache 启动报 SSL Library Error: 185073780 key values mismatch。核对模数:

openssl x509 -noout -modulus -in /etc/letsencrypt/live/example.com/cert.pem | openssl md5
openssl rsa -noout -modulus -in /etc/letsencrypt/live/example.com/privkey.pem | openssl md5

两个 md5 必须一致。报错 4:续期成功但浏览器仍旧证书,通常是未 reload 或 CDN 未更新;执行 systemctl reload apache2,再 openssl s_client 看 notAfter。报错 5:apachectl configtest 报 Invalid command SSLCertificateChainFile,说明 Apache 2.4.8+ 已弃用该指令或模块未启用,改用 fullchain 或启用 ssl 模块。报错 6:AH00526: Syntax error on line,检查证书路径权限,Let’s Encrypt live 目录是软链,Apache 用户需可读 /etc/letsencrypt/archive 与 live。日志看 tail -f /var/log/apache2/error.log 或 /var/log/httpd/ssl_error_log。排查顺序:先 configtest,再 s_client,再模数,再 reload,最后查 CDN/负载均衡。

续期与自动化:systemd timer、reload 钩子与监控

Certbot 安装包通常自带 certbot.timer。检查与启用:

systemctl status certbot.timer
systemctl list-timers | grep certbot
sudo certbot renew --dry-run
sudo certbot renew --deploy-hook 'systemctl reload apache2'

deploy-hook 只在证书实际续期后执行,适合 reload Apache;不要写成 pre-hook 里 reload。若用 acme.sh:

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

监控建议:用 openssl s_client -connect example.com:443 -servername example.com </dev/null | openssl x509 -noout -enddate 获取到期日,接入 Zabbix/Prometheus blackbox_exporter;也可用 certbot certificates 查看所有证书与到期时间。常见续期失败:HTTP-01 验证 404,检查 /.well-known/acme-challenge 是否可访问;301 跳转导致验证失败,需在 80 端口放行 challenge;防火墙只开 443,需临时开 80 或改用 DNS-01;权限问题导致 reload 失败,检查 systemd 服务权限。续期后必须确认进程加载新证书:systemctl reload apache2 后再次 openssl s_client 看 notAfter 是否更新。若使用负载均衡,多节点都要部署并 reload,不能只更新一台。

安全加固与兼容性:TLS 版本、HSTS 与旧客户端取舍

Let’s Encrypt 证书本身不决定 TLS 版本,Apache 配置决定。建议启用 TLS 1.2/1.3,禁用 SSLv3、TLS 1.0、TLS 1.1;但若有旧 Android、旧 Java 客户端,需评估兼容性。示例:SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1;SSLCipherSuite HIGH:!aNULL:!MD5:!3DES;SSLHonorCipherOrder on。HSTS 只在全站 HTTPS 且子域可 HTTPS 时开启,Header always set Strict-Transport-Security max-age=31536000;不要一开始加 includeSubDomains 和 preload。OCSP Stapling 可减握手延迟:SSLUseStapling on,SSLStaplingCache shmcb:/var/run/ocsp(128000),并确保服务器可访问 OCSP 响应者。证书最长有效期 398 天是公开信任证书上限,Let’s Encrypt 90 天更短,自动化比手工续期更重要。私钥权限 600,属主 root;不要提交到 Git;备份 /etc/letsencrypt 时包含 account 与 renewal 配置。多域名和通配符证书需 DNS-01 验证,通配符只匹配一级子域。最后用 apachectl configtest 和 systemctl reload apache2 落地,任何加固变更后重新跑 openssl s_client 验证。

效果验证:浏览器、openssl 与自动续期三重检查

第一重浏览器:访问 https://example.com,确认锁标志、证书主体、颁发者 Let’s Encrypt、有效期。第二重命令行:

curl -I https://example.com
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null

输出中 Verify return code 应为 0 (ok),证书链应包含 leaf 与中间证书。第三重续期:sudo certbot renew –dry-run 必须成功;systemctl list-timers | grep certbot 查看下次触发;若用 acme.sh,执行 acme.sh –cron –home ~/.acme.sh 测试。再检查 HSTS 与跳转:curl -sI https://example.com | grep -i strict-transport-security;curl -sI http://example.com 应返回 301 或 308。用 apachectl -S 确认 443 虚拟主机命中正确 ServerName。外部可用 SSL Labs 或 openssl s_client -connect 目标 IP:443 检查。若前面有 CDN,分别验证边缘与回源:curl –resolve example.com:443:回源IP https://example.com -k -I。最后记录证书 notAfter,设置到期前 30 天告警;Let’s Encrypt 90 天证书不要等到最后一天才续期,自动续期失败常见原因是 80 端口验证被防火墙拦截或 Web 根目录 301 跳转。

常见问题

Let’s Encrypt 当前签发 90 天 DV 证书;398 天是 CA/B 论坛对公开信任 TLS 证书的最长有效期上限,不是 Let’s Encrypt 的实际签发时长。旧教程里的 825 天已过时。建议用 certbot 或 acme.sh 自动续期,并在到期前 30 天监控。


优先把 SSLCertificateFile 指向 fullchain.pem,它包含站点证书和中间证书;SSLCertificateKeyFile 指向 privkey.pem。2.4.8+ 一般不再单独写 SSLCertificateChainFile。只有旧版 Apache 才用 cert.pem 加 chain.pem 分开配置。


先执行 systemctl reload apache2 让进程加载新文件,再用 openssl s_client -connect example.com:443 -servername example.com 查看 notAfter。若前面有 CDN 或负载均衡,需同步更新边缘证书并刷新缓存;只更新源站不会改变浏览器看到的证书。


这是证书链不完整,常见于只部署了 cert.pem。把 Apache 的 SSLCertificateFile 改为 fullchain.pem,旧版则补 SSLCertificateChainFile 指向 chain.pem,然后 apachectl configtest 和 reload。再用 openssl s_client -showcerts 确认返回 leaf 加中间证书。


支持,但必须用 DNS-01 验证,不能只用 HTTP-01。certbot 可加 –manual –preferred-challenges dns 或使用 DNS 插件;acme.sh 可用 –issue –dns。通配符只覆盖一级子域,例如 *.example.com 不覆盖 a.b.example.com。

内容审核

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