princemaple/docker-caddy

Caddy 2 DNS插件集成镜像

镜像概述

本镜像为基于源代码构建的Caddy 2（一款功能强大的开源Web服务器，支持自动HTTPS、反向代理等），预集成了caddyserver.com/download提供的所有caddy-dns/*系列DNS插件。每个插件对应独立镜像标签，标签格式为VERSION-DNS_NAME（例如v2.5.1-cloudflare表示Caddy 2.5.1版本集成Cloudflare DNS插件）。

核心功能与特性

1. 完整DNS插件覆盖

• 包含官方维护的所有caddy-dns/*插件，覆盖主流DNS服务提供商（如Cloudflare、AWS Route53、Google Cloud DNS等）。

2. 源代码构建保障

• 基于Caddy官方源代码编译，确保与官方版本功能一致，无第三方修改，安全性可控。

3. 精准标签管理

• 标签格式严格遵循VERSION-DNS_NAME：
  • VERSION：Caddy核心版本号（如v2.6.4）
  • DNS_NAME：DNS插件标识（如cloudflare、route53）
• 通过标签可快速定位所需Caddy版本及对应DNS插件。

使用场景

适用场景

• DNS-01挑战证书管理：需通过DNS记录验证域名所有权以获取/续期TLS证书（如内网服务器、80/443端口受限环境）。
• 多DNS提供商适配：根据实际使用的DNS服务选择对应插件镜像，无需手动编译插件。
• 生产环境部署：需稳定集成特定DNS插件的Web服务、反向代理或API网关场景。

不适用场景

• 无需DNS插件的基础Caddy功能（建议使用官方标准Caddy镜像以减小体积）。
• 需要同时集成多个DNS插件的场景（需自行构建或使用多阶段部署）。

使用方法

1. 选择镜像标签

根据目标DNS提供商及Caddy版本，从镜像仓库选择对应标签。例如：

• 集成Cloudflare DNS插件的Caddy 2.5.1：v2.5.1-cloudflare
• 集成AWS Route53插件的Caddy 2.6.4：v2.6.4-route53

2. 基本部署命令

bash
docker run -d \
  --name caddy \
  -p 80:80 \
  -p 443:443 \
  -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  -v caddy_config:/config \
  -e "CLOUDFLARE_API_TOKEN=your_cloudflare_token" \
  [镜像仓库地址]:v2.5.1-cloudflare

参数说明：

• -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile：挂载自定义Caddy配置文件
• -v caddy_data:/data：持久化存储证书、缓存等数据
• -v caddy_config:/config：存储Caddy运行时配置状态
• -e "ENV_VAR=value"：传入DNS插件所需的API凭证（因插件而异）

3. Caddyfile配置示例（Cloudflare插件）

使用v2.5.1-cloudflare标签时，Caddyfile中配置DNS-01挑战：

caddyfile
example.com {
  tls {
    dns cloudflare {env.CLOUDFLARE_API_TOKEN}  # 通过环境变量传入Cloudflare API令牌
  }
  reverse_proxy /app http://backend-service:8080  # 示例：反向代理至后端服务
}

环境变量说明

不同DNS插件需通过环境变量传入API凭证，具体参数参考对应插件文档：

• Cloudflare：CLOUDFLARE_API_TOKEN（推荐）或CLOUDFLARE_EMAIL+CLOUDFLARE_API_KEY
• AWS Route53：AWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEY（需具备Route53记录修改权限）
• Google Cloud DNS：GCP_PROJECT+GCP_SERVICE_ACCOUNT_KEY（JSON格式密钥）

注意事项

1. 权限控制：DNS API凭证需最小化权限（仅DNS记录管理），避免泄露导致安全风险。
2. 版本兼容性：确保标签中VERSION与所需Caddy功能匹配（如2.6.x支持HTTP/3，低版本可能不支持）。
3. 数据持久化：/data目录存储证书等关键数据，必须通过卷挂载持久化，避免容器重建导致证书丢失。
4. 插件更新：需定期更新镜像标签以获取Caddy及DNS插件的安全更新。