Repository: jeessy2/ddns-go

Stars: 16636

README.md Copy Chapter

DDNS-GO

    

中文 | English

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

- 特性
- 系统中使用
- Docker中使用
- 使用IPv6
- Webhook
- Callback
- 界面
- 开发&自行编译

特性 Copy Chapter

- 支持Mac、Windows、Linux系统，支持ARM、x86、RISC-V架构
- 支持的域名服务商 阿里云 阿里云 ESA 腾讯云 Dnspod Cloudflare 华为云 Callback 百度云 Porkbun GoDaddy Namecheap NameSilo Dynadot DNSLA 时代互联 Eranet Tnethk Gcore EdgeOne IBM NS1 Connect 雨云
- 支持接口/网卡/命令获取IP
- 支持以服务的方式运行
- 默认间隔5分钟同步一次
- 支持同时配置多个DNS服务商
- 支持多个域名同时解析
- 支持多级域名
- 网页中配置，简单又方便，默认勾选禁止从公网访问
- 网页中方便快速查看最近50条日志
- 支持Webhook通知
- 支持TTL
- 支持部分DNS服务商传递自定义参数，实现地域解析/多IP等功能

EdgeOne 源站组 Copy Section

EdgeOne 除了支持 DNS 记录外，也支持通过 ModifyOriginGroup 动态更新源站组 IP。

- 在域名后追加 ?GroupId=origin-xxx 或 ?OriginGroupName=your-group
- 可选追加 &ZoneId=zone-xxx 直接指定站点 ID；不填时按根域名自动查询
- 可选追加 &Weight=100 指定源站权重，默认 100
- 如果同一个源站组同时启用 IPv4 / IPv6，请在 IPv4、IPv6 两边填写相同的域名和相同的查询参数

系统中使用 Copy Chapter

- 从 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

./ddns-go -s install -f 10 -cacheTimes 180

./ddns-go -resetPassword 123456
    ./ddns-go -resetPassword 123456 -c /Users/name/.ddns_go_config.yaml

Docker中使用 Copy Chapter

- 挂载主机目录, 使用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 Copy Chapter

- 前提：你的电脑或终端能正常获取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 Copy Chapter

- 支持webhook, 域名更新成功或不成功时, 会回调填写的URL
- 支持的变量

| 变量名 | 说明 |
| ---- | ---- |
| #{ipv4Addr} | 新的IPv4地址 |
| #{ipv4Result} | IPv4地址更新结果: 未改变 失败 成功|
| #{ipv4Domains} | IPv4的域名，多个以,分割 |
| #{ipv6Addr} | 新的IPv6地址 |
| #{ipv6Result} | IPv6地址更新结果: 未改变 失败 成功|
| #{ipv6Domains} | IPv6的域名，多个以,分割 |

- 如 RequestBody 为空则为 GET 请求，否则为 POST 请求
- <details><summary>Server酱</summary>

https://sctapi.ftqq.com/[SendKey].send?title=你的公网IP变了&desp=主人IPv4变了#{ipv4Addr},域名更新结果:#{ipv4Result}

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}"
                            }
                        ]
                    ]
                }
            }
        }
    }

ddns-telegram-bot
</details>
- <details><summary>plusplus 推送加</summary>

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

{
        "token": "your token",
        "title": "你的公网IP变了",
        "content": "你的公网IP变了 \n - IPv4地址：#{ipv4Addr} \n - 域名更新结果：#{ipv4Result} \n"
    }

- 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配置参考

Callback Copy Chapter

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

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

界面 Copy Chapter

!screenshots

开发&自行编译 Copy Chapter

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