princemaple/docker-caddy

从源代码构建的Caddy 2镜像，集成了caddyserver.com/download上所有caddy-dns/*插件，标签格式为VERSION-DNS_NAME（如v2.5.1-cloudflare），便于按需选择特定DNS插件版本。

0 次下载activeprincemaple镜像

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 [***]  # 示例：反向代理至后端服务
}

环境变量说明

不同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格式密钥）