用 Apache 给单站点配 HTTPS:从证书文件到 curl 验证走一遍

以一个监听 80 的 Apache 站点为起点,走通证书落盘、VirtualHost 配置、HTTP 跳转和验证四个环节,说清 SSLCertificateFile 该指向哪个文件、验证失败时往哪里查。

本文目录
用 Apache 给单站点配 HTTPS:从证书文件到 curl 验证走一遍

排查目录里 Nginx 的 HTTPS 配置教程已经写得不少,但 Apache 的没有。两边配置思路一样,坑的位置不同:Apache 的证书指令名字和 Nginx 对不上,模块默认也未必启用,照着 Nginx 文章改配置经常卡在这些细节上。

下面假设你有一个域名 www.example.com,80 端口的 Apache 站点已经能正常访问,证书文件(fullchain 和私钥)已经在服务器上。如果还没有证书,先看目录里 DNS-01 相关的签发教程,本文只处理部署这一段。

前置条件

  • Apache 2.4,能用 sudo apachectl configtest 和 systemctl 管理服务
  • 证书文件两份:fullchain.pem(服务器证书 + 中间证书)和 privkey.pem,路径示例用 /etc/letsencrypt/live/www.example.com/
  • 443 端口在防火墙和安全组里已放通

先确认 mod_ssl 是否启用:

apachectl -M | grep ssl

没输出的话,Debian/Ubuntu 系执行 sudo a2enmod ssl,RHEL 系安装 mod_ssl 包后重启 Apache。这一步漏了,后面配置文件里写 SSLEngine on 会直接报语法错误,错误信息还不太直白。

配置 443 VirtualHost

新建或编辑一个站点配置,加入 443 的 VirtualHost:

<VirtualHost *:443>
    ServerName www.example.com
    DocumentRoot /var/www/example

    SSLEngine on
    SSLCertificateFile      /etc/letsencrypt/live/www.example.com/fullchain.pem
    SSLCertificateKeyFile   /etc/letsencrypt/live/www.example.com/privkey.pem
</VirtualHost>

两个容易踩的点:

  • SSLCertificateFile 要指向 fullchain,不是只含服务器证书的那个文件。Apache 2.4.8 之后 SSLCertificateChainFile 已废弃,中间证书就靠 fullchain 一起带出去。只放服务器证书的后果就是目录里反复出现的那个故障:浏览器能开,curl 和 Java 客户端报链验证失败。
  • 文件路径别照抄,用 sudo ls /etc/letsencrypt/live/www.example.com/ 确认实际文件名。手动申请的证书可能叫 cert.pem 和 chain.pem,那 SSLCertificateFile 就要写成 cert.pem 再补一行指向 chain——不过更省心的做法是直接拼一个 fullchain。

80 端口跳转

把原 80 的 VirtualHost 改成跳转:

用 Apache 给单站点配 HTTPS:从证书文件到 curl 验证走一遍:DNS ownership verification using a delegated CNAME, shown as a precise handoff between two controlled zones
用 Apache 给单站点配 HTTPS:从证书文件到 curl 验证走一遍:DNS ownership verification using a delegated CNAME, shown as a precise handoff between two controlled zones查看原图
<VirtualHost *:80>
    ServerName www.example.com
    Redirect permanent / https://www.example.com/
</VirtualHost>

Redirect 来自 mod_alias,一般默认启用,不用额外装。

验证

按顺序来,每步失败就停在该步查:

sudo apachectl configtest        # 期望输出 Syntax OK
sudo systemctl reload apache2    # Debian 系;RHEL 系是 httpd

configtest 报错的常见原因:mod_ssl 没启用、证书路径写错、配置文件标签没闭合。

服务起来后验证握手:

curl -sI https://www.example.com | head -1

期望看到 HTTP/1.1 200 OK(或站点正常的其他状态码)。再用 openssl 确认发出去的证书链和有效期:

echo | openssl s_client -connect www.example.com:443 -servername www.example.com 2>/dev/null \
  | openssl x509 -noout -subject -issuer -dates

-servername 不能省——一台机器上挂多个 HTTPS 站点时,不带 SNI 的握手拿到的是默认站点的证书,会造成"证书域名不匹配"的假象。链的完整性可以用 openssl s_client 输出里的 Certificate chain 段落看,应该至少有两张证书。

边界和小坑

  • 这套步骤只覆盖单站点。一台 Apache 挂多个 HTTPS 站点时,每个 VirtualHost 各自指定证书,Apache 靠 SNI 区分;客户端太老不支持 SNI 的场景(比如极少数遗留系统)需要单独考虑。
  • 续期后记得 reload。Apache 和 Nginx 一样,证书文件更新不会自动生效,目录里那堆"续期成功却还在用旧证书"的复盘在 Apache 上同样成立。如果走 CertbotX 的 Agent 自动部署,重载动作由部署流程完成,可以在部署记录里核对每次续期是否真的落到了服务上。
  • apachectl configtest 只查语法,不验证证书文件内容和私钥是否匹配。想确认这一对是否成套,对比两个文件的 modulus 哈希:openssl x509 -noout -modulus -in fullchain.pem | md5sum 和 openssl rsa -noout -modulus -in privkey.pem | md5sum,输出一致才说明配对。

参考文档:

← 返回资讯中心