serfriz/caddy-duckdns-ddns

Caddy Docker镜像（集成DuckDNS动态DNS模块）

![GitHub]([] ![Quay]([]

镜像概述

本镜像基于官方https://hub.docker.com/_/caddy%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%BD%93https://github.com/caddyserver/caddy%E5%8F%91%E5%B8%83%E6%96%B0%E7%89%88%E6%9C%AC%E6%97%B6%EF%BC%8C%E5%B0%86%E9%80%9A%E8%BF%87GitHub Actions自动更新。镜像包含以下扩展模块：

• DuckDNS模块：提供DuckDNS DNS-01 ACME验证支持 | https://github.com/caddy-dns/duckdns
• 动态DNS模块：自动使用实例公网IP地址更新DNS记录 | mholt/caddy-dynamicdns

核心功能与特性

主要功能

• DuckDNS DNS-01验证：支持通过DuckDNS进行ACME DNS-01挑战，实现SSL证书的自动签发与续期
• 动态DNS更新：实时监测并更新DNS记录至实例当前公网IP，适用于动态IP环境
• 与官方Caddy兼容：保留官方Caddy的全部功能，可直接复用官方镜像的配置方式

特性

• 自动版本更新：跟随Caddy官方版本自动构建
• 多平台支持：提供Caddy支持的所有架构版本
• 轻量化设计：基于官方Caddy镜像，保持精简体积

使用场景

• 动态IP环境：家庭网络、移动网络等公网IP频繁变化的场景
• 个人服务器：需要从公网访问且IP不固定的个人服务（如NAS、Web服务）
• SSL证书管理：需要自动获取和续期Let's Encrypt等免费SSL证书的场景
• 边缘计算节点：分布式部署中需要动态解析的边缘服务

使用方法

基础使用

本镜像完全兼容官方Caddy镜像的使用方式，可直接复用官方文档中的卷挂载、绑定挂载、端口映射等配置。扩展模块可能需要额外的环境变量，详细配置请参考项目https://github.com/serfriz/caddy-custom-builds?tab=readme-ov-file#container-creation%E3%80%82

镜像拉取

支持从以下容器仓库拉取镜像：

• Docker Hub

  bash
  docker pull serfriz/caddy-duckdns-ddns:latest
  

• GitHub Packages

  bash
  docker pull ghcr.io/serfriz/caddy-duckdns-ddns:latest
  

• Quay

  bash
  docker pull quay.io/serfriz/caddy-duckdns-ddns:latest
  

标签说明

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

• latest：最新稳定版本
• <version>：指定版本（如2.7.4，包含2.7、2等版本号格式）

部署示例

Docker Run示例

bash
docker run -d \
  --name caddy \
  -p 80:80 \
  -p 443:443 \
  -v ./Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  -v caddy_config:/config \
  -e DUCKDNS_TOKEN="your_duckdns_token" \
  serfriz/caddy-duckdns-ddns:latest

Docker Compose示例

yaml
version: "3.8"

services:
  caddy:
    image: serfriz/caddy-duckdns-ddns:latest
    container_name: caddy
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config
    environment:
      - DUCKDNS_TOKEN=your_duckdns_token
    restart: unless-stopped

volumes:
  caddy_data:
  caddy_config:

贡献

欢迎通过https://github.com/serfriz/caddy-custom-builds/issues%E6%88%96https://github.com/serfriz/caddy-custom-builds/pulls%E6%8F%90%E5%87%BA%E6%94%B9%E8%BF%9B%E5%BB%BA%E8%AE%AE%E3%80%81%E8%AF%B7%E6%B1%82%E6%B7%BB%E5%8A%A0%E5%85%B6%E4%BB%96%E6%A8%A1%E5%9D%97%E6%88%96%E5%8F%82%E4%B8%8E%E5%BC%80%E5%8F%91%E3%80%82

许可证

本软件采用https://github.com/serfriz/caddy-custom-builds/blob/main/LICENSE%E8%AE%B8%E5%8F%AF%E8%AF%81%EF%BC%8C%E7%A1%AE%E4%BF%9D%E7%94%A8%E6%88%B7%E6%9C%89%E6%9D%83%E4%BD%BF%E7%94%A8%E3%80%81%E4%BF%AE%E6%94%B9%E5%92%8C%E5%88%86%E5%8F%91%E8%BD%AF%E4%BB%B6%EF%BC%8C%E5%90%8C%E6%97%B6%E4%BF%9D%E6%8C%81%E6%BA%90%E4%BB%A3%E7%A0%81%E5%85%AC%E5%BC%80%E3%80%82%E8%AE%B8%E5%8F%AF%E8%AF%81%E4%BF%83%E8%BF%9B%E9%80%8F%E6%98%8E%E5%BA%A6%E3%80%81%E5%8D%8F%E4%BD%9C%E5%92%8C%E7%9F%A5%E8%AF%86%E5%85%B1%E4%BA%AB%EF%BC%8C%E7%94%A8%E6%88%B7%E9%9C%80%E9%81%B5%E5%AE%88GPL-3.0%E6%9D%A1%E6%AC%BE%E5%B9%B6%E4%BF%9D%E9%9A%9C%E4%BB%96%E4%BA%BA%E7%9A%84%E5%90%8C%E7%AD%89%E8%87%AA%E7%94%B1%E3%80%82