ddns-go

WYY

https://github.com/jeessy2/ddns-go?tab=readme-ov-file


ddns-go
GitHub release GitHub release downloads Go version   

中文 | English

自动获得你的公网 IPv4 或 IPv6 地址，并解析到对应的域名服务。

特性
系统中使用
Docker中使用
使用IPv6
Webhook
Callback
界面
开发&自行编译
特性
支持Mac、Windows、Linux系统，支持ARM、x86架构
支持的域名服务商 阿里云 腾讯云 Dnspod Cloudflare 华为云 Callback 百度云 Porkbun GoDaddy Namecheap NameSilo Dynadot
支持接口/网卡/命令获取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
[可选] 服务卸载

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
[可选] 使用 Homebrew 安装 ddns-go：

brew install ddns-go
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://主机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的域名，多个以,分割
如 RequestBody 为空则为 GET 请求，否则为 POST 请求

Server酱
Bark
钉钉
飞书
Telegram
plusplus 推送加
Discord
查看更多Webhook配置参考

Callback
通过自定义回调可支持更多的第三方DNS服务商

配置的域名有几行, 就会回调几次

支持的变量

变量名        说明
#{ip}        新的IPv4/IPv6地址
#{domain}        当前域名
#{recordType}        记录类型 A或AAAA
#{ttl}        TTL
如 RequestBody 为空则为 GET 请求，否则为 POST 请求

Callback配置参考

界面
screenshots

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