serfriz/caddy-cloudflare

Caddy Docker镜像（集成Cloudflare DNS和IPs模块）

概述

本镜像基于官方https://hub.docker.com/_/caddy镜像构建，当https://github.com/caddyserver/caddy发布新版本时，通过GitHub Actions自动更新。集成以下模块：

• Cloudflare DNS：支持Cloudflare DNS-01 ACME验证 | https://github.com/caddy-dns/cloudflare
• Cloudflare IPs：获取Cloudflare当前https://www.cloudflare.com/ips/ | https://github.com/WeidiDeng/caddy-cloudflare-ip

核心功能与特性

Cloudflare DNS模块

• 支持通过Cloudflare DNS执行DNS-01 ACME验证，用于自动管理SSL/TLS证书。
• 适用于需要在无法直接访问公网端口的环境中（如内网服务器）申请SSL证书的场景。

Cloudflare IPs模块

• 自动检索并更新Cloudflare的当前IP范围，便于配置Caddy以正确识别来自Cloudflare的请求。
• 适用于使用Cloudflare作为CDN/反向代理时，需要限制或允许Cloudflare IP访问的场景。

使用场景

• 作为Web服务器/反向代理，需通过Cloudflare DNS验证申请SSL证书的环境。
• 需要自动同步Cloudflare IP范围，以正确处理来自Cloudflare的流量（如设置真实IP头、访问控制等）。
• 基于Caddy官方镜像的现有部署，需要扩展Cloudflare相关功能的场景。

使用方法

镜像拉取

本镜像在以下容器仓库提供，支持Caddy所有官方支持的平台：

• Docker Hub
  docker pull docker.xuanyuan.run/serfriz/caddy-cloudflare:latest

• GitHub Packages
  docker pull ***-ghcr.xuanyuan.run/serfriz/caddy-cloudflare:latest

• Quay
  docker pull ***-quay.xuanyuan.run/serfriz/caddy-cloudflare:latest

基本使用

本镜像与官方Caddy Docker镜像使用方式兼容，可采用相同的https://docs.docker.com/storage/volumes/、https://docs.docker.com/storage/bind-mounts/、端口映射等配置。集成的模块可能需要额外https://caddyserver.com/docs/caddyfile/concepts#environment-variables，详细使用说明请参考仓库https://github.com/serfriz/caddy-custom-builds?tab=readme-ov-file#container-creation。

示例：基本运行命令

bash
docker run -d \
  --name caddy-cloudflare \
  -p 80:80 \
  -p 443:443 \
  -v ./Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  -v caddy_config:/config \
  docker.xuanyuan.run/serfriz/caddy-cloudflare:latest

标签说明

serfriz/caddy-cloudflare镜像提供以下标签：

• latest：最新稳定版本
• <version>：特定版本（如2.7.4、2.7、2等）

贡献

欢迎通过https://github.com/serfriz/caddy-custom-builds/issues或https://github.com/serfriz/caddy-custom-builds/pulls贡献代码、提出功能需求（如添加其他模块的Caddy镜像）或改进建议。

许可证

本软件采用https://github.com/serfriz/caddy-custom-builds/blob/main/LICENSE许可证，确保用户拥有使用、修改和分发软件的自由，同时保持源代码可访问性。用户需遵守GPL-3.0许可证条款，并向他人提供相同的自由。