paradoxsp/caddy-cloudflare

caddy-cloudflare

维护者： https://github.com/paradox-sp/caddy-cloudflare

镜像概述

该Docker镜像提供轻量级Caddy 2服务器，内置Cloudflare模块支持。Caddy是一款现代化Web服务器，以自动HTTPS、简洁配置和低资源占用为核心特性，本镜像进一步集成Cloudflare功能，简化在Cloudflare生态中的部署流程。

核心功能和特性

• 轻量级架构：基于Caddy官方精简镜像构建，资源占用低，启动速度快
• Cloudflare原生支持：内置Cloudflare模块，无需额外安装插件即可使用相关功能
• 完整Caddy 2特性：包含自动HTTPS、反向代理、静态文件服务、API管理等全部Caddy核心功能
• 配置简易性：支持通过Caddyfile进行声明式配置，Cloudflare相关功能可直接在配置中集成

使用场景和适用范围

• 需通过Cloudflare DNS进行HTTPS证书验证的Web服务
• 基于Cloudflare CDN加速的静态资源或动态应用托管
• 使用Cloudflare Zero Trust等服务的企业内网应用暴露
• 个人博客、小型电商网站等轻量级Web服务部署

使用方法和配置说明

基础部署（docker run）

bash
docker run -d \
  --name caddy-cloudflare \
  -p 80:80 \
  -p 443:443 \
  -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  -v caddy_config:/config \
  paradox-sp/caddy-cloudflare

参数说明：

• -p 80:80/-p 443:443：映射HTTP/HTTPS端口
• -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile：挂载本地Caddy配置文件
• -v caddy_data:/data：持久化存储证书、缓存等数据
• -v caddy_config:/config：保存配置API持久化数据

Docker Compose配置

yaml
version: '3.8'

services:
  caddy:
    image: paradox-sp/caddy-cloudflare
    container_name: caddy-cloudflare
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config
    environment:
      - CLOUDFLARE_API_TOKEN=your_cloudflare_token  # 可选，用于Caddyfile中引用

volumes:
  caddy_data:
  caddy_config:

Caddyfile配置示例（Cloudflare DNS验证）

caddyfile
example.com {
  # 使用Cloudflare DNS进行HTTPS证书申请
  tls {
    dns cloudflare {$CLOUDFLARE_API_TOKEN}  # 引用环境变量中的Cloudflare令牌
  }
  
  # 反向代理示例（代理到后端应用）
  reverse_proxy app:3000
  
  # 静态文件服务示例（如需要）
  # root * /usr/share/caddy
  # file_server
}

关键配置说明

环境变量

*注：当Caddyfile中使用Cloudflare DNS验证等需要API权限的功能时，必须提供该变量

持久化目录

参考链接

• Caddy官方文档：Caddy Website
• 镜像源代码：https://github.com/paradox-sp/caddy-cloudflare