+4
Daily
17,558
stars
1,899
forks
62
watchers
581
prs
992
issues
211
releases
README
DDNS-GO

中文 | English
自动获得你的公网 IPv4 或 IPv6 地址,并解析到对应的域名服务。
- DDNS-GO
- 特性
- 系统中使用
- Docker中使用
- 使用IPv6
- Webhook
- Callback
- 界面
- 开发\&自行编译
特性
- 支持Mac、Windows、Linux系统,支持ARM、x86、RISC-V架构
- 支持的域名服务商 阿里云 阿里云 ESA 腾讯云 Dnspod Cloudflare 华为云 Callback 百度云 Porkbun GoDaddy Namecheap NameSilo Dynadot DNSLA 时代互联 Eranet Tnethk Gcore EdgeOne IBM NS1 Connect 雨云 deSEC
- 支持接口/网卡/命令获取IP
- 支持以服务的方式运行
- 默认间隔5分钟同步一次
- 支持同时配置多个DNS服务商
- 支持多个域名同时解析
- 支持多级域名
- 网页中配置,简单又方便,默认勾选禁止从公网访问
- 网页中方便快速查看最近50条日志
- 支持Webhook通知
- 支持TTL
- 支持部分DNS服务商传递自定义参数,实现地域解析/多IP等功能
[!NOTE]
建议在启用公网访问时,使用 Nginx 等反向代理软件启用 HTTPS 访问,以保证安全性。FAQ
系统中使用
- 从 Releases 下载并解压 ddns-go
- 安装服务
- Mac/Linux: sudo ./ddns-go -s install
- Win(以管理员打开cmd): .\ddns-go.exe -s install
- 配置
- 打开浏览器并访问http://localhost:9876进行初始化配置
- [可选] 服务卸载
- Mac/Linux: sudo ./ddns-go -s uninstall
- Win(以管理员打开cmd): .\ddns-go.exe -s uninstall
- [可选] 支持安装带参数
- -l 监听地址
- -f 同步间隔时间(秒)
- -cacheTimes 间隔N次与服务商比对
- -c 自定义配置文件路径
- -noweb 不启动web服务
- -skipVerify 跳过证书验证
- -dns 自定义 DNS 服务器
- -resetPassword 重置密码
- [可选] 参考示例
- 10分钟同步一次, 并指定了配置文件地址
bash
./ddns-go -s install -f 600 -c /Users/name/.ddns_go_config.yaml
- 每 10 秒检查一次本地 IP 变化, 每 30 分钟对比一下 IP 变化, 实现 IP 变化即时触发更新且不会被服务商限流, 如果使用接口获取IP, 需要注意接口限流
bash
./ddns-go -s install -f 10 -cacheTimes 180
- 重置密码
bash
./ddns-go -resetPassword 123456
./ddns-go -resetPassword 123456 -c /Users/name/.ddns_go_config.yaml
Docker中使用
- 挂载主机目录, 使用docker host模式。可把 /opt/ddns-go 替换为你主机任意目录, 配置文件为隐藏文件
bash
docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root jeessy/ddns-go
- 打开浏览器并访问http://Docker主机IP:9876进行初始化配置
- [可选] 使用 ghcr.io 镜像
bash
docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root ghcr.io/jeessy2/ddns-go
- [可选] 支持启动带参数 -l监听地址 -f间隔时间(秒)
bash
docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root jeessy/ddns-go -l :9877 -f 600
- [可选] 不使用docker host模式
bash
docker run -d --name ddns-go --restart=always -p 9876:9876 -v /opt/ddns-go:/root jeessy/ddns-go
- [可选] 重置密码
bash
docker exec ddns-go ./ddns-go -resetPassword 123456
docker restart ddns-go
使用IPv6
- 前提:你的电脑或终端能正常获取IPv6,并能正常访问IPv6
- Windows/Mac:推荐 系统中使用,Windows/Mac桌面版的docker不支持--net=host
- 群晖:
- 套件中心下载docker并打开
- 注册表中搜索ddns-go并下载
- 映像 - 选择jeessy/ddns-go - 启动 - 高级设置 - 网络中勾选使用与 Docker Host 相同的网络,高级设置中勾选启动自动重新启动
- 在浏览器中打开http://群晖IP:9876,修改你的配置,成功
- Linux的x86或arm架构,推荐使用Docker的--net=host模式。参考 Docker中使用
- 虚拟机中使用有可能正常获取IPv6,但不能正常访问IPv6
Webhook
- 支持webhook, 域名更新成功或不成功时, 会回调填写的URL
- 支持的变量
| 变量名 | 说明 |
| -------------- | ---------------------------------------- |
| {ipv4Addr} | 新的IPv4地址 |
| {ipv4Result} | IPv4地址更新结果: 未改变 失败 成功 |
| {ipv4DomainTop issues
#531通过命令获取IP参考101 comments · 2023-02-07#327Webhook配置参考73 comments · 2022-07-24#1使用阿里ddns不要解析网站到家用宽带上34 comments · 2020-08-31#1703cloudns更新域名失败10 comments · 2026-05-23#1327获取最新有效期 ipv6 地址9 comments · 2024-11-25#1377用飞牛NAS时,解析IPV6地址遇到命令获取失败的情况~6 comments · 2025-01-27#1197群晖使用SPK7套件源安装的DDNS-GO忘记了密码如何重置?6 comments · 2024-07-23#1296cloudflare突然就变这样了,改了api还是不行。。5 comments · 2024-10-27
Discussions
#1762使用docker-compose启动配置callback功能,但是他总在我的宿主机/root目录下创建callback调用请求的同名文件。1 comments · 2026-09-17#1757Cloudfare更新二级域名,提示Root domain not found in DNS provider: abcd.com0 comments · 2026-09-07#1696【求助帖】请求推荐好用的本机 IPv6 地址查询 API0 comments · 2026-05-15#1695关于启动参数修改的问题0 comments · 2026-05-15#1655如何在 IPv6 配置处为每个网卡上的地址分配到不同的域名中?0 comments · 2026-03-24#1653局域网获取ipv6第4位为0时通过命令无法获取0 comments · 2026-03-16#1647.ddns_go_config.yaml中的DNS服务商的Token密钥能否在加密显示?0 comments · 2026-03-12#1621非常希望ddns-go能在之后的新版本中增加“SSL/TLS证书”功能的支持0 comments · 2026-02-02
Latest release
v6.17.8 v6.17.8 2026-11-09Changelog b521e5e32e78a484631b7f3e9ce31f4e28c65380 build(deps): bump docker/login-action from 4.6.0 to 4.8.0 (1775) d36043bed18b515e3f3607ef5cd7614a2e7a28b5 build(deps): bump golang.org/x/net from 0.58.0 to 0.62.0 (1774)