服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 域名变更可能涉及 DNS 记录、Caddy 站点地址、反代上游、x-ui 监听端口和独立证书安装,不能只改一处。
- 先选定 TLS 终止架构:由 Caddy 提供公网 HTTPS,或让客户端直接连接 x-ui 的 TLS 端口。
- Caddy 自动证书和 x-ui 手动安装的证书属于不同部署对象;检查各自证书路径和续签钩子。
- 通过实际域名 SNI 分别验证公网入口与 x-ui 直连入口,避免暴露管理端口。
迁移前先画清两种 TLS 架构
迁移域名时,首先确定 TLS 在哪里终止。若公网 HTTPS 由 Caddy 终止,Caddy 应为新域名提供证书并反向代理到受限的 x-ui 上游;若客户端直接访问 x-ui 的 TLS 端口,则 x-ui 自己需要绑定并加载新域名的证书。两种方式可以并存,但必须明确每个入口由哪个服务处理。
只更新 Caddyfile 不会自动改写 x-ui 的监听、面板地址或证书路径;只把新证书放入 x-ui 也不会自动添加 Caddy 站点。先记录旧域名用途、公开入口、上游端口和续签方式,避免迁移后管理页意外暴露或仍在使用旧证书。
只读核对 DNS、监听端口和当前配置
确认新域名的 A/AAAA 记录指向正确入口,检查主机对外开放的 80/443 与 x-ui 管理端口。阅读 Caddyfile 和 x-ui 证书设置时,仅在本机检查;分享前遮盖真实域名、上游地址、面板路径、账户和密钥。caddy validate 可检查指定配置,但通过校验不代表 DNS 或上游服务可达。
确定 Caddy 是否代理到本机回环地址、Unix socket 或其他受控网络地址,并确认目标端口确实属于 x-ui。若不清楚哪个进程拥有 TLS 端口,先检查监听者,不要更改防火墙或添加公开端口。
检查监听端口并校验 Caddy 配置
shss -ltnp | grep -E ':(80|443)([[:space:]]|$)'
caddy validate --config /PATH/TO/Caddyfile
按选定架构更新新域名的路由与证书
修改前备份 Caddyfile、x-ui 公共地址设置和证书配置。Caddy 终止 TLS 时,新增新域名站点并确认反代上游只允许必要网络访问;x-ui 直连 TLS 时,在其管理界面安装匹配新 SNI 的证书,并确认绑定到正确监听端口。不要将私钥复制到公开目录,也不要同时把管理端口开放到公网来测试。
若 DNS TTL 尚未过期或存在多个后端,采用分阶段切换并保留旧入口直到新域名验证通过。执行 Caddy reload 前先通过配置校验;x-ui 证书变更可能需要受控 reload。任何一种服务重载都可能中断现有连接,按实际架构安排维护窗口。
续签路径要覆盖 Caddy 和 x-ui 的真实使用方式
证书自动续签取决于谁终止 TLS、使用哪种 ACME 验证以及证书部署钩子。Caddy 自动管理的证书与通过 acme.sh 安装到 x-ui 的证书不会互相继承续签配置。若使用 standalone HTTP-01,TCP 80 需要能提供 challenge;已有 Caddy 占用端口时,应明确使用反代 challenge、停启钩子或其他受支持方式,并保证失败后服务恢复。
检查实际计划任务运行的用户、配置目录、Caddy 服务名、证书安装目标和 reload 命令。不要只在命令行续签一次就认定 cron 已配置;也不要删除旧证书或更新账户来处理站点路由错误。将续签任务输出脱敏后再交给维护人员。
使用目标 SNI 验证公网与上游入口
迁移后用新域名的 SNI 检查公网 443 返回的证书 SAN、有效期和证书链,再用 HTTPS 页面确认 Caddy 能到达预期 x-ui 上游。若 x-ui 有独立 TLS 端口,再对该端口单独检查其返回证书;不能用 Caddy 的证书结果推断 x-ui 直连证书已更新。
同时确认管理界面仍要求认证、公开入口只开放业务需要的端口、旧域名是否按计划保留或转向。若本机正常而外部仍拿到旧证书,继续检查 DNS、CDN/负载均衡和缓存;若证书正常但页面 502,检查 Caddy 上游协议、地址和 x-ui 服务状态。
使用 SNI 验证入口的证书链与主机名
shDOMAIN='EXAMPLE.NEW.HOST'
CONNECT_ADDRESS='EXAMPLE.NEW.HOST'
PORT='443'
openssl s_client -connect "$CONNECT_ADDRESS:$PORT" -servername "$DOMAIN" -verify_hostname "$DOMAIN" -verify_return_error </dev/null
回滚和关闭条件
如果新站点无法访问、证书名称不匹配或上游错误,恢复备份的 Caddyfile 和 x-ui 证书设置,验证配置后再 reload。DNS 切换无法立即让所有解析器回到旧值,因此在回滚方案中保留可用旧入口与安全管理通道。
完成迁移应同时满足:新域名解析到预期入口、选定 TLS 终止服务返回正确证书、反代到 x-ui 的页面可用、管理员认证正常、续签路径明确且旧入口处置符合计划。证书、域名和端口均按部署替换;示例不代表可直接公开 x-ui 管理端口。
资料来源
常见问题
只在 Caddyfile 加入新域名够吗?
不一定。还要确认 TLS 终止位置、DNS、反代上游、x-ui 自身证书绑定和续签任务是否都需要调整。
Caddy 自动证书会自动更新 x-ui 的证书吗?
不会自动证明这一点。Caddy 和 x-ui 可能使用不同证书路径与续签机制;分别验证它们实际监听的 TLS 端口。
怎样区分证书错误和反代错误?
先用目标 SNI 检查证书。证书正确但页面返回 502 时,再检查 Caddy 到 x-ui 的上游地址、协议和服务状态。
域名迁移时应公开 x-ui 的管理端口吗?
不要为测试而扩大公开端口。优先通过受保护的 Caddy 入口访问,并只开放部署确实需要的端口。