{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/109", "result": {"data":{"issuesJson":{"id":"49c6a2f0-d662-575d-8ea2-c7e403dbe25b","title":"jeessy2/ddns-go: 自动获得你的公网IP地址，并解析到对应的域名服务，支持阿里云, 腾讯云, DNSpod, Cloudflare, 华为云, Callback, 百度云, Porkbun, GoDaddy, Google, Domain, Namecheap, NameSilo","number":109,"bodyHTML":"

\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Repos	jeessy2/ddns-go
Views	$\"views\"$
Stars	$\"stars\"$
Forks	$\"forks\"$
License	$\"license\"$
UpdatedAt	$\"last-commit\"$
CreatedAt	$\"create-at\"$

\n\n

\n

\n

\n

DDNS-GO

\n

$\"GitHub$ $\"GitHub$ $\"Go$ $\"\"$ $\"\"$ $\"\"$

\n

中文 | English

\n

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

\n

\n

特性

\n

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

\n

Note

建议在启用公网访问时，使用 Nginx 等反向代理软件启用 HTTPS 访问，以保证安全性。FAQ

\n

\n

系统中使用

\n

从 Releases 下载并解压 ddns-go
安装服务\n
- Mac/Linux: sudo ./ddns-go -s install
- Win(以管理员打开cmd): .\\ddns-go.exe -s install
\n
配置\n
- 打开浏览器并访问http://localhost:9876进行初始化配置
\n
[可选] 服务卸载\n
- Mac/Linux: sudo ./ddns-go -s uninstall
- Win(以管理员打开cmd): .\\ddns-go.exe -s uninstall
\n
[可选] 支持安装带参数\n
- -l 监听地址
- -f 同步间隔时间(秒)
- -cacheTimes 间隔N次与服务商比对
- -c 自定义配置文件路径
- -noweb 不启动web服务
- -skipVerify 跳过证书验证
- -dns 自定义 DNS 服务器
- -resetPassword 重置密码
\n
[可选] 参考示例\n
- 10分钟同步一次, 并指定了配置文件地址\n
```
./ddns-go -s install -f 600 -c /Users/name/.ddns_go_config.yaml
```
  \n
- 每 10 秒检查一次本地 IP 变化, 每 30 分钟对比一下 IP 变化, 实现 IP 变化即时触发更新且不会被服务商限流, 如果使用接口获取IP, 需要注意接口限流\n
```
./ddns-go -s install -f 10 -cacheTimes 180
```
  \n
- 重置密码\n
```
./ddns-go -resetPassword 123456\n./ddns-go -resetPassword 123456 -c /Users/name/.ddns_go_config.yaml
```
  \n
\n

\n

Docker中使用

\n

\n
挂载主机目录, 使用docker host模式。可把 /opt/ddns-go 替换为你主机任意目录, 配置文件为隐藏文件
\n
```
docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root jeessy/ddns-go
```
\n
\n
打开浏览器并访问http://Docker主机IP:9876进行初始化配置
\n

\n

[可选] 使用 ghcr.io 镜像

\n

docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root ghcr.io/jeessy2/ddns-go

\n

\n

[可选] 支持启动带参数 -l监听地址 -f间隔时间(秒)

\n

docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root jeessy/ddns-go -l :9877 -f 600

\n

\n

[可选] 不使用docker host模式

\n

docker run -d --name ddns-go --restart=always -p 9876:9876 -v /opt/ddns-go:/root jeessy/ddns-go

\n

\n

[可选] 重置密码

\n

docker exec ddns-go ./ddns-go -resetPassword 123456\ndocker restart ddns-go

\n

\n

使用IPv6

\n

前提：你的电脑或终端能正常获取IPv6，并能正常访问IPv6
Windows/Mac：推荐系统中使用，Windows/Mac桌面版的docker不支持--net=host
群晖：\n
- 套件中心下载docker并打开
- 注册表中搜索ddns-go并下载
- 映像 -> 选择jeessy/ddns-go -> 启动 -> 高级设置 -> 网络中勾选使用与 Docker Host 相同的网络，高级设置中勾选启动自动重新启动
- 在浏览器中打开http://群晖IP:9876，修改你的配置，成功
\n
Linux的x86或arm架构，推荐使用Docker的--net=host模式。参考 Docker中使用
虚拟机中使用有可能正常获取IPv6，但不能正常访问IPv6

\n

Webhook

\n

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

\n

支持的变量

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

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

\n

\n
如 RequestBody 为空则为 GET 请求，否则为 POST 请求
\n

\n

Server酱

\n

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

\n

\n

Bark

\n

https://api.day.app/[YOUR_KEY]/主人IPv4变了#{ipv4Addr},域名更新结果:#{ipv4Result}\n

\n

\n

\n
钉钉
\n
- 钉钉电脑端 -> 群设置 -> 智能群助手 -> 添加机器人 -> 自定义
- 只勾选 自定义关键词, 输入的关键字必须包含在RequestBody的content中, 如：你的公网IP变了
- URL中输入钉钉给你的 Webhook地址
- RequestBody中输入\n
```
{\n    \"msgtype\": \"markdown\",\n    \"markdown\": {\n        \"title\": \"你的公网IP变了\",\n        \"text\": \"#### 你的公网IP变了 \\n - IPv4地址：#{ipv4Addr} \\n - 域名更新结果：#{ipv4Result} \\n\"\n    }\n}
```
  \n
\n
\n

\n

飞书

\n

飞书电脑端 -> 群设置 -> 添加机器人 -> 自定义机器人
安全设置只勾选 自定义关键词, 输入的关键字必须包含在RequestBody的content中, 如：你的公网IP变了
URL中输入飞书给你的 Webhook地址

RequestBody中输入\n

{\n    \"msg_type\": \"post\",\n    \"content\": {\n        \"post\": {\n            \"zh_cn\": {\n                \"title\": \"你的公网IP变了\",\n                \"content\": [\n                    [\n                        {\n                            \"tag\": \"text\",\n                            \"text\": \"IPv4地址：#{ipv4Addr}\"\n                        }\n                    ],\n                    [\n                        {\n                            \"tag\": \"text\",\n                            \"text\": \"域名更新结果：#{ipv4Result}\"\n                        }\n                    ]\n                ]\n            }\n        }\n    }\n}

\n

\n

\n

\n
Telegram
\n
ddns-telegram-bot
\n
\n

\n

plusplus 推送加

\n

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

RequestBody中输入\n

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

\n

\n

\n

\n

Discord

\n

Discord任意客户端 -> 伺服器 -> 频道设置 -> 整合 -> 查看Webhook -> 新Webhook -> 复制Webhook网址
URL中输入Discord复制的 Webhook网址

RequestBody中输入\n

{\n    \"content\": \"域名 #{ipv4Domains} 动态解析 #{ipv4Result}.\",\n    \"embeds\": [\n        {\n            \"description\": \"#{ipv4Domains} 的动态解析 #{ipv4Result}, IP: #{ipv4Addr}\",\n            \"color\": 15258703,\n            \"author\": {\n                \"name\": \"DDNS\"\n            },\n            \"footer\": {\n                \"text\": \"DDNS #{ipv4Result}\"\n            }\n        }\n    ]\n}

\n

\n

\n

\n
查看更多Webhook配置参考
\n

\n

Callback

\n

\n
通过自定义回调可支持更多的第三方DNS服务商
\n
\n
配置的域名有几行, 就会回调几次
\n
\n
支持的变量
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
变量名说明
#{ip} 新的IPv4/IPv6地址
#{domain} 当前域名
#{recordType} 记录类型 A或AAAA
#{ttl} TTL
\n
\n
如 RequestBody 为空则为 GET 请求，否则为 POST 请求
\n
\n
Callback配置参考
\n

\n

界面

\n

$\"screenshots\"$

\n

开发&自行编译

\n

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

","updatedAt":"2025-05-21T15:54:00Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"jeessy2","color":"2C862A"}},{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"DNS","color":"d6c39d"}}]},"comments":{"edges":[]}}},"pageContext":{"number":109,"previous":{"title":"86dbs/dbsyncer: 一款开源的数据同步中间件，提供 MySQL、Oracle、SqlServer、PostgreSQL、Elasticsearch (ES)、Kafka、File、SQL 等同步场景。支持上传插件自定义同步转换业务，提供监控全量和增量数据统计图、应用性能预警等。","number":108},"next":{"title":"deepflowio/deepflow: DeepFlow 开源项目旨在为复杂的云基础设施及云原生应用提供深度可观测性。","number":110}}}, "staticQueryHashes": ["151096407","2861350382"]}