tech 2026年04月18日 · 阅读

要实现你的需求，我们需要注意一个关键点：Caddy 的插件是静态编译进二进制文件的。

如果你只是简单地将第二阶段的镜像改为 ghcr.io/caddy-dns/cloudflare，但依然使用第一阶段只编译了 l4 的二进制文件进行覆盖，那么最终你将丢失 Cloudflare 插件的功能。

为了同时拥有 l4 和 cloudflare 插件，最正确的做法是在编译阶段将两者都包含进去。以下是修改后的 Dockerfile：

# 阶段 1：使用 Caddy 官方 builder 构建包含两个插件的版本
FROM caddy:builder AS builder

RUN xcaddy build \
    --with github.com/mholt/caddy-l4 \
    --with github.com/caddy-dns/cloudflare

# 阶段 2：构建最终运行镜像
# 使用你指定的镜像作为基础镜像
FROM ghcr.io/caddy-dns/cloudflare:latest

# 将我们在阶段 1 编译好的（带 l4 和 cloudflare 插件）二进制文件替换进去
COPY --from=builder /usr/bin/caddy /usr/bin/caddy

关键点说明

  1. 多插件合并编译：在 RUN xcaddy build 命令中，我们通过多个 --with 参数同时引入了 caddy-l4 和 caddy-dns/cloudflare。这样生成的 caddy 二进制文件才同时具备四层代理和 Cloudflare DNS 验证的能力。

  2. 关于基础镜像的选择：

    • 虽然我们在第二阶段使用了 FROM ghcr.io/caddy-dns/cloudflare:latest，但由于执行了 COPY --from=builder ...，原本镜像里的旧二进制文件会被我们新编译的覆盖。
    • 这样做的好处：保留了该镜像可能存在的特定环境变量设置或配置文件路径，符合你“使用该镜像”的要求。

  3. 验证插件：
    编译完成后，你可以运行以下命令来确认两个插件都已成功安装：

    docker run --rm <你的镜像名> caddy list-modules | grep -E "l4|cloudflare"

如果你只是想单纯切换基础镜像而不自己编译，那是行不通的，因为官方的 Cloudflare 镜像里并不包含 l4 插件。上面的方案是同时兼顾两者的唯一标准做法。

如何升级

对于这种使用 xcaddy 构建的自定义 Caddy 镜像，升级主要分为 二进制文件升级 和 基础镜像（运行环境）升级 两部分。

由于你在 Dockerfile 中使用了 latest 标签，升级操作主要取决于你如何管理镜像的构建过程。

1. 手动升级（最简单的方法）

如果你没有在 Dockerfile 中锁定版本号，只需重新构建镜像并禁用缓存，xcaddy 就会自动拉取 Caddy 的最新源码并编译，同时也会拉取基础镜像的最新版本。

在终端执行：

# --no-cache 确保 xcaddy 重新下载最新源码，而不是使用旧的构建层
docker build --no-cache -t my-caddy:latest .

2. 精确版本升级（推荐做法）

为了生产环境的稳定性，建议在 Dockerfile 中明确指定版本号。当你需要升级时，手动修改版本号并重新构建。

修改后的 Dockerfile 示例：

# 1. 锁定 Builder 版本（对应 Caddy 主版本）
FROM caddy:2.7.6-builder AS builder

# 2. 锁定插件版本（可选，使用 @版本号）
RUN xcaddy build v2.7.6 \
    --with github.com/mholt/caddy-l4 \
    --with github.com/caddy-dns/[email protected]

# 3. 锁定运行镜像版本
FROM ghcr.io/caddy-dns/cloudflare:1.1.1

COPY --from=builder /usr/bin/caddy /usr/bin/caddy

升级步骤：

  1. 去 Caddy GitHub Releases 查看最新版本号（如 v2.8.0）。
  2. 修改 Dockerfile 中的 v2.7.6 为 v2.8.0。
  3. 重新执行 docker build。

3. 进阶：如何检查当前版本

升级完成后，你应该进入容器确认版本是否符合预期：

  • 查看 Caddy 核心版本：

    docker exec <容器名> caddy version

  • 查看已安装的插件（确认 l4 和 cloudflare 都在）：

    docker exec <容器名> caddy list-modules | grep -E "l4|cloudflare"

4. 自动化升级建议

如果你希望像官方镜像一样自动升级，可以考虑以下方案：

  • GitHub Actions: 建立一个私有仓库存放 Dockerfile，配置一个 Cron Job（定时任务），每周自动执行一次 docker build --no-cache 并推送到你的镜像仓库。
  • Watchtower: 如果你在本地或服务器上运行容器，可以使用 Watchtower 监控镜像更新。但注意，Watchtower 只能监控镜像标签（如 :latest）的变动，如果你的 Dockerfile 在本地，你仍需先手动构建。

⚠️ 注意事项

  • 配置兼容性：大版本升级（例如从 v2 升到未来的 v3）前，请务必查看 Caddy 的官方发行说明，确认你的 Caddyfile 语法是否需要调整。
  • 构建耗时：xcaddy 在构建时需要下载 Go 依赖，如果网络环境不佳（如在国内），建议在 xcaddy build 前添加一行 ENV GOPROXY=https://goproxy.cn,direct 来加速。
附注（Ray）: https://ytai.de/t/topic/124
caddy selfhosting