Linux服务器用Caddy部署网站时,自动HTTPS需要哪些前置条件?
在 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 443 | HTTP 验证失败,或 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 记录仍指向旧服务器或未配置好的 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 和证书流程大概率正常,问题转移到了反向代理后端。检查:

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



