caddy-cloudflare

维护者： paradox-sp

镜像概述

该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
}

关键配置说明

环境变量

变量名	说明	必要性
`CLOUDFLARE_API_TOKEN`	Cloudflare API令牌，用于验证DNS等操作	可选*

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

持久化目录

容器目录	用途	建议挂载方式
`/etc/caddy`	存放Caddyfile配置文件	本地目录挂载（如`./caddy:/etc/caddy`）
`/data`	存储证书、缓存等运行时数据	Docker卷挂载（如`caddy_data:/data`）
`/config`	配置API持久化数据	Docker卷挂载（如`caddy_config:/config`）