DDNS-GO

中文 | English
自动获得你的公网 IPv4 或 IPv6 地址,并解析到对应的域名服务。
特性
- 支持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分钟同步一次, 并指定了配置文件地址
./ddns-go -s install -f 600 -c /Users/name/.ddns_go_config.yaml
- 每 10 秒检查一次本地 IP 变化, 每 30 分钟对比一下 IP 变化, 实现 IP 变化即时触发更新且不会被服务商限流, 如果使用接口获取IP, 需要注意接口限流
./ddns-go -s install -f 10 -cacheTimes 180
- 重置密码
./ddns-go -resetPassword 123456
./ddns-go -resetPassword 123456 -c /Users/name/.ddns_go_config.yaml
Docker中使用
挂载主机目录, 使用docker host模式。可把 /opt/ddns-go 替换为你主机任意目录, 配置文件为隐藏文件
docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root jeessy/ddns-go
打开浏览器并访问http://Docker主机IP:9876进行初始化配置
[可选] 使用 ghcr.io 镜像
docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root ghcr.io/jeessy2/ddns-go
[可选] 支持启动带参数 -l监听地址 -f间隔时间(秒)
docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root jeessy/ddns-go -l :9877 -f 600
[可选] 不使用docker host模式
docker run -d --name ddns-go --restart=always -p 9876:9876 -v /opt/ddns-go:/root jeessy/ddns-go
[可选] 重置密码
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地址更新结果: 未改变 失败 成功 |
| #{ipv4Domains} |
IPv4的域名,多个以,分割 |
| #{ipv6Addr} |
新的IPv6地址 |
| #{ipv6Result} |
IPv6地址更新结果: 未改变 失败 成功 |
| #{ipv6Domains} |
IPv6的域名,多个以,分割 |
| #{timestamp} |
当前 UTC+0 时间戳(秒) |
如 RequestBody 为空则为 GET 请求,否则为 POST 请求
Server酱
https://sctapi.ftqq.com/[SendKey].send?title=你的公网IP变了&desp=主人IPv4变了#{ipv4Addr},域名更新结果:#{ipv4Result}
Bark
https://api.day.app/[YOUR_KEY]/主人IPv4变了#{ipv4Addr},域名更新结果:#{ipv4Result}
钉钉
飞书
- 飞书电脑端 -> 群设置 -> 添加机器人 -> 自定义机器人
- 安全设置只勾选
自定义关键词, 输入的关键字必须包含在RequestBody的content中, 如:你的公网IP变了
- URL中输入飞书给你的
Webhook地址
- RequestBody中输入
{
"msg_type": "post",
"content": {
"post": {
"zh_cn": {
"title": "你的公网IP变了",
"content": [
[
{
"tag": "text",
"text": "IPv4地址:#{ipv4Addr}"
}
],
[
{
"tag": "text",
"text": "域名更新结果:#{ipv4Result}"
}
]
]
}
}
}
}
Telegram
ddns-telegram-bot
plusplus 推送加
Discord
- Discord任意客户端 -> 伺服器 -> 频道设置 -> 整合 -> 查看Webhook -> 新Webhook -> 复制Webhook网址
- URL中输入Discord复制的
Webhook网址
- RequestBody中输入
{
"content": "域名 #{ipv4Domains} 动态解析 #{ipv4Result}.",
"embeds": [
{
"description": "#{ipv4Domains} 的动态解析 #{ipv4Result}, IP: #{ipv4Addr}",
"color": 15258703,
"author": {
"name": "DDNS"
},
"footer": {
"text": "DDNS #{ipv4Result}"
}
}
]
}
微信
- 通过 微信 ClawBot 协议 推送消息到微信
- 需要先通过协议获取 $your_bot_token 和 $your_user_id,可参考 1
- URL 中输入
https://ilinkai.weixin.qq.com/ilink/bot/sendmessage
- RequestBody 中输入
{
"msg": {
"from_user_id": "",
"to_user_id": "[email protected]",
"client_id": "ddns-#{timestamp}",
"message_type": 2,
"message_state": 2,
"item_list": [
{
"type": 1,
"text_item": {
"text": "📡 IPv4: #{ipv4Result}\n 新地址: #{ipv4Addr}\n 已绑定域名: #{ipv4Domains}\n\n📡 IPv6: #{ipv6Result}\n 新地址: #{ipv6Addr}\n 已绑定域名: #{ipv6Domains}"
}
}
]
},
"base_info": {
"channel_version": "2.1.7"
}
}
- Headers 中输入
Content-Type: application/json
AuthorizationType: ilink_bot_token
Authorization: Bearer $your_bot_token
iLink-App-Id: bot
iLink-App-ClientVersion: 131335
查看更多Webhook配置参考
Callback
界面

开发&自行编译
- 如果喜欢从源代码编译自己的版本,可以使用本项目提供的 Makefile 构建
- 使用
make build 生成本地编译后的 ddns-go 可执行文件
- 使用
make build_docker_image 自行编译 Docker 镜像