iarekylew00t/caddy-cloudflare

caddy-cloudflare

基于https://hub.docker.com/_/caddy官方Docker镜像构建，添加了https://github.com/caddy-dns/cloudflare模块以支持ACME DNS-01验证。构建支持与上游Caddy项目相同的平台（不支持Windows）。

[!NOTE] 此镜像仅替换了caddy二进制文件，未对原始Caddy Docker镜像做其他修改。

sh
# Docker Hub
docker pull docker.xuanyuan.run/iarekylew00t/caddy-cloudflare:latest

# GHCR
docker pull ***-ghcr.xuanyuan.run/iarekylew00t/caddy-cloudflare:latest

标签

iarekylew00t/caddy-cloudflare镜像提供以下最新标签：

• https://github.com/IAreKyleW00t/docker-caddy-cloudflare/tree/v2.10.2
• https://github.com/IAreKyleW00t/docker-caddy-cloudflare/tree/v2.10.2
• https://github.com/IAreKyleW00t/docker-caddy-cloudflare/tree/v2.10
• https://github.com/IAreKyleW00t/docker-caddy-cloudflare/tree/v2

查看GitHub https://github.com/IAreKyleW00t/docker-caddy-cloudflare/tags获取所有版本列表。

使用方法

Docker

由于基于官方Docker镜像构建，所有卷、环境变量等使用方式与官方容器一致。有关Caddy的更多使用信息，请参考官方https://hub.docker.com/_/caddy Docker镜像和https://caddyserver.com/docs/。

创建容器时需包含CF_API_TOKEN（API Token不再需要***）。可利用Caddy对https://caddyserver.com/docs/caddyfile/concepts#environment-variables的支持将值传递到`Caddyfile`中。

[!IMPORTANT] 请事先创建Caddyfile以避免Docker启动错误。

sh
docker run --rm -it \
  --name caddy \
  -p 80:80 \
  -p 443:443 \
  -v caddy_data:/data \
  -v caddy_config:/config \
  -v $PWD/Caddyfile:/etc/caddy/Caddyfile \
  -e CF_API_TOKEN=UhKLc...JD9jk \
  docker.xuanyuan.run/iarekylew00t/caddy-cloudflare:latest

如果偏好docker-compose，可更新docker-compose.yml中的CF_API_TOKEN后使用：

sh
docker compose up

Caddy配置

在Caddyfile中设置全局https://caddyserver.com/docs/caddyfile/options#acme-dns指令：

Caddyfile
{
  acme_dns cloudflare {env.CF_API_TOKEN}
}

或通过JSON配置：

json
{
  "module": "acme",
  "challenges": {
    "dns": {
      "provider": {
        "name": "cloudflare",
        "api_token": "{env.CF_API_TOKEN}"
      }
    }
  }
}

高级用法请参见https://github.com/caddy-dns/cloudflare模块和https://caddyserver.com/docs/caddyfile/directives/tls#tls指令文档。

创建Cloudflare API Token

通过Cloudflare控制台生成API Token的步骤：

1. 登录https://dash.cloudflare.com/
2. 进入https://dash.cloudflare.com/profile > https://dash.cloudflare.com/profile/api-tokens
3. 点击"Create token"（使用"Create Custom Token"选项）
4. 授予以下权限：
   • Zone > Zone > Read
   • Zone > DNS > Edit

构建镜像

可通过以下命令本地构建Docker镜像：

sh
docker build -t caddy-cloudflare .

如果偏好docker-compose，可使用提供的docker-compose.yml进行构建：

sh
docker compose build

容器签名验证

所有容器镜像均通过https://docs.sigstore.dev/cosign/overview/使用https://docs.sigstore.dev/cosign/keyless/自动签名。可使用以下命令验证镜像完整性：

sh
cosign verify \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp https://github.com/IAreKyleW00t/docker-caddy-cloudflare/.github/workflows/ \
  iarekylew00t/caddy-cloudflare:latest

贡献

欢迎通过https://github.com/IAreKyleW00t/docker-caddy-cloudflare/issues或https://github.com/IAreKyleW00t/docker-caddy-cloudflare/pulls参与贡献。

许可证

详见https://github.com/IAreKyleW00t/docker-caddy-cloudflare/blob/main/LICENSE。