热门搜索:
davd/docker-ddns
davd
自动构建
基于Docker、Go和Bind9的易部署动态DNS服务，帮助用户从全球任何地方连接家中设备，只需VPS、域名及DNS访问权限即可快速搭建。
17 次收藏下载次数: 0状态：自动构建维护者：davd仓库类型：镜像最近更新：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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
基于Docker、Go和Bind9的动态DNS服务
!DockerHub构建状态 !Travis构建状态
本镜像可帮助您搭建动态DNS服务器，让您从全球任何地方连接家中设备。只需一台廉价VPS、一个域名及该域名的DNS访问权限即可实现。
!https://raw.githubusercontent.com/dprandzioch/docker-ddns/develop/connect-to-your-nas-from-work.png
镜像概述
该镜像整合Docker、Go和Bind9技术，提供易部署的动态DNS解决方案，支持通过REST API更新DNS记录，兼容多种路由器（如Fritz!Box、D-Link）的自定义DDNS设置，还提供DynDNS兼容接口适配更多客户端。
核心功能
- 基于Bind9的DNS服务（支持TCP/UDP端口53）
- Go编写的管理REST API（端口8080），用于更新DNS记录
- 支持IPv4/IPv6地址
- DynDNS兼容接口，适配主流路由器和ddclient等客户端
- 持久化存储DNS配置
- 日志可通过Docker日志查看
使用场景
- 远程访问家中NAS、摄像头等设备
- 个人网站/服务的动态IP解析
- 家庭网络设备的远程管理
配置说明
安装方式
从DockerHub拉取
自定义命令运行：
docker run -it -d \ -p 8080:8080 \ -p 53:53 \ -p 53:53/udp \ -e SHARED_SECRET=changeme \ -e ZONE=example.org \ -e RECORD_TTL=3600 \ --name=dyndns \ davd/docker-ddns:latest
持久化配置需添加-v /somefolder:/var/cache/bind（确保目录对root有写入权限：chmod -R a+w /somefolder）。
Docker Compose/Swarm
参考示例文件：https://github.com/dprandzioch/docker-ddns/blob/master/docker-compose.yml
源码构建
git clone https://github.com/dprandzioch/docker-ddns git checkout master cd docker-ddns $EDITOR envfile # 修改环境变量 make deploy
环境变量详情参考：官方指南
暴露端口
- 53/TCP → DNS服务
- 53/UDP → DNS服务
- 8080/TCP → 管理API
API使用
标准REST API
GET请求更新记录：
http://myhost.mydomain.tld:8080/update?secret=changeme&domain=foo&addr=1.2.3.4
参数：
secret：共享密钥domain：子域名（多域名用逗号分隔）addr：IP地址
DynDNS兼容接口
支持路径：/nic/update、/v2/update、/v3/update
用户名任意，密码为共享密钥。示例（Ubiquiti路由器）：
set service dns dynamic interface eth0 service dyndns host-name <您的DDNS主机名> set service dns dynamic interface eth0 service dyndns login <任意用户名> set service dns dynamic interface eth0 service dyndns password <共享密钥> set service dns dynamic interface eth0 service dyndns protocol dyndns2 set service dns dynamic interface eth0 service dyndns server <您的DDNS服务器>
查看日志
docker logs -f dyndns
DNS设置
在主域名添加子域名委托：
dyndns IN NS ns ns IN A <DNS服务器IPv4> ns IN AAAA <可选IPv6>
API访问地址：http://ns.domain.tld:8080/update?...，传入foo则生成foo.dyndns.domain.tld。
常见问题
- systemd-based系统中
systemd-resolved可能占用53端口：修改/etc/systemd/resolved.conf添加DNSStubListener=no，重启服务sudo systemctl restart systemd-resolved.service（注意影响）。 更多信息：systemd文档、https://github.com/dprandzioch/docker-ddns/issues/5
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 docker-ddns 镜像标签
docker pull docker.xuanyuan.run/davd/docker-ddns:<标签>
DockerHub 原生拉取命令
docker pull davd/docker-ddns:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"