geeter/caddy-dnspod

geeter/caddy-dnspod 镜像说明

镜像概述

geeter/caddy-dnspod是一个预集成dnspod、jwt和login插件的Caddy Docker镜像，旨在简化Web服务的HTTPS证书自动签发（通过DNSPod DNS-01挑战）及身份认证管理流程。

核心功能

1. DNSPod插件：支持通过DNSPod域名解析服务完成Let's Encrypt证书的自动申请与续期（DNS验证方式）；
2. JWT插件：提供基于JSON Web Token的身份认证能力，适用于API接口或页面访问控制；
3. Login插件：支持用户账号密码登录功能，可用于保护需要身份验证的Web资源；
4. 灵活配置：可通过环境变量调整证书获取参数、DNS查询间隔等。

使用场景

1. 需通过DNSPod解析域名并自动获取HTTPS证书的静态/动态网站部署；
2. 需要JWT认证的API服务；
3. 需简单用户登录功能的内部系统或私有站点。

配置说明

环境变量

• ACME_AGREE=true：必须设置为true以同意ACME协议（Let's Encrypt证书申请要求）；
• DNSPOD_API_KEY：你的DNSPod API密钥（格式为ID,Token）；
• DNSPOD_POLLING_INTERVAL：DNS记录查询间隔（默认30秒）；
• DNSPOD_PROPAGATION_TIMEOUT：DNS记录传播超时时间（默认600秒）。

卷挂载

• /srv：网站根目录，存放静态资源或应用代码；
• /etc/Caddyfile：Caddy配置文件路径；
• /root/.caddy：证书及配置存储目录，建议持久化挂载以保留证书。

端口映射

• 80端口：HTTP服务（自动重定向至HTTPS）；
• 443端口：HTTPS服务。

部署示例

Docker Run命令

bash
docker run -d \
    -e ACME_AGREE=true \
    -e DNSPOD_API_KEY="你的DNSPod API密钥" \
    -v /本地网站目录:/srv \
    -v /本地Caddyfile路径:/etc/Caddyfile \
    -v /本地证书存储目录:/root/.caddy \
    -p 80:80 \
    -p 443:443 \
    geeter/caddy-dnspod

说明

替换命令中的你的DNSPod API密钥及本地路径为实际值，即可启动带有HTTPS和认证功能的Caddy服务。