韩国服务器部署Caddy时,如何配置域名、HTTPS并验证反向代理
在韩国服务器上首次部署 Caddy,可以把目标限定为一件事:让 app.example.com 指向服务器,由 Caddy 接收公网 HTTP/HTTPS 请求,再转发给本机已有的 Web 应用。完成后,访问该域名应获得有效的 HTTPS 连接,并看到应用返回的内容,而不是 Caddy 的默认页面。
下面以 Ubuntu 24.04、应用监听 127.0.0.1:3000 为例。命令中的 app.example.com 和 203.0.113.10 都是示例,执行时分别换成自己的域名和韩国服务器公网 IPv4 地址。本文只配置单个站点的首次运行;若服务器已经承载其他网站,不要直接覆盖现有 Caddyfile 或变更现有端口规则。
准备域名、应用和网络入口
开始安装前,先核对三条请求路径:域名能解析到这台服务器;公网可以访问服务器的 TCP 80、443 端口;Caddy 所在主机能访问后端应用的 127.0.0.1:3000。后端端口不需要向公网开放。

在域名的 DNS 管理处添加 A 记录,例如将 app.example.com 指向韩国服务器公网 IPv4。如果还配置了 AAAA 记录,也要确认它指向这台服务器可用的公网 IPv6;暂未配置 IPv6 服务时,不要保留错误的 AAAA 记录。可在本地电脑或服务器上检查:
dig +short A app.example.com
dig +short AAAA app.example.com
A 记录的结果应包含实际使用的服务器公网 IPv4。DNS 刚修改后,不同解析器可能暂时返回不同结果;此时先确认解析,再排查 Caddy,避免把解析问题误判为证书问题。若域名经过 CDN 或其他前置服务,首次验收时还需分清请求实际到达的是前置服务还是这台服务器。
登录服务器,确认后端应用已运行,并记下可用于验收的路径。这里使用 /health;如果应用没有这个路径,后续命令应替换为一个能返回明确内容的实际路径。
curl -i --max-time 5 http://127.0.0.1:3000/health
sudo ss -lntp
timedatectl status
第一条命令应返回应用响应,例如状态码 200 和可辨认的响应内容。ss 用来确认 80、443 是否已被其他程序占用,以及应用是否确实监听 3000 端口。若应用在容器内,仅有容器内部监听还不够:本例要求从服务器主机访问 127.0.0.1:3000 成功。timedatectl 则用于核对系统时间是否正常,避免明显的时间偏差干扰 TLS 验证。
还要分别检查云平台安全组或网络防火墙、服务器本机防火墙,确保入站 TCP 80 和 443 可达。调整规则前记录原规则及远程管理端口的放行状态,避免误断 SSH 连接;不必为本文配置开放公网 3000 端口。如果使用 UFW,先只查看状态:
sudo ufw status verbose
仅当 UFW 已启用且缺少相应规则时,才在确认远程管理连接仍被允许后添加 80、443 端口规则;云平台侧的放行需在对应控制台单独完成。记录哪些规则是本次新增的,便于回滚。
A5数据提供韩国首尔物理服务器,可用于部署网站、业务后台及应用服务。在本文的单站点场景中,服务器能够承载 Caddy 与后端应用,为域名接入、HTTPS 入口和反向代理提供主机资源。韩国方案涵盖不同的计算、存储及网络线路配置,可适配不同应用负载和访问地区的业务需求。
安装 Caddy 并保存初始配置
在 Ubuntu 24.04 上可通过 Caddy 的 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 chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddy
安装包可能启动 Caddy 的默认服务,因此安装前检查端口占用很重要。安装后核对版本、服务及配置文件,并备份将要修改的 Caddyfile:
caddy version
systemctl status caddy --no-pager
sudo ls -l /etc/caddy/Caddyfile
sudo mkdir -p /root/caddy-first-run-backup
sudo cp -a /etc/caddy/Caddyfile /root/caddy-first-run-backup/Caddyfile
caddy version 应输出已安装版本,systemctl status 用于确认服务是否运行;备份命令成功后,/root/caddy-first-run-backup/Caddyfile 应存在。这个备份只覆盖 Caddyfile,不代替整机快照。如果服务器原本已有业务配置,应先逐项评估站点和端口关系,而不是使用下面的单站点示例替换它。
配置域名与反向代理
编辑 /etc/caddy/Caddyfile,将示例域名和后端地址替换为实际值。本例的站点地址直接写域名,不写 http://:在域名解析和公网入口满足条件时,Caddy 会为站点尝试管理 HTTPS 证书,并将 HTTP 请求重定向到 HTTPS。
sudo nano /etc/caddy/Caddyfile
文件内容如下:
app.example.com {
reverse_proxy 127.0.0.1:3000
}
这条 reverse_proxy 会把站点请求转发到本机 3000 端口。示例没有改写路径,因此请求 /health 时,后端收到的仍是 /health。如果应用实际监听其他地址或端口,应先用服务器本机的 curl 验证那个地址,再修改配置;不要仅凭容器内的端口号推测主机可访问的端口。
保存后先校验语法,再重载服务。校验失败时不要重载,应修正报错所指的配置行。
sudo caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddy
systemctl status caddy --no-pager
校验成功会显示配置有效;重载后服务应保持运行。查看近期日志,可确认 Caddy 是否加载站点、是否正在处理证书申请,以及是否出现端口占用或连接后端失败等错误:
sudo journalctl -u caddy -n 80 --no-pager
日志中的证书申请信息不等于外部访问已经成功。下一步必须从服务器外部发起请求,分别验收域名、HTTPS 和反向代理。
从外部验证 HTTP、证书和应用响应
在自己的电脑或另一台外部主机上执行检查,不要只在韩国服务器本机访问 localhost。先看 HTTP 入口:
curl -sS -D - -o /dev/null http://app.example.com/health
正常情况下,应看到指向 https://app.example.com/health 的重定向响应。重定向本身只能说明 HTTP 入口工作,不能证明证书有效,也不能证明后端应用可访问。接着直接请求 HTTPS:
curl -sS -D - https://app.example.com/health
这条命令不使用 -k 跳过证书校验。预期结果是 TLS 校验通过,并返回应用的状态码及可辨认内容,例如 /health 的健康检查响应。应用返回的具体状态码取决于其实现;不能仅凭出现 HTTPS 响应就认定反向代理成功,仍需与先前直连 127.0.0.1:3000/health 的结果对照。
如果需要进一步确认域名对应的证书与连接过程,可以查看 curl 的详细输出:
curl -v -o /dev/null https://app.example.com/health
重点核对连接目标、证书所对应的域名,以及是否出现证书校验错误。示例域名和文档示例 IP 不能直接用于实际申请证书;必须替换为自己控制的真实域名和服务器地址。
首次部署常见失败如何判断
排查时先看外部入口,再看 Caddy 和后端,避免一开始就反复修改配置或重试证书申请。
- 域名解析不对或请求没有到达服务器:重新检查 A、AAAA 记录及前置服务设置,并核对实际访问的公网 IP。DNS 指向其他机器时,本机 Caddy 日志可能完全没有对应请求。
- HTTP、HTTPS 连接超时或被拒绝:先从外部确认 TCP 80、443 的放行情况,再用
sudo ss -lntp检查本机监听。云平台安全组放行与 UFW 放行是两层不同的条件;若端口被其他程序占用,应先确认该程序承载的业务,不要直接停用。 - HTTPS 证书尚未正常获取:核对域名解析、80/443 可达性、系统时间以及 Caddy 日志中的具体错误。若配置了无效 AAAA 记录、限制证书签发的 CAA 记录,或前置服务改变了访问路径,也应分别检查。不要通过连续重载、反复申请证书来代替定位问题。
- HTTPS 正常但出现
502 Bad Gateway:这通常意味着请求已经到达 Caddy,但它无法正常连接后端。回到服务器执行curl -i http://127.0.0.1:3000/health,检查应用进程、实际监听地址及端口。容器应用还应核对端口是否发布到主机。 - 返回
404、403或非预期页面:先确认当前访问的域名和路径,再对照直连后端的响应。应用可能没有/health路由,或只允许特定域名;若看到 Caddy 默认页面,则核对 Caddyfile 是否保存、校验并重载成功。
如果应用在 HTTPS 入口后仍自行重定向回 HTTP,还应检查应用识别原始请求协议的设置。Caddy 转发请求时会提供相关转发头,但应用是否信任并使用这些信息,取决于应用自身配置;不要用关闭 HTTPS 校验的方式掩盖重定向问题。
验收与回滚检查项
首次部署完成后,按下面的项目留存结果;其中任一项未通过,都不宜只凭“网页能打开”判定完成。
- 域名 A 记录指向预期的韩国服务器;如有 AAAA 记录,其对应 IPv6 入口也实际可用。
- 服务器本机直连后端成功,公网无需开放后端的 3000 端口。
- Caddyfile 校验通过,
caddy服务运行,日志中没有持续出现证书或上游连接错误。 - 外部 HTTP 请求按预期跳转至 HTTPS;外部 HTTPS 请求通过证书校验,并返回可与后端对照的应用内容。
若需要撤销本次站点配置,先确认没有其他人随后修改过 /etc/caddy/Caddyfile,再从安装前保存的副本恢复并校验:
sudo cp -a /root/caddy-first-run-backup/Caddyfile /etc/caddy/Caddyfile
sudo caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddy
这会恢复备份时的 Caddyfile;如果备份的是安装后的默认配置,回滚后该域名将不再按本文配置转发。只有在确认这台服务器原本没有其他 Caddy 业务时,才考虑进一步停止服务。云平台和 UFW 规则也只撤销本次新增且已记录的 80、443 放行项,不要删除原有业务规则或远程管理规则。最后重新检查服务状态、端口监听及外部访问结果,确认回滚没有影响同机其他服务。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5997.html



