faradaytrs/caddy

Caddy服务器(含Cloudflare DNS插件)镜像文档

镜像概述

本镜像基于官方Caddy服务器构建，集成Cloudflare DNS插件，专门用于解决需要通过DNS验证获取SSL证书的场景。通过Cloudflare DNS插件，可实现ACME DNS-01挑战，支持在无法使用HTTP验证的环境中自动签发和续期SSL证书，大幅简化HTTPS服务部署流程。

核心功能与特性

• Caddy服务器核心功能：完整支持HTTP/HTTPS服务、反向代理、负载均衡、URL重写、gzip压缩等Web服务器功能
• Cloudflare DNS插件集成：内置caddy-dns/cloudflare插件，原生支持ACME DNS-01挑战验证
• 自动SSL证书管理：自动向Let's Encrypt等CA机构申请、续期SSL证书，无需手动干预
• 灵活配置支持：支持通过Caddyfile自定义服务器配置，兼容Caddy原生配置语法
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低

使用场景与适用范围

• DNS验证场景：适用于内网服务、防火墙限制HTTP访问、多域名泛解析等无法使用HTTP-01验证的场景
• Cloudflare用户：使用Cloudflare DNS管理域名的用户，需通过DNS验证获取SSL证书的场景
• 自动HTTPS部署：需要快速实现HTTPS配置的Web服务（如博客、API服务、反向代理服务）
• 容器化部署：Kubernetes、Docker Compose等容器编排环境中的HTTPS服务部署

使用方法与配置说明

环境准备

• 已注册Cloudflare账号并管理目标域名
• 生成Cloudflare API令牌（需包含DNS:Edit权限）
• 安装Docker或Docker Compose环境

基础使用（docker run）

1. 创建Caddyfile配置

在宿主机创建Caddyfile（示例配置）：

caddyfile
# 替换为实际域名
example.com {
    # 配置反向代理（根据实际需求修改）
    reverse_proxy 192.168.1.100:8080
    
    # 启用Cloudflare DNS验证
    tls {
        dns cloudflare {env.CLOUDFLARE_API_TOKEN}
    }
}

2. 启动容器

bash
docker run -d \
  --name caddy-cloudflare \
  -p 80:80 \
  -p 443:443 \
  -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data/caddy \  # 持久化存储证书和配置
  -e CLOUDFLARE_API_TOKEN="your_cloudflare_api_token" \  # 替换为实际API令牌
  caddy-cloudflare-dns:latest

Docker Compose配置

创建docker-compose.yml：

yaml
version: '3.8'

services:
  caddy:
    image: docker.xuanyuan.run/caddy-cloudflare-dns:latest
    container_name: caddy-cloudflare
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data/caddy  # 持久化证书和配置数据
    environment:
      - CLOUDFLARE_API_TOKEN=your_cloudflare_api_token  # 替换为实际API令牌
    restart: unless-stopped

volumes:
  caddy_data:  # 命名卷，确保数据持久化

启动服务：

bash
docker-compose up -d

关键配置参数

环境变量

Caddyfile配置示例（泛域名证书）

caddyfile
*.example.com {
    # 静态文件服务配置（根据实际需求修改）
    root * /usr/share/caddy
    file_server
    
    # Cloudflare DNS验证配置
    tls {
        dns cloudflare {env.CLOUDFLARE_API_TOKEN}
        # 可选：指定CA机构（默认Let's Encrypt）
        # ca https://acme-staging-v02.api.letsencrypt.org/directory
        # 可选：设置证书有效期提醒阈值
        # expiry_window 30d
    }
}

数据持久化

为避免容器重启后证书和配置丢失，必须挂载数据卷：

• /data/caddy：存储SSL证书、私钥及Caddy运行时数据，建议使用命名卷或宿主机目录挂载

注意事项

1. Cloudflare API令牌权限：确保API令牌至少包含Zone:DNS:Edit权限，否则无法完成DNS记录修改
2. 域名解析配置：目标域名的DNS记录必须由Cloudflare托管，且域名状态为"Active"
3. 防火墙配置：需开放容器的80/443端口（ACME证书续期可能需要短暂HTTP访问）
4. 配置验证：启动前建议通过caddy validate命令验证Caddyfile语法正确性

常见问题

• 证书申请失败：检查Cloudflare API令牌权限、域名DNS托管状态，或查看容器日志（docker logs caddy-cloudflare）
• 证书续期问题：Caddy默认在证书过期前30天自动续期，确保容器运行状态稳定且数据卷持久化正常
• 多域名配置：支持在单个Caddyfile中配置多个域名，每个域名需单独指定dns cloudflare配置块