caddy-cloudflare

]([] ![Docker Build & Release]([] ![License]([]

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

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

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

# GHCR
docker pull ghcr.io/iarekylew00t/caddy-cloudflare:latest

标签

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

• latest
• 2.10.2
• 2.10
• 2

查看GitHub Tags获取所有版本列表。

使用方法

Docker

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

创建容器时需包含CF_API_TOKEN（API Token不再需要邮箱）。可利用Caddy对环境变量的支持将值传递到Caddyfile中。

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

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后使用：

docker compose up

Caddy配置

在Caddyfile中设置全局acme_dns指令：

{
  acme_dns cloudflare {env.CF_API_TOKEN}
}

或通过JSON配置：

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

高级用法请参见caddy-dns/cloudflare模块和tls指令文档。

创建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镜像：

docker build -t caddy-cloudflare .

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

docker compose build

容器签名验证

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

cosign verify \
  --certificate-oidc-issuer [***] \
  --certificate-identity-regexp [***] \
  iarekylew00t/caddy-cloudflare:latest

贡献

欢迎通过Issue或Pull Request参与贡献。

许可证

详见LICENSE。