Linux服务器用Caddy部署网站时,自动HTTPS需要哪些前置条件?

发布人:A5数据发布时间:2026-10-28 09:55阅读量:99

在 Linux 服务器上使用 Caddy 自动启用 HTTPS,核心前提不是单独安装 Caddy,而是让“域名解析、网络端口、Caddy 服务权限和证书存储”同时满足 ACME 证书签发要求。常规公网网站应准备一个可解析到服务器的域名,并确保服务器能够接收 80、443 端口的外部访问。

首次部署时,建议先完成 DNS 和防火墙核对,再安装 Caddy、写入站点配置,最后通过日志和 HTTPS 请求确认自动证书是否签发成功。下面以 Debian/Ubuntu 使用官方软件包、域名为 example.com 的场景说明;其他发行版的安装命令应以对应的软件仓库和服务单元为准。

一、自动 HTTPS 生效前必须满足的条件

Caddy 检测到配置中的公共域名后,会自动向 ACME 证书机构申请证书,并负责后续续期。常规流程会涉及 HTTP-01 或 TLS-ALPN-01 验证,因此域名和端口必须从公网访问到当前这台服务器。

前置条件核对要求不满足时的典型表现
公共域名配置中使用 example.com 这类域名,不使用 localhost 或仅内网可解析的名称无法获得浏览器信任的公共证书
DNS 解析A 记录指向服务器 IPv4;如果存在 AAAA 记录,IPv6 也必须可用验证超时、连接到错误服务器
入站端口推荐同时放行 TCP 80 和 TCP 443HTTP 验证失败,或 HTTPS 无法访问
出站网络服务器可以解析 DNS,并通过 HTTPS 访问外部 ACME 服务Caddy 无法提交申请或续期
端口占用Caddy 能够监听 80 和 443服务启动失败,提示 address already in use
服务权限Caddy 运行账户可以读取站点文件、写入证书数据目录站点 403,或证书无法保存
系统时间系统时间和时区基本准确,并启用时间同步TLS 握手或证书验证异常
数据持久化/var/lib/caddy 等数据目录不能使用临时存储重启或重建实例后重复申请证书

公共域名与 IP 地址的边界

本文按“公共域名自动 HTTPS”部署。仅配置公网 IP、localhost、服务器主机名或内网域名时,通常不能按相同流程获得浏览器信任的公共证书。

如果需要通配符证书,例如 *.example.com,默认的 HTTP 验证方式不适用,通常需要 DNS-01 验证、DNS 服务商 API 凭据以及对应的 Caddy DNS 模块。这属于另一种部署方案,不能只把站点地址改成通配符就直接使用。

二、部署前的环境检查

1. 检查操作系统和系统时间

先确认发行版,避免将 Debian/Ubuntu 的安装命令直接用于其他系统。

cat /etc/os-release
uname -m
timedatectl status

预期结果中应能看到发行版名称、CPU 架构,以及类似下面的时间同步状态:

System clock synchronized: yes
NTP service: active

如果时间未同步,先修复系统的 NTP 或时间同步服务,不建议直接手工修改系统时间。服务器时间偏差较大时,即使证书已经签发,客户端也可能提示证书尚未生效或已经过期。

2. 核对域名的 A 和 AAAA 记录

将 example.com 替换为实际域名。若使用 www.example.com,也要单独检查该名称。

dig +short A example.com
dig +short AAAA example.com
dig +short A www.example.com
dig +short AAAA www.example.com

A 记录应返回当前服务器的公网 IPv4 地址。如果没有 IPv6 服务,通常不要保留指向错误地址的 AAAA 记录。一个常见问题是:

二、部署前的环境检查/核对域名的 A 和 AAAA 记录配图

  • A 记录已经指向新服务器;
  • AAAA 记录仍指向旧服务器或未配置好的 IPv6 地址;
  • 外部验证优先连接 IPv6,导致 Caddy 看似配置正确,但证书申请持续超时。

