wdullaer/dd-dns
wdullaer
基于容器标签自动创建和更新DNS提供商的A记录，适用于与反向代理配合，在同一主机上通过唯一名称暴露多个服务，支持可插拔的DNS提供商和状态存储。
下载次数: 0状态：社区镜像维护者：wdullaer仓库类型：镜像最近更新：7 个月前
让 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 DNS Updater
镜像概述和主要用途
dd-dns 是一款根据运行中容器的标签数据，在DNS提供商中创建和更新DNS A记录的工具。它旨在与 traefik 或 https://github.com/lucaslorentz/caddy-docker-proxy 等反向代理配合使用，使您能在同一主机上通过唯一名称暴露多个服务。虽然也可用于云原生服务发现，但已有更成熟的工具（如 consul）可供选择。DNS提供商和内部状态存储均支持插件化，使其适用于多种场景。
核心功能和特性
支持的状态存储
- 临时内存数据库
- 持久化嵌入式 boltdb
支持的DNS提供商
- Cloudflare
- Dryrun：非实际提供商，仅将所有更改打印到控制台，用于测试配置是否符合预期
限制
当前存在以下限制（并非超出范围，而是因未满足个人使用场景需求）：
- 仅支持 IPv4
- 仅可创建 A 记录
- 主机 IP 必须手动指定或使用第一个内部容器 IP（获取主机 IP 需要在主机上运行或挂载主机网络，且需大量配置才能找到正确 IP，目前让用户预先指定更简单）
使用场景和适用范围
适用于需要通过容器标签自动管理DNS A记录的场景，特别是与反向代理配合，在单主机上通过不同域名暴露多个服务的场景。例如，在同一服务器上运行多个Web服务，通过容器标签指定各自域名，由dd-dns自动更新DNS记录，实现通过域名访问不同服务。
详细使用方法和配置说明
安装
可从 https://github.com/wdullaer/dd-dns/releases 下载对应平台的最新版本。也可使用Docker Hub上的预构建镜像：
bashdocker run -v /var/run/docker.sock:/var/run/docker.sock:ro -v /some/directory:/data wdullaer/dd-dns
使用
dd-dns 是命令行应用，通过以下命令查看完整选项：
bashdd-dns --help
选项可通过命令行标志或环境变量传递，命令行标志优先级高于环境变量。
配置选项
| 选项名 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
| account-name | ACCOUNT_NAME | - | 用于DNS提供商认证的账户名（或等效标识） |
| account-secret | ACCOUNT_SECRET | - | 用于DNS提供商认证的账户密钥（或等效凭证） |
| dns-content | DNS_CONTENT | container | 添加到DNS记录的IP地址，可选值：container（容器IP）或具体IPv4地址 |
| docker-label | DOCKER_LABEL | dd-dns.hostname | 包含域名的Docker标签 |
| provider | PROVIDER | cloudflare | DNS提供商，可选值：cloudflare、dryrun |
| store | STORE | memory | 持久化内部状态的存储实现，可选值：memory（内存）、boltdb |
| debug-logger | - | false | 是否使用人类可读日志（非结构化日志） |
| data-directory | DATA_DIRECTORY | 当前工作目录 | 持久化状态存储的目录 |
架构
应用依赖三个核心实体：
┌──────────────────────────────────────┐ │ Docker │ └──────────────────────────────────────┘ │ │ 容器事件 ▼ ┌──────────────────────────────────────┐ │ Store │ │ A 记录 -> []容器ID │ └──────────────────────────────────────┘ │ 新增/移除A记录 ▼ ┌──────────────────────────────────────┐ │ DNSProvider │ └──────────────────────────────────────┘
- Docker：提供配置DNS提供商所需的数据。启动时查询并处理守护进程的当前状态，之后通过监听容器事件处理增量变更。
- Store：维护A记录到容器ID的映射。由于一个A记录可能被多个容器需要，不能仅基于Docker事件盲目更新DNSProvider，需保留此状态。
- DNSProvider：抽象与服务提供商API的交互，提供插入和删除A记录的方法。
当前Store负责与DNSProvider交互，实现会尽量减少对DNSProvider API的调用，并通过事务执行交互，确保内部状态与远程服务提供商状态一致。
构建
原生构建
bashgo build
Docker构建
bashdocker build .
待办/改进思路
- 通过Docker标签查找应使用的网络IP地址
- 研究使用 https://github.com/spf13/viper
- 研究通过 https://github.com/hashicorp/go-plugin 实现DNS提供商插件
- 研究所需状态配置管理，确保远程状态与存储中的状态一致（通过轮询或事件）
- 为Cloudflare提供商添加更多测试
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull wdullaer/dd-dns:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"