jayfong/caddy-dnspod

docker-caddy-dnspod

在Docker环境中运行Caddy WEB服务器的镜像，内置dnspod插件及多种实用功能插件。

镜像概述

本镜像基于Caddy构建，集成了dnspod DNS插件，可通过dnspod API自动申请和续期SSL证书（包括泛域名证书），同时包含多个常用HTTP插件，满足多样化的web服务需求。

核心功能

内置插件列表：

• http.cache：提供HTTP缓存功能
• http.cors：支持跨域资源共享配置
• http.expires：设置资源缓存过期时间
• http.realip：获取客户端真实IP地址
• http.ipfilter：基于IP地址过滤访问
• tls.dns.dnspod：通过dnspod DNS验证申请SSL证书

使用场景

1. 个人或企业快速搭建HTTPS网站
2. 部署需要跨域支持的API服务
3. 搭建需要IP访问控制的内部服务
4. 需要自动续期SSL证书的长期运行服务

配置说明

基础运行示例

bash
docker run \
  --rm \
  --publish 2015:2015 \
  jayfong/caddy-dnspod

运行后可通过http://localhost:2015访问默认页面。

生产环境示例（docker-compose）

yaml
version: '3'

services:
  caddy:
    image: jayfong/caddy-dnspod
    environment:
      - TZ=Asia/Shanghai # 设置时区
      - APPLICANT_EMAIL=your-email@example.com # SSL证书申请人邮箱
      - DNSPOD_API_KEY=your-id,your-token # dnspod API密钥（格式：ID,Token）
    volumes:
      - ./Caddyfile:/caddy/Caddyfile # 挂载自定义Caddy配置文件
      - ./data/certs:/caddy/certs # 持久化SSL证书
    ports:
      - 80:80 # HTTP端口
      - 443:443 # HTTPS端口
      - 2015:2015 # 测试端口
    restart: unless-stopped

关键配置说明

• Caddyfile：自定义服务配置文件，语法参考Caddy官方文档
• DNSPOD_API_KEY：需从dnspod控制台获取，用于DNS验证申请SSL证书
• 卷挂载：建议持久化Caddyfile和证书目录，避免容器重启丢失数据

参考

• https://github.com/abiosoft/caddy-docker

许可

Jay Fong © MIT