如果只部署主域名,Caddyfile 中不要顺手加入尚未完成 DNS 配置的 www.example.com。Caddy 会尝试为配置中的每一个域名申请证书,任何一个域名不可验证,都可能导致整组证书申请失败。

DNS 解析确认后,可以从服务器测试本机解析结果:

getent hosts example.com

如果 DNS 刚刚修改,递归 DNS 服务器仍可能缓存旧记录。此时不要连续反复重载 Caddy,应先确认不同网络或公共 DNS 的解析结果已经逐步一致。

3. 检查 80 和 443 端口

先查看本机是否已有 Web 服务占用端口:

sudo ss -lntp | grep -E ':(80|443)[[:space:]]' || true

没有输出不代表公网端口一定可达,只能说明当前主机没有显示出监听进程。如果发现 Nginx、Apache 或其他程序已经监听 80/443,应先确认它是否承担现有网站、反向代理或管理面板功能,不要直接停止服务。

云服务器还需要检查云平台安全组、网络 ACL 或边界防火墙。至少应允许:

  • 外部到服务器的 TCP 80;
  • 外部到服务器的 TCP 443;
  • 服务器向外发起 DNS 和 HTTPS 请求。

如果服务器位于 NAT 后方,还需要将公网 80/443 转发到这台 Linux 主机。仅在服务器本地放行端口,不能替代上游网关的端口转发。

使用 UFW 时的处理方式

只有确认系统正在使用 UFW,并且 SSH 管理规则已经存在时,才执行放行命令。先记录当前规则,避免后续无法判断哪些规则是新增的:

sudo ufw status numbered | tee "$HOME/ufw-before-caddy.txt"

确认 UFW 状态为 active 后,可以增加 Web 端口规则:

sudo ufw allow 80/tcp comment 'Caddy HTTP'
sudo ufw allow 443/tcp comment 'Caddy HTTPS'
sudo ufw status numbered

这两条规则的影响范围是允许所有来源访问本机的 HTTP 和 HTTPS 端口,不会改变 SSH 规则。不要在未确认 SSH 放行规则的情况下执行 ufw enable,否则可能中断远程管理。

验证时,可从另一台外部主机执行:

curl -I http://example.com

在 Caddy 尚未运行时,得到连接拒绝或超时并不奇怪;这里主要用于区分 DNS 指向和网络路径是否存在。正式部署后再根据 HTTP 重定向结果判断 Caddy 是否接管成功。

A5idc数据提供中国香港、美国、日本及新加坡等地区的物理服务器,覆盖常规建站及不同计算、存储需求,并有面向不同访问地区的线路和带宽方案。服务器的CPU、内存与SSD、NVMe存储资源,可用于承载静态网站和应用后端,为在Linux环境中部署Caddy、对外提供HTTPS网站服务提供基础设施。

三、安装 Caddy

1. Debian/Ubuntu 安装示例

以下命令适用于 Debian/Ubuntu 系列,使用 Caddy 的稳定软件仓库。执行前应确认服务器能够访问软件仓库地址。

sudo apt update
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl gnupg

curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' \
  | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg

curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' \
  | sudo tee /etc/apt/sources.list.d/caddy-stable.list

sudo apt update
sudo apt install -y caddy

安装后先确认二进制和服务单元存在:

caddy version
sudo systemctl status caddy --no-pager
sudo systemctl cat caddy

预期能看到 Caddy 版本、服务单元内容以及服务状态。Debian/Ubuntu 软件包通常使用 caddy 用户运行服务,并将主配置放在:

/etc/caddy/Caddyfile

证书、ACME 账户和其他运行数据通常位于:

/var/lib/caddy/.local/share/caddy

实际路径仍应以 systemctl cat caddy 和服务环境为准。不要先用 root 手工运行一遍 Caddy,再指望 systemd 服务自动复用 root 用户的数据目录。不同运行用户可能使用不同的数据路径,导致重复申请证书或看不到已有证书。

