跳到主要内容
Apache

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。

  1. Invalid command ‘SSLEngine’:mod_ssl 未启用。Debian 执行 sudo a2enmod ssl;RHEL 执行 sudo dnf install -y mod_ssl;用 apache2ctl -M | grep ssl 或 httpd -M | grep ssl 确认。
  2. 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 查看拒绝。
  3. 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 或重签证书。
  4. 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。
  5. SSL_ERROR_RX_RECORD_TOO_LONG:用 https 访问了 80 端口,或反代把 HTTPS 流量转成 HTTP。检查 ss -lntp | grep 443、防火墙、LB 监听和 X-Forwarded-Proto。
  6. AH02032: Hostname … provided via SNI and hostname … provided via HTTP are different:SNI 与 Host 头不一致。检查 ServerName/ServerAlias,客户端是否用 IP 访问,或中间设备改写 Host。
  7. 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 子站后再加。

内容审核

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