reverie89/caddy Docker 镜像 - 轩辕镜像

镜像概述

reverie89/caddy是一个基于官方Caddy v2镜像构建的Docker镜像，额外集成了caddy-dns/cloudflare模块。该镜像每日检查官方Caddy镜像更新，确保功能与官方版本同步，主要用于通过Cloudflare DNS验证自动获取SSL证书，支持反向代理、静态网站托管等Web服务场景。

核心功能与特性

• 基于官方Caddy v2镜像，保留Caddy原生功能（自动HTTPS、反向代理、静态文件服务等）
• 集成Cloudflare DNS模块，支持通过Cloudflare DNS验证方式获取SSL证书
• 每日自动更新，确保与官方Caddy镜像同步最新特性和安全修复
• 支持环境变量配置Cloudflare API凭证，简化证书配置流程

使用场景

• 需要通过Cloudflare DNS验证获取SSL证书的Web服务
• 反向代理后端应用服务（如API服务、容器化应用等）
• 托管静态网站并自动配置HTTPS
• 需频繁更新SSL证书且依赖Cloudflare DNS的场景

使用方法

docker-compose配置示例

yaml
services:
  caddy:
    image: reverie89/caddy
    container_name: caddy
    restart: always
    environment:
      - CLOUDFLARE_API_TOKEN=xxx  # 替换为你的Cloudflare API令牌
    ports:
      - "80:80/tcp"   # HTTP端口
      - "443:443/tcp" # HTTPS端口
    volumes:
      - "/etc/localtime:/etc/localtime:ro"  # 同步主机时间
      - "./Caddyfile:/etc/caddy/Caddyfile"  # 挂载Caddy配置文件
      - "./config:/config"                  # Caddy配置目录
      - "./data:/data"                      # Caddy数据目录（含证书等）
      - "/var/www:/var/www"                 # 静态网站文件目录（根据需求调整）

Caddyfile配置示例

Caddyfile是Caddy的核心配置文件，以下是结合Cloudflare DNS的典型配置示例：

sh
# 反向代理配置示例
subdomain.example.com {
  tls {
    dns cloudflare {env.CLOUDFLARE_API_TOKEN}  # 使用环境变量中的Cloudflare API令牌
  }
  reverse_proxy /* endpoint:80  # 将所有请求反向代理到后端服务endpoint:80
}

# 静态网站托管示例
example.com {
  tls {
    dns cloudflare {env.CLOUDFLARE_API_TOKEN}  # 使用环境变量中的Cloudflare API令牌
  }
  root * /var/www/example.com  # 指定静态文件根目录
}

更多Caddyfile配置细节可参考官方文档。

注意事项

• Cloudflare API令牌要求：Caddy v2需要Cloudflare API令牌（而非全局API密钥），若无令牌需先创建
• 数据持久化：必须通过卷挂载/config和/data目录，以确保Caddy配置和证书数据持久化
• 平滑重载配置：修改Caddyfile后，通过以下命令平滑重载（无需重启容器）：
  docker exec -w /etc/caddy {container_name} caddy reload
  （将{container_name}替换为实际容器名，如示例中的caddy）
• 格式化配置文件：使用以下命令格式化并覆盖Caddyfile，确保语法正确：
  docker exec -w /etc/caddy {container_name} caddy fmt --overwrite