aazario/duckdns-letsencrypt

Let's Encrypt for Duck DNS 镜像文档

镜像概述

本镜像提供了一种轻量级解决方案，可自动为Duck DNS域名生成Let's Encrypt SSL证书，无需暴露端口即可通过DNS挑战完成验证过程。适用于需要为动态IP环境下的Duck DNS域名配置SSL证书的场景。

维护与源码

• 维护者: Alejandro Azario
• 源码地址: [***]

支持的标签

• latest

核心功能与特性

• 自动生成Let's Encrypt SSL证书，无需暴露端口
• 支持标准域名证书和通配符证书
• 证书持久化存储，可被其他容器共享使用
• 可配置文件权限（UID/GID），增强安全性
• 支持测试环境（Staging）证书生成，避免生产环境请求限制

环境变量配置

使用注意事项

1. DUCKDNS_DOMAIN需已指向服务器的动态IP，可配合aazarios/duckdns镜像自动更新IP。

2. DUCKDNS_DOMAIN格式固定为<子域名>.duckdns.org，与LETSENCRYPT_WILDCARD设置无关。

3. 使用LETSENCRYPT_DOMAIN功能时，需创建以下DNS记录（记录不应启用代理）：

数据卷配置

• <certs>:/etc/letsencrypt: 用于持久化存储SSL证书的命名卷或主机卷。其他容器需访问证书时，应将此卷挂载为只读模式；本容器需以读写模式挂载。

使用方法

Docker Run 示例

bash
docker run \
    -e DUCKDNS_TOKEN=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX \
    -e DUCKDNS_DOMAIN=test.duckdns.org \
    -e LETSENCRYPT_WILDCARD=false \
    -e LETSENCRYPT_EMAIL=your@email.com \
    -e TESTING=false \
    -e UID=1000 \
    -e GID=1000 \
    -v ${PWD}/certs:/etc/letsencrypt \
    -it aazario/duckdns-letsencrypt

参数说明

• DUCKDNS_TOKEN: 替换为您的Duck DNS账户令牌
• DUCKDNS_DOMAIN: 替换为您的Duck DNS域名
• LETSENCRYPT_EMAIL: 可选，设置后将接收证书续期通知
• UID/GID: 建议设置为非root用户ID，增强安全性
• 卷挂载: ${PWD}/certs为本地证书存储路径，可根据实际需求调整