¶ ddns-go
Original link click here.
自动获得你的公网 IPv4 或 IPv6 地址，并解析到对应的域名服务。
¶ 特性
- 支持Mac、Windows、Linux系统，支持ARM、x86架构
- 支持的域名服务商
阿里云腾讯云DnspodCloudflare华为云Callback百度云PorkbunGoDaddyNamecheapNameSiloDynadot - 支持接口/网卡/命令获取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:
-
[可选] 服务卸载
- Mac/Linux:
sudo ./ddns-go -s uninstall - Win(以管理员打开cmd):
.\ddns-go.exe -s uninstall
- Mac/Linux:
-
[可选] 支持安装带参数
-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
- 10分钟同步一次, 并指定了配置文件地址
-
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
-
支持的变量
变量名 说明 # 新的IPv4地址 # IPv4地址更新结果: 未改变失败成功# IPv4的域名，多个以 ,分割# 新的IPv6地址 # IPv6地址更新结果: 未改变失败成功# IPv6的域名，多个以 ,分割 -
如 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中输入
{ "msgtype": "markdown", "markdown": { "title": "你的公网IP变了", "text": "#### 你的公网IP变了 \n - IPv4地址：#{ipv4Addr} \n - 域名更新结果：#{ipv4Result} \n" } }
-
飞书
- 飞书电脑端 -> 群设置 -> 添加机器人 -> 自定义机器人
- 安全设置只勾选
自定义关键词, 输入的关键字必须包含在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
-
plusplus 推送加
- 获取token
- URL中输入
https://www.pushplus.plus/send - RequestBody中输入
{ "token": "your token", "title": "你的公网IP变了", "content": "你的公网IP变了 \n - IPv4地址：#{ipv4Addr} \n - 域名更新结果：#{ipv4Result} \n" }
-
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}" } } ] }
¶ Callback
-
通过自定义回调可支持更多的第三方DNS服务商
-
配置的域名有几行, 就会回调几次
-
支持的变量
变量名 说明 # 新的IPv4/IPv6地址 # 当前域名 # 记录类型 A或AAAA# TTL -
如 RequestBody 为空则为 GET 请求，否则为 POST 请求
¶ 界面
¶ 开发&自行编译
- 如果喜欢从源代码编译自己的版本，可以使用本项目提供的 Makefile 构建
- 使用
make build生成本地编译后的ddns-go可执行文件 - 使用
make build_docker_image自行编译 Docker 镜像
¶ 安装脚本
#!/bin/bash
NIC=$(ip r | grep default | awk -F"dev" '{print $2}' | awk '{print $1}')
tokenID=$1
tokenSecret=$2
Domains=$3
passwordHash=$4
USAGE() {
echo "Usage: $(basename $0) [option]"
echo "Options: tokenID tokenSecret DDNS_Domain passwordHash"
}
if [[ $# -ne 4 ]];then
USAGE
exit 1
fi
wget https://github.com/jeessy2/ddns-go/releases/download/v6.6.5/ddns-go_6.6.5_linux_x86_64.tar.gz && \
tar zxvf ddns-go_6.6.5_linux_x86_64.tar.gz && chown -R root:root ddns-go_6.6.5_linux_x86_64 && \
mv ddns-go_6.6.5_linux_x86_64/ddns-go /usr/local/bin && mkdir -p /etc/ddns-go
cat>/lib/systemd/system/ddns-go.service<<EOF
[Unit]
Description=简单好用的DDNS。自动更新域名解析到公网IP(支持阿里云、腾讯云dnspod、Cloudflare、华为云)
ConditionFileIsExecutable=/usr/local/bin/ddns-go
[Service]
StartLimitInterval=5
StartLimitBurst=10
ExecStart=/usr/local/bin/ddns-go "-l" ":7000" "-f" "300" "-c" "/etc/ddns-go/ddns_go_config.yaml"
Restart=always
RestartSec=120
EnvironmentFile=-/etc/sysconfig/ddns-go
[Install]
WantedBy=multi-user.target
EOF
## Config file
cat>/etc/ddns-go/ddns_go_config.yaml<<EOF
dnsconf:
- name: ""
ipv4:
enable: true
gettype: url
url: https://api.ipify.org, https://ddns.oray.com/checkip, https://ip.3322.net, https://4.ipw.cn
netinterface: ${NIC}
cmd: ""
domains:
- ${Domains}
ipv6:
enable: false
gettype: url
url: https://api64.ipify.org, https://speed.neu6.edu.cn/getIP.php, https://v6.ident.me, https://6.ipw.cn
netinterface: ${NIC}
cmd: ""
ipv6reg: ""
domains:
- ${Domains}
dns:
name: alidns
id: ${tokenID}
secret: ${tokenSecret}
ttl: ""
user:
username: konvict
password: ${passwordHash}
webhook:
webhookurl: ""
webhookrequestbody: ""
webhookheaders: ""
notallowwanaccess: true
lang: en
EOF
systemctl daemon-reload && systemctl enable --now ddns-go