服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- acme.sh standalone 需要在 TCP 80 接收 HTTP-01 验证;Caddy 正监听该端口时可能无法启动验证服务。
- 先确认域名解析、入站 80 防火墙和实际监听进程,再选择停用 Caddy 的维护窗口或其他验证方式。
- 停止 Caddy 会影响使用它的站点;配置自动续签时应保证无论续签成功与否都能恢复原服务。
- 证书续签完成后,要在 x-ui 实际 TLS 端口和目标 SNI 上验证证书,不能只看 ACME 成功日志。
理解冲突:standalone 需要 80 端口可绑定
acme.sh standalone 模式会临时启动自己的 HTTP 服务以响应 HTTP-01 验证。若 Caddy 或其他反向代理已占用 TCP 80,acme.sh 可能无法绑定验证端口,续签任务便会失败。即使 x-ui 正在另一个 HTTPS 端口提供面板,HTTP-01 的入站验证仍需要域名从公网到达正确主机的 TCP 80。
同一台机器可以同时运行 Caddy 与 x-ui,但需要把端口所有权安排清楚:可由现有 Web 服务代理 challenge,也可在维护窗口短暂停止占用者,或选择适合部署的其他验证方式。单纯确认 Caddy 的 443 网站可访问,不能证明独立的 standalone 服务能绑定 80。
只读确认端口、容器和证书任务
先检查 TCP 80 的监听进程、Caddy 容器状态、acme.sh 管理的证书列表和最近续签日志。替换域名占位符;不要在公开工单中粘贴完整域名、私钥路径或 ACME 账户信息。若 80 端口由另一个服务占用,先确认服务用途和依赖站点,不要直接 kill 进程。
还要检查域名 A/AAAA 记录是否指向能接收验证请求的公网入口,安全组与主机防火墙是否允许入站 TCP 80。若域名使用 CDN、端口转发或多个地址,需确认 challenge 请求实际到达运行 ACME 的主机;不匹配时停用 Caddy也无法解决 DNS/路由问题。
检查监听者、容器和 acme.sh 证书
shss -ltnp 'sport = :80'
docker ps --format '{{.Names}} {{.Status}}' | grep -i caddy
/root/.acme.sh/acme.sh --list
systemctl list-timers --all | grep -i acme
选择能恢复服务的 standalone 续签方式
仅当确认 Caddy 由 Docker 管理,且维护窗口允许其代理站点短暂停机时,才使用同一容器的受控续签脚本。脚本用 EXIT trap 清理服务状态,并让 HUP、INT、TERM 分别以 129、130、143 退出,再由 EXIT 执行恢复。先替换域名和容器名,确认容器正在运行、当前用户有权管理它;若 Caddy 由 systemd 或其他编排器管理,不要照抄此示例。
示例只用于一次受控续签。计划任务应按 acme.sh 对应证书的续签配置保存 pre-hook 与 post-hook,并检查 cron 或 systemd 是否实际调用。停止 Caddy 失败时必须终止续签;续签失败后也要恢复 Caddy。SIGKILL、主机断电或 Docker 不可用时 shell 无法执行 trap,应保留人工恢复入口并将恢复失败视为维护未完成。
Docker Caddy 的受控 standalone 续签示例
shset -eu
DOMAIN='EXAMPLE.COM'
CADDY_CONTAINER='REPLACE_WITH_CONFIRMED_CADDY_CONTAINER'
docker inspect -f '{{.State.Running}}' "$CADDY_CONTAINER" | grep -qx true || exit 1
restore_caddy() {
renew_status=$?
trap - EXIT
if [ "$(docker inspect -f '{{.State.Running}}' "$CADDY_CONTAINER")" != "true" ]; then
docker start "$CADDY_CONTAINER" >/dev/null
fi
exit "$renew_status"
}
trap restore_caddy EXIT
trap 'exit 129' HUP
trap 'exit 130' INT
trap 'exit 143' TERM
docker stop "$CADDY_CONTAINER"
/root/.acme.sh/acme.sh --renew -d "$DOMAIN" --standalone
自动续签与 HTTP-01 入口要一起复核
只在终端手工成功一次,不等于定时任务已经配置正确。检查 acme.sh 为目标证书保存的验证模式和钩子,确认计划任务使用同一个用户、acme.sh 安装路径和配置目录;cron 与 systemd timer 可能使用不同环境变量。不要通过重建账户或重置证书目录来修复一个端口占用问题。
如果不能接受 Caddy 网站中断,可评估与反向代理协作的验证方式或 DNS-01,但需确认 DNS API 权限、凭据存放和自动续签责任。切换验证方式前先保留现有证书与 renewal 配置,确认新的 challenge 在该域名和 DNS 提供方上可用;不要把 DNS API token 写进命令历史或日志。
在 x-ui 的实际 TLS 端口验证证书
续签后分别核对 acme.sh 任务结果、证书文件的有效期和服务安装状态。Caddy 容器恢复只说明反向代理重新运行,不代表 x-ui 已载入新证书。对照 x-ui 实际 HTTPS 监听地址、端口和证书安装路径,在预期网络入口使用服务 SNI 执行证书链和主机名验证;验证失败时不能因签发日志成功就继续关闭告警。
如果外部 HTTPS 成功而 x-ui 仍提供旧证书,检查安装钩子是否将新证书部署到 x-ui 的目标路径,以及该服务是否需要受控 reload。reload 后再次从目标端口验证链和名称,并确认 Caddy 站点仍可访问。Caddy 的 443 证书不能证明另一个面板端口也已更新。
验证 x-ui TLS 端口的证书链和主机名
shDOMAIN='EXAMPLE.COM'
CONNECT_ADDRESS='127.0.0.1'
PORT='REPLACE_WITH_XUI_TLS_PORT'
openssl s_client -connect "$CONNECT_ADDRESS:$PORT" -servername "$DOMAIN" -verify_hostname "$DOMAIN" -verify_return_error </dev/null
回滚和失败停止条件
如果 challenge 仍失败,恢复 Caddy 后再检查 DNS、入站 TCP 80、防火墙和 ACME 任务上下文。不要反复让多个 HTTP 服务争抢 80,也不要结束未知 PID。若自动续签钩子配置错误,先从备份恢复续签配置,确认 Caddy 能正常启动,再安排下一次受控尝试。
完成条件包括续签任务成功、证书安装到 x-ui 实际路径、目标 SNI 端口返回新证书,以及被暂停的 Caddy 网站恢复。具体 Caddy 服务管理方式、x-ui HTTPS 端口和 acme.sh 用户目录依部署而异;示例中的域名、容器名和端口都必须替换,不是可照抄的生产值。
资料来源
常见问题
Caddy 占用 80 时为什么 standalone 续签会失败?
standalone HTTP-01 需要临时绑定 TCP 80。若 Caddy 已监听该端口,验证服务可能无法绑定;也要同时确认域名和防火墙能把请求送到正确主机。
停止 Caddy 后证书续签成功,就代表 x-ui 已使用新证书吗?
不代表。还要确认新证书已部署到 x-ui 配置路径,并在 x-ui 的实际 TLS 端口和 SNI 上检查返回证书。
Docker 示例可以用于 systemd 管理的 Caddy 吗?
不可以直接照抄。先确认 Caddy 的服务管理方式,并使用对应的停止/恢复命令及失败恢复方案。
怎样避免自动续签时 Caddy 长时间停止?
使用与当前 acme.sh 版本匹配的持久 pre/post hooks,验证定时任务会执行它们,并为脚本中断、服务启动失败准备人工恢复入口。