2. 其他 Linux 发行版

RHEL、Rocky Linux、AlmaLinux、Fedora 等系统不要直接复制上面的 apt 命令。应使用对应的 Caddy 软件仓库、发行版包管理器或经过校验的官方二进制文件。

安装后至少核验以下内容:

command -v caddy
caddy version
sudo systemctl cat caddy
sudo systemctl show caddy -p User -p ExecStart

重点确认三项:

  • Caddy 可执行文件能够被 systemd 找到;
  • 服务运行用户是谁;
  • ExecStart 使用的配置路径和数据目录是什么。

四、准备站点文件或后端服务

Caddy 可以直接提供静态文件,也可以反向代理到已经运行的应用。两者只选择一种配置方式。

静态网站

创建一个新的示例目录时,可以使用以下命令:

sudo install -d -m 0755 /var/www/example

printf '%s\n' '<!doctype html><html><body><h1>Caddy is working</h1></body></html>' \
  | sudo tee /var/www/example/index.html > /dev/null

sudo -u caddy test -r /var/www/example/index.html \
  && echo "caddy can read the site file"

这里没有递归修改已有目录的所有权,影响范围仅限新建目录和测试文件。若实际网站目录已经存在,应先检查目录各级权限:

namei -l /var/www/example/index.html

Caddy 用户需要能够穿过父目录,并读取网站文件。若读取测试失败,应针对具体目录调整权限,不要直接执行范围过大的 chmod -R 777。调整前记录原有所有者和权限,回滚时恢复原值。

反向代理网站

如果网站由 Node.js、Go、PHP 应用服务器或其他进程提供,可以先确认后端监听地址。例如后端约定监听本机 127.0.0.1:3000:

sudo ss -lntp | grep ':3000[[:space:]]' || true
curl -I http://127.0.0.1:3000

预期可以看到后端返回的 HTTP 状态码。若后端尚未启动,Caddy 仍可能成功申请证书,但访问网站时会返回 502 Bad Gateway。这说明 HTTPS 层已经工作,问题位于后端应用,不是自动证书条件不满足。

五、编写 Caddyfile 并验证配置

1. 修改前备份配置

软件包可能已经创建了默认配置。覆盖前先保存一份:

sudo cp -a /etc/caddy/Caddyfile \
  "/etc/caddy/Caddyfile.bak.$(date +%F-%H%M%S)"

如果路径不存在,应先确认 Caddy 服务单元实际使用的配置文件位置,不要凭路径猜测。

2. 静态站点配置

下面配置适用于静态网站。将 example.com 和邮箱替换为实际值;如果没有准备 www 的 DNS 记录,不要加入该域名。

{
    email admin@example.com
}

example.com {
    root * /var/www/example
    file_server
}

email 主要用于 ACME 账户联系信息,不是自动 HTTPS 的唯一开关。真正触发公共证书申请的是站点地址中的公共域名。

3. 反向代理配置

如果网站后端已经监听 127.0.0.1:3000,可以使用:

{
    email admin@example.com
}

example.com {
    reverse_proxy 127.0.0.1:3000
}

不要同时保留静态站点和反向代理的同名配置块,除非已经明确设计了路由规则。首次部署时,配置越简单,越容易判断证书问题和应用问题分别位于哪一层。

4. 校验配置语法

写入 Caddyfile 后,先只做语法和配置适配检查:

sudo caddy validate \
  --config /etc/caddy/Caddyfile \
  --adapter caddyfile

预期结果类似:

Valid configuration

如果校验失败,先修复语法错误,不要直接重启服务。常见问题包括括号缺失、域名拼写错误、指令缩进或参数格式不正确。

也可以先格式化配置,但该操作会直接修改文件,因此应在备份之后执行:

sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo caddy validate \
  --config /etc/caddy/Caddyfile \
  --adapter caddyfile

