iarekylew00t/caddy-cloudflare

caddy-cloudflare

https://github.com/IAreKyleW00t/docker-caddy-cloudflare/actions/workflows/docker.yml/badge.svg](https://github.com/IAreKyleW00t/docker-caddy-cloudflare/actions/workflows/docker.yml)

基于https://hub.docker.com/_/caddy%E5%AE%98%E6%96%B9Docker%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%B7%BB%E5%8A%A0%E4%BA%86https://github.com/caddy-dns/cloudflare%E6%A8%A1%E5%9D%97%E4%BB%A5%E6%94%AF%E6%8C%81ACME DNS-01验证。构建支持与上游Caddy项目相同的平台（不支持Windows）。

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

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

# GHCR
docker pull ghcr.io/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%E8%8E%B7%E5%8F%96%E6%89%80%E6%9C%89%E7%89%88%E6%9C%AC%E5%88%97%E8%A1%A8%E3%80%82

使用方法

Docker

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

创建容器时需包含CF_API_TOKEN（API Token不再需要***）。可利用Caddy对环境变量的支持将值传递到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 \
  iarekylew00t/caddy-cloudflare:latest

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

sh
docker compose up

Caddy配置

在Caddyfile中设置全局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%E6%A8%A1%E5%9D%97%E5%92%8C%60tls%60%E6%8C%87%E4%BB%A4%E6%96%87%E6%A1%A3%E3%80%82

创建Cloudflare API Token

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

1. 登录Dashboard
2. 进入Account 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

容器签名验证

所有容器镜像均通过Cosign使用无密钥签名自动签名。可使用以下命令验证镜像完整性：

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%E6%88%96https://github.com/IAreKyleW00t/docker-caddy-cloudflare/pulls%E5%8F%82%E4%B8%8E%E8%B4%A1%E7%8C%AE%E3%80%82

许可证

详见https://github.com/IAreKyleW00t/docker-caddy-cloudflare/blob/main/LICENSE%E3%80%82