efrecon/duckdns
efrecon
这是一个基于纯POSIX shell的DuckDNS动态域名更新器Docker镜像，支持环境变量/命令行参数配置，可单次或定期自动更新域名解析，兼容嵌入式系统。
下载次数: 0状态：社区镜像维护者：efrecon仓库类型：镜像最近更新：5 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
DuckDNS更新器镜像
镜像概述
本镜像提供DuckDNS动态域名解析更新功能，包含纯POSIX shell编写的duckdns.sh脚本，依赖wget或curl（支持busybox受限版本），兼容小型嵌入式系统。镜像基于Alpine Linux，通过环境变量或命令行参数灵活配置，实现域名解析的自动化维护。
核心功能
- 支持环境变量与CLI参数双重配置（CLI参数优先级更高）
- 可执行单次更新或按指定周期（秒/人类可读格式如
1d）自动更新 - 自动获取外部IP或手动指定绑定IP
- 支持多域名（逗号分隔）批量更新
- 可配置网络超时与日志输出级别
使用场景
- 家庭服务器、NAS设备等动态IP场景的域名绑定
- 嵌入式设备（路由器/物联网设备）的动态域名维护
- 自动化运维中域名解析的定期更新需求
配置说明
环境变量
所有配置变量以DUCKDNS_前缀开头：
DUCKDNS_DOMAINS：逗号分隔的域名列表（可省略.duckdns.org后缀）DUCKDNS_PERIOD：更新周期（空/0/负数为单次更新，支持2h/1d等格式）DUCKDNS_TOKEN：DuckDNS账户API令牌（UUID格式）DUCKDNS_IP：指定绑定IP（默认自动获取）DUCKDNS_URL：API根地址（默认https://www.duckdns.org/update）DUCKDNS_TIMEOUT：网络超时时间（默认30秒）VERBOSE：日志级别（0仅打印警告，非0输出详细信息）
CLI选项
-d/--domains：对应DUCKDNS_DOMAINS-p/--period：对应DUCKDNS_PERIOD-t/--token：对应DUCKDNS_TOKEN--ip：对应DUCKDNS_IP--silent/--quiet：设置VERBOSE=0
Docker部署示例
查看帮助信息
shelldocker run -it --rm efrecon/duckdns -h
定期更新配置（每1小时更新一次）
shelldocker run -d --name duckdns-updater \ -e DUCKDNS_DOMAINS="my-home-server,my-nas" \ -e DUCKDNS_TOKEN="your-unique-duckdns-token" \ -e DUCKDNS_PERIOD="1h" \ efrecon/duckdns
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull efrecon/duckdns:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"