六、启动服务并验证自动 HTTPS

1. 启用并加载配置

验证通过后,让 Caddy 随系统启动。若服务已经在运行,使用 reload 可以减少中断;如果服务未运行,则启动它:

sudo systemctl enable caddy

if sudo systemctl is-active --quiet caddy; then
    sudo systemctl reload caddy
else
    sudo systemctl start caddy
fi

检查服务状态:

sudo systemctl is-active caddy
sudo systemctl status caddy --no-pager

预期第一条命令返回:

active

再检查监听端口:

sudo ss -lntp | grep -E ':(80|443)[[:space:]]'

正常情况下可以看到 Caddy 监听 IPv4 或 IPv6 的 80 和 443 端口。如果端口已经被其他服务占用,Caddy 可能在启动时失败,不能只通过重启反复尝试。

2. 查看证书申请日志

自动 HTTPS 的申请过程应结合 systemd 日志判断:

sudo journalctl -u caddy --since "10 minutes ago" --no-pager

首次申请时,日志可能包含获取证书、执行 ACME 验证或保存证书的记录。日志中的成功信息只能说明 Caddy 已经完成某一步,最终仍应通过外部 HTTPS 请求验证。

不要在证书申请失败后短时间内连续重启几十次。DNS 错误、端口不可达等问题未修复前,重复申请只会增加 ACME 限流风险。

3. 验证 HTTP 自动跳转

从服务器或外部主机访问:

curl -I http://example.com

常见预期结果为:

HTTP/1.1 308 Permanent Redirect
Location: https://example.com/

不同 Caddy 版本或请求环境可能显示 HTTP/2、HTTP/3 相关格式,但关键是响应应包含跳转到 https:// 的 Location。如果返回 200 而不是跳转,应检查是否存在自定义 HTTP 站点块、其他服务占用 80 端口,或请求实际到达了错误服务器。

4. 验证 HTTPS 和证书信息

执行:

curl -I https://example.com

网站可能返回 200、301、302 或应用自定义状态码。只要 TLS 握手成功,并且响应来自预期站点,就说明 HTTPS 层已经建立。

进一步查看证书主体、签发者和有效期:

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

预期可以看到类似以下字段:

subject=CN = example.com
issuer=...
notBefore=...
notAfter=...

-servername 参数不能省略,否则在多域名场景下可能没有发送正确的 SNI,看到的证书不一定属于目标域名。

如果配置了多个域名,还应分别验证:

curl -I https://example.com
curl -I https://www.example.com

七、常见失败情况与处理顺序

1. DNS 解析错误

如果日志或外部测试显示 NXDOMAIN、解析为空,先检查域名是否存在、A/AAAA 记录是否正确,以及 Caddyfile 中是否写入了未配置的域名。

如果 A 记录正确但仍然超时,重点检查 AAAA 记录。IPv6 记录指向不可达地址时,应修复 IPv6 路由,或者删除错误的 AAAA 记录后等待缓存更新。

2. 80 或 443 无法从公网访问

不同错误有不同含义:

  • connection timed out:通常是安全组、防火墙、NAT 或上游网络丢弃连接;
  • connection refused:通常是目标主机可达,但没有服务监听该端口;
  • 返回了其他网站内容:DNS 指向了旧服务器,或端口被其他 Web 服务接管;
  • 80 正常、443 失败:重点检查 443 的安全组、UFW 规则和 Caddy 监听状态。

先从外到内检查云防火墙,再检查主机防火墙,最后检查本机监听状态。不要一开始就删除所有防火墙规则。

3. 端口已被 Nginx 或 Apache 占用

如果端口冲突,先确认现有服务是否承载线上网站:

sudo ss -lntp | grep -E ':(80|443)[[:space:]]'
sudo systemctl list-units --type=service --state=running \
  | grep -E 'nginx|apache2|httpd|caddy'

