erfianugrah/caddy

Caddy Builder (Cloudflare DNS + Docker Proxy) 镜像文档

镜像概述

本镜像为Caddy服务器的定制构建环境，预集成Cloudflare DNS模块和Docker代理模块。旨在简化构建支持动态DNS解析（通过Cloudflare）和Docker容器自动代理的Caddy服务器，适用于需要动态域名管理和容器服务反向代理的场景。

核心功能与特性

• Cloudflare DNS集成：内置dns.cloudflare模块，支持通过Cloudflare API自动管理DNS记录，实现动态DNS解析。
• Docker代理支持：集成docker-proxy模块，可自动发现Docker容器并生成代理配置，简化容器服务的反向代理管理。
• 可定制构建：基于官方Caddy构建工具，支持添加额外Caddy模块（如http.cache、http.forwardproxy等）。
• 轻量级基础：基于Alpine Linux，构建环境精简，生成的Caddy二进制文件体积小、性能高。

使用场景

• 动态IP环境：家庭服务器、NAS等动态IP场景，通过Cloudflare DNS自动更新域名解析。
• Docker容器代理：多容器服务环境，自动生成容器反向代理规则，无需手动配置。
• 自定义Caddy构建：需要集成特定模块（如Cloudflare DNS、Docker代理）的Caddy服务器构建需求。

使用方法与配置说明

构建自定义Caddy二进制文件

基本构建命令

bash
docker run --rm -v $(pwd):/out caddy-builder-cloudflare-docker-proxy \
  caddy build \
  --with github.com/caddy-dns/cloudflare \
  --with github.com/lucaslorentz/caddy-docker-proxy/v2

构建包含额外模块的Caddy

bash
docker run --rm -v $(pwd):/out caddy-builder-cloudflare-docker-proxy \
  caddy build \
  --with github.com/caddy-dns/cloudflare \
  --with github.com/lucaslorentz/caddy-docker-proxy/v2 \
  --with github.com/caddyserver/cache-handler

构建完成后，当前目录下将生成caddy二进制文件。

运行Caddy服务器（含Cloudflare DNS和Docker代理）

基础运行示例（使用构建的二进制）

bash
# 准备Caddy配置文件 Caddyfile
cat > Caddyfile << EOF
{
  docker
  dns cloudflare {env.CLOUDFLARE_API_TOKEN}
}

# 自动代理Docker容器（需容器添加标签：caddy.host=example.com）
EOF

# 运行Caddy
CLOUDFLARE_API_TOKEN="your-cloudflare-api-token" ./caddy run

Docker Compose配置示例

yaml
version: "3.8"

services:
  caddy:
    image: caddy:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - ./caddy-data:/data
      - /var/run/docker.sock:/var/run/docker.sock:ro  # 用于Docker代理模块
    environment:
      - CLOUDFLARE_API_TOKEN=your-cloudflare-api-token
    restart: unless-stopped

关键配置参数

Cloudflare DNS模块配置

Docker代理模块配置

注意事项

• Cloudflare API令牌需具备Zone.DNS编辑权限，建议使用范围限制的令牌。
• Docker代理模块需挂载Docker socket（/var/run/docker.sock），确保Caddy容器有足够权限访问Docker API。
• 构建时可通过--with参数添加其他Caddy模块，具体模块列表见Caddy官方模块库。