ddns-go

中文 | 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等功能

[!注意] 建议在启用公网访问时，使用Nginx等反向代理软件启用HTTPS访问，以确保安全性。常见问题

在系统中使用

从Releases下载并解压ddns-go
安装服务
- Mac/Linux: sudo ./ddns-go -s install
- Windows(以管理员身份打开cmd): .\ddns-go.exe -s install
[可选] 卸载服务
- Mac/Linux: sudo ./ddns-go -s uninstall
- Windows(以管理员身份打开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酱

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

ddns-telegram-bot

plusplus 推送加

获取token
在URL中输入 https://www.pushplus.plus/send

在RequestBody中输入

{
    "token": "你的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}"
            }
        }
    ]
}

查看更多Webhook配置参考

回调

通过自定义回调可支持更多的第三方DNS服务商
配置的域名有几行，就会回调几次
支持的变量

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

变量名	说明
#{ip}	新的IPv4/IPv6地址
#{domain}	当前域名
#{recordType}	记录类型 `A`或`AAAA`
#{ttl}	TTL

界面

开发与自行编译

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