处理方式通常有三种:

  • 让 Caddy 作为唯一入口,停用原有 Web 服务;
  • 保留原有入口,由它转发到 Caddy 或后端;
  • 让 Caddy 改用其他端口,但这种方式不适合常规自动 HTTPS,因为 ACME 验证仍依赖标准端口。

不要在不了解业务的情况下执行 systemctl stop nginx 或 systemctl stop apache2。停止服务会影响所有依赖该入口的站点,操作前应准备现有配置备份和恢复命令。

4. 证书可以申请,但网站返回 502

这表示 Caddy 的 HTTPS 和证书流程大概率正常,问题转移到了反向代理后端。检查:

七、常见失败情况与处理顺序/证书可以申请,但网站返回 502配图

curl -I http://127.0.0.1:3000
sudo journalctl -u caddy --since "10 minutes ago" --no-pager

重点核对后端是否正在运行、监听地址是否写错、应用是否只监听 IPv6 或其他端口。Caddy 连接 127.0.0.1:3000 时,后端必须确实监听该地址和端口。

5. Caddy 无法写入证书数据

如果日志出现权限错误,先确认服务运行用户和数据目录:

sudo systemctl show caddy -p User
sudo systemctl cat caddy
sudo ls -ld /var/lib/caddy /var/lib/caddy/.local /var/lib/caddy/.local/share

不要直接对整个 /var/lib 执行递归开放权限。应根据服务单元确认数据目录,再只修复对应目录的所有者和权限。修复前记录原有权限,避免影响系统中其他服务。

6. 出现 ACME 限流

如果日志出现 rate limit、too many requests 等信息,先停止无意义的重复重载,修复 DNS、端口或域名配置后再等待窗口恢复。连续删除证书目录并重试不能解决验证失败,反而可能造成更多重复申请。

八、验收与回滚检查项

验收清单

  • dig 查询结果中的 A 记录指向当前服务器;
  • 不存在指向错误地址的 AAAA 记录;
  • 云安全组和主机防火墙允许 TCP 80、443;
  • caddy validate 返回有效配置;
  • systemctl is-active caddy 返回 active;
  • Caddy 正确监听 80 和 443;
  • http://域名 跳转到 https://域名;
  • HTTPS 请求能够完成 TLS 握手;
  • 证书的主体或 SAN 包含实际访问域名;
  • 静态文件可读,或反向代理后端返回正常响应;
  • /var/lib/caddy 等证书数据目录位于持久化磁盘;
  • 重启 Caddy 后,配置和证书仍然能够加载。

配置回滚

如果新配置导致 Caddy 无法加载,先恢复部署前备份的 Caddyfile。将下面的备份路径替换为实际文件名:

sudo cp -a /etc/caddy/Caddyfile.bak.YYYY-MM-DD-HHMMSS \
  /etc/caddy/Caddyfile

sudo caddy validate \
  --config /etc/caddy/Caddyfile \
  --adapter caddyfile

sudo systemctl reload caddy
sudo systemctl status caddy --no-pager

如果需要完全退出 Caddy 并恢复原有 Web 服务,应先停止 Caddy,确认 80/443 已释放,再启动原服务:

sudo systemctl stop caddy
sudo systemctl disable caddy
sudo ss -lntp | grep -E ':(80|443)[[:space:]]' || true

只有确认原有 Nginx、Apache 或其他入口服务此前可用时,才继续启动对应服务。不要在回滚过程中删除 /var/lib/caddy,其中可能包含 ACME 账户和已签发证书数据;删除这些数据并不能修复 DNS 或端口问题,还可能导致后续重复申请。

如果回滚防火墙规则,只删除本次新增且确认不再被其他网站使用的 80/443 规则,并对照部署前保存的规则记录操作。DNS 回滚同样需要考虑 TTL 和缓存,修改后不会立即让所有网络恢复到旧地址。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/6167.html

相关推荐