Apache 配置 SSL 证书完整教程(mod_ssl):模块启用、证书链合并与排错
问题背景与根因:Apache 配了证书为什么还报错
在 Apache 上启用 SSL 并不只是把 .pem 和 .key 路径写进 VirtualHost。常见故障可以归为五类:mod_ssl 未加载、443 虚拟主机未被匹配、证书链不完整、证书 SAN 与 ServerName 不一致、私钥权限或 SELinux 拦截。TLS 握手时,客户端不仅校验证书签名,还会沿着中间证书构建到受信任根的链路;如果服务器只发送站点证书,桌面浏览器可能因为缓存过中间证书而显示正常,但 curl、Java、Android 旧版本会报 unable to get local issuer certificate。另一个高频问题是旧教程仍要求 SSLCertificateChainFile:Apache 2.4.8 起该指令已废弃,站点证书和中间证书应合并到 SSLCertificateFile,Let’s Encrypt 的 fullchain.pem 就是这种格式。有效期也要注意:公有 CA 签发的 TLS 证书此前最长 398 天,按 CA/Browser Forum SC-081 从 2026-03-15 起降为 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天;Let’s Encrypt 目前仍为 90 天。任何手工续期方案都会很快过期,必须配置自动续期和到期监控。建议排查顺序:apachectl configtest 看语法,apachectl -t -D DUMP_VHOSTS 看 443 是否命中,openssl s_client -showcerts 看链,curl -I 看 HTTP 层,最后查权限和 SELinux。
完整实操步骤一:启用 mod_ssl、headers 并确认 443 监听
先区分发行版。Debian/Ubuntu 使用 apache2,RHEL/CentOS/Rocky/AlmaLinux 使用 httpd。操作前备份 /etc/apache2 或 /etc/httpd。
# Debian/Ubuntu
sudo apt update
sudo apt install -y apache2 openssl
sudo a2enmod ssl headers rewrite
sudo apache2ctl -M | grep -E 'ssl|headers|rewrite'
sudo systemctl restart apache2
# RHEL/CentOS/Rocky/AlmaLinux
sudo dnf install -y httpd mod_ssl openssl
sudo httpd -M | grep -E 'ssl|headers|rewrite'
sudo systemctl enable --now httpd
sudo systemctl restart httpd
如果输出中没有 ssl_module,不要继续写 SSLEngine,否则会报 Invalid command ‘SSLEngine’。确认监听与防火墙:
sudo ss -lntp | grep -E ':80|:443'
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload
# Ubuntu ufw
sudo ufw allow 'Apache Full'
还要确认 NameVirtualHost 不需要手动配置(Apache 2.4 默认按 IP:端口 匹配),并检查是否存在默认的 000-default.conf 抢占 443。用 apachectl -S 查看 vhost 排序。若使用云负载均衡,后端 Apache 可能只监听 80,SSL 在 LB 终止,此时不要在 Apache 上强行 443。启用模块后先 reload 而不是 restart,只有新增模块或改 Listen 才 restart。记录 Apache 版本,2.4.8 是证书链配置的分水岭:
apache2ctl -v
httpd -v
openssl version
Apache 2.4.36+ 配合 OpenSSL 1.1.1 才建议启用 TLSv1.3;老版本写 +TLSv1.3 会导致 configtest 失败。此步骤完成后,再准备证书文件。
完整实操步骤二:生成 CSR、申请证书与合并 fullchain
商业 CA 通常要求 CSR。以下命令生成 2048 位 RSA 私钥和带 SAN 的 CSR,-addext 需要 OpenSSL 1.1.1+:
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
chmod 600 example.com.key
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
把 CSR 交给 CA 后,会得到站点证书和中间证书。合并顺序必须是站点证书在前、中间证书在后,不要放根证书:
cat example.com.crt intermediate.crt > example.com-fullchain.pem
openssl x509 -in example.com-fullchain.pem -noout -subject -issuer -dates
openssl verify -untrusted intermediate.crt example.com.crt
Let’s Encrypt 更简单,certbot 会直接生成 fullchain.pem 和 privkey.pem:
sudo apt install -y certbot python3-certbot-apache
sudo certbot --apache -d example.com -d www.example.com
sudo certbot renew --dry-run
ls -l /etc/letsencrypt/live/example.com/
证书路径通常为 /etc/letsencrypt/live/example.com/fullchain.pem 与 privkey.pem。fullchain.pem 已包含中间证书,直接用于 SSLCertificateFile。注意证书有效期:Let’s Encrypt 为 90 天,必须保留 certbot.timer 或 cron;公有 CA 证书此前最长 398 天,2026-03-15 后上限变为 200 天,之后还会缩短。私钥权限建议 root:root 600,Apache 以 root 启动后降权读取,若使用不同用户需确保可读。SELinux 系统执行 restorecon -Rv /etc/ssl 或设置正确上下文。最后用 openssl x509 -checkend 2592000 检查是否在 30 天内到期,纳入监控。
配置示例:Apache 2.4 虚拟主机 SSL 最小可用配置
下面配置适用于 Apache 2.4.8+,使用 fullchain 合并证书。将文件放到 /etc/apache2/sites-available/example-ssl.conf 或 /etc/httpd/conf.d/example-ssl.conf:
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
DocumentRoot /var/www/html
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
# Apache < 2.4.8 才需要,2.4.8+ 已废弃:
# SSLCertificateChainFile /etc/letsencrypt/live/example.com/chain.pem
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
Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains" env=HTTPS
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"
</VirtualHost>
关键点:SSLCertificateFile 指向 fullchain.pem,而不是单独的站点证书;SSLCertificateKeyFile 指向私钥;如果 Apache 是 2.4.8 以下,才保留 SSLCertificateChainFile 并指向中间证书。TLSv1.3 需要 Apache 2.4.36+ 与 OpenSSL 1.1.1+,老环境删掉 +TLSv1.3。SSLCipherSuite 只影响 TLS 1.2 及以下,TLS 1.3 套件由 OpenSSL 管理。HSTS 先不要直接上一年,建议测试期用 max-age=300,确认所有子域 HTTPS 正常后再提高;includeSubDomains 和 preload 不可轻易回退。Header 指令需要 mod_headers。若使用 certbot –apache,它会自动生成类似配置,但可能保留旧的 SSLCertificateChainFile,需人工核对。保存后不要 reload,先执行下一节检查。
配置示例:HTTP 强制跳转 HTTPS、HSTS 与 TLS 加固
80 端口虚拟主机负责跳转,443 端口负责服务。推荐用 Rewrite 保留原始 Host 和 URI:
<VirtualHost *:80>
ServerName example.com
ServerAlias www.example.com
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
</VirtualHost>
若所有域名统一跳到主域,可用 Redirect permanent / https://example.com/。注意反代场景:如果 Apache 前面有 Nginx、HAProxy 或云 LB 终止 TLS,%{HTTPS} 可能一直是 off,需要判断 X-Forwarded-Proto,并只信任来自 LB 的 IP:
RewriteCond %{HTTP:X-Forwarded-Proto} !https
RewriteCond %{REMOTE_ADDR} ^10[.]0[.]0[.]10$
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
HSTS 只能通过 HTTPS 响应下发,放在 443 vhost 或用 env=HTTPS 限制。首次上线建议:
Header always set Strict-Transport-Security "max-age=300" env=HTTPS
观察一周无混合内容、无 HTTP 子站问题后改为 31536000;确认所有子域都支持 HTTPS 再加 includeSubDomains。OCSP stapling 可提升握手效率,在全局配置中加:
SSLUseStapling on
SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"
如果报 AH02217: ssl_stapling_init_cert: can’t retrieve issuer certificate,通常是证书链不完整或 DNS 解析失败,先修 fullchain 再开 stapling。TLS 加固还包括禁用 SSLv3、TLSv1.0、TLSv1.1,关闭弱套件,开启 TLSv1.3。不要盲目开 SSLCompression(现代版本已默认关闭)。用 apachectl configtest 验证指令是否被当前版本支持。
对比表格:证书链配置方式与证书类型怎么选
先看证书链文件组织方式。Apache 2.4.8 是分界线,新环境应统一使用合并 fullchain:
| 方式 | 配置指令 | 适用版本 | 优点 | 风险 |
|---|---|---|---|---|
| 分离证书链 | SSLCertificateFile 站点证书 + SSLCertificateChainFile 中间证书 | Apache < 2.4.8 | 兼容旧版 | 2.4.8+ 已废弃,多文件易漏配 |
| 合并 fullchain | SSLCertificateFile 指向站点证书+中间证书 | Apache 2.4.8+ 推荐 | 单文件、Let’s Encrypt 原生、迁移简单 | 顺序错会链不完整 |
| 只配站点证书 | 仅 SSLCertificateFile | 所有版本 | 配置最少 | 缺中间证书,curl/Java 报 unable to get local issuer certificate |
再看证书类型与有效期。DV 适合博客、API、测试;OV 适合企业官网和 SaaS;EV 的浏览器特殊 UI 已弱化,但金融行业仍可能要求。自签名只用于内网测试。
| 类型 | 验证方式 | 典型有效期 | 适用场景 |
|---|---|---|---|
| DV | 域名控制验证 | Let’s Encrypt 90 天;商业 CA 最长 398 天,2026-03-15 后 200 天 | 博客、API、内部测试 |
| OV | 组织身份验证 | 同上限 | 企业官网、SaaS |
| EV | 扩展验证 | 同上限 | 金融、强品牌 |
| 自签名 | 无第三方验证 | 自定义 | 内网测试,浏览器不信任 |
选择建议:公网服务优先 Let’s Encrypt 或商业 DV/OV,并自动化续期;不要购买多年期证书,因为 CA 仍按上限签发,续期仍要处理。内部服务可用私有 CA,但要把根证书推送到客户端信任库。证书链完整性与证书类型无关,任何类型都必须配置中间证书。
常见错误排查:从 AH00526 到 unable to get local issuer certificate
下面按真实报错给出定位命令。先看 Apache 错误日志:tail -f /var/log/apache2/error.log 或 /var/log/httpd/ssl_error_log。
- Invalid command ‘SSLEngine’:mod_ssl 未启用。Debian 执行 sudo a2enmod ssl;RHEL 执行 sudo dnf install -y mod_ssl;用 apache2ctl -M | grep ssl 或 httpd -M | grep ssl 确认。
- AH00526: Syntax error … SSLCertificateFile: file … does not exist or is empty:路径错、文件空、权限不足或 SELinux 拦截。执行 ls -l、namei -l 逐级看权限;sudo -u www-data test -r 文件;SELinux 用 sudo restorecon -Rv /etc/ssl 和 sudo ausearch -m avc -ts recent 查看拒绝。
- AH01909: RSA certificate configured for example.com:443 does NOT include an ID which matches the server name:ServerName 与证书 SAN 不一致。用 openssl x509 -in fullchain.pem -noout -text | grep -A1 ‘Subject Alternative Name’ 核对,补 ServerAlias 或重签证书。
- curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书。用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 看链,只有一张证书就是缺链;合并 fullchain 后 reload。
- SSL_ERROR_RX_RECORD_TOO_LONG:用 https 访问了 80 端口,或反代把 HTTPS 流量转成 HTTP。检查 ss -lntp | grep 443、防火墙、LB 监听和 X-Forwarded-Proto。
- AH02032: Hostname … provided via SNI and hostname … provided via HTTP are different:SNI 与 Host 头不一致。检查 ServerName/ServerAlias,客户端是否用 IP 访问,或中间设备改写 Host。
- certificate has expired or is not yet valid:续期失败或系统时间错。执行 openssl x509 -noout -dates,certbot renew –dry-run,systemctl status certbot.timer,并检查 NTP。
排查时先 configtest 再 reload,不要带错重启生产。若报 AH02217,先关 OCSP stapling 或补全链证书。权限问题不要用 chmod 777,私钥保持 600。
效果验证:configtest、openssl s_client、curl 与 SSL Labs
配置改完先做语法检查,再平滑重载:
sudo apachectl configtest
sudo apachectl -t -D DUMP_VHOSTS
sudo systemctl reload apache2 # RHEL 用 httpd
sudo ss -lntp | grep ':443'
configtest 必须输出 Syntax OK。然后用 openssl 验证证书链和协议:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep -E 'Protocol|Cipher|Verify return code'
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null | grep -E 'Protocol|Cipher'
关键看 Verify return code: 0 (ok),以及输出中是否包含站点证书和中间证书。检查到期时间与 SAN:
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -subject -issuer -dates
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -checkend 2592000
curl -I https://example.com
curl -vI https://example.com 2>&1 | grep -E 'SSL connection|TLSv|subject|issuer|strict-transport-security'
curl 应返回 HTTP/2 200 或 HTTP/1.1 200,且响应头含 strict-transport-security。若 curl 报证书错误,加 -k 只能临时确认服务可达,不能作为验收。浏览器验证看锁标志、证书链、SAN 和有效期。最后用 SSL Labs 或 testssl.sh 做外部评分:
nmap --script ssl-enum-ciphers -p 443 example.com
docker run --rm -it drwetter/testssl.sh https://example.com
目标应为 A 或 A+,无 TLS 1.0/1.1,无弱套件。若使用 CDN,先确认回源证书和边缘证书都正确。把 openssl 检查、到期提醒和 certbot renew –dry-run 加入监控,才算完成。
常见问题
不需要。该指令从 2.4.8 起已废弃,应把站点证书和中间证书按顺序合并到 SSLCertificateFile,Let’s Encrypt 的 fullchain.pem 可直接使用;只有老版本 Apache 才保留 ChainFile。
公有 CA 此前最长 398 天;按 SC-081 从 2026-03-15 起降为 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。Let’s Encrypt 目前仍为 90 天,必须配置自动续期和到期监控。
执行 cat example.com.crt intermediate.crt > fullchain.pem,站点证书在前、中间证书在后,不要放根证书;然后让 SSLCertificateFile 指向 fullchain.pem,configtest 通过后 reload。
优先 apachectl configtest 后执行 systemctl reload apache2 或 httpd,平滑加载配置;只有新增模块、修改 Listen 端口或 MPM 变更时才需要 restart。
运行 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,看到 Verify return code: 0 (ok) 且输出含中间证书;curl -I 不报 unable to get local issuer certificate 即可。
建议先用 max-age=300 验证所有子域 HTTPS 可用,再逐步提高;includeSubDomains 和 preload 不可轻易撤销,确认无 HTTP 子站后再加。