serfriz/caddy-cloudflare-ddns

Caddy Docker镜像（集成Cloudflare动态DNS和IP模块）

镜像概述

本镜像基于官方https://hub.docker.com/_/caddy镜像构建，当https://github.com/caddyserver/caddy发布新版本时，将通过GitHub Actions自动更新。集成以下核心模块，增强与Cloudflare服务的协同能力：

• Cloudflare DNS：支持Cloudflare DNS-01 ACME验证，用于SSL证书自动签发 | https://github.com/caddy-dns/cloudflare
• Cloudflare IPs：自动获取Cloudflare当前https://www.cloudflare.com/ips/ | https://github.com/WeidiDeng/caddy-cloudflare-ip
• 动态DNS：使用实例公网IP自动更新DNS记录 | https://caddyserver.com/docs/modules/dynamic_dns

核心功能和特性

1. Cloudflare DNS-01 ACME验证

• 支持通过Cloudflare DNS记录完成ACME挑战，实现SSL证书的自动申请与续期，无需开放80/443端口至公网。

2. 动态DNS更新

• 监测并使用实例公网IP自动更新Cloudflare DNS记录，适用于动态IP环境（如家庭宽带、移动网络）下的域名解析管理。

3. Cloudflare IP范围同步

• 实时获取Cloudflare最新IP段，可用于配置防火墙规则或反向代理访问控制，确保仅允许Cloudflare边缘节点访问。

使用场景

• 动态IP环境下的域名管理：家庭服务器、个人云主机等动态IP场景，自动维持域名解析有效性。
• Cloudflare托管域名的SSL配置：通过DNS-01验证快速获取Let's Encrypt等证书，实现HTTPS加密。
• Cloudflare网络环境优化：基于实时IP范围配置安全策略，提升服务访问控制精度。

使用方法

基础配置

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

镜像拉取

支持多平台构建，可从以下容器仓库拉取：

• Docker Hub

  bash
  docker pull docker.xuanyuan.run/serfriz/caddy-cloudflare-ddns:latest
  

• GitHub Packages

  bash
  docker pull ***-ghcr.xuanyuan.run/serfriz/caddy-cloudflare-ddns:latest
  

• Quay

  bash
  docker pull ***-quay.xuanyuan.run/serfriz/caddy-cloudflare-ddns:latest
  

标签说明

镜像提供以下标签：

• latest：最新稳定版本
• <version>：特定版本（如2.7.4、2.7、2等），支持版本号前缀匹配

贡献

欢迎通过https://github.com/serfriz/caddy-custom-builds/issues提出功能需求，或通过https://github.com/serfriz/caddy-custom-builds/pulls参与开发，共同优化镜像功能。

许可证

基于https://github.com/serfriz/caddy-custom-builds/blob/main/LICENSE许可证发布，保障用户使用、修改和分发的自由，同时要求源代码公开，促进透明协作与知识共享。使用前请遵守许可证条款，确保衍生作品同样保障用户自由。