{"id":13455186,"url":"https://github.com/jeessy2/ddns-go","last_synced_at":"2025-05-12T03:47:25.391Z","repository":{"id":37301921,"uuid":"290437899","full_name":"jeessy2/ddns-go","owner":"jeessy2","description":"Simple and easy to use DDNS. Support Aliyun, Tencent Cloud, Dnspod, Cloudflare, Callback, Huawei Cloud, Baidu Cloud, Porkbun, GoDaddy, Namecheap, NameSilo...","archived":false,"fork":false,"pushed_at":"2025-04-22T02:01:46.000Z","size":24970,"stargazers_count":14041,"open_issues_count":32,"forks_count":1596,"subscribers_count":59,"default_branch":"master","last_synced_at":"2025-05-01T10:12:07.026Z","etag":null,"topics":["alidns","baiduyun","cloudflare","ddns","ddns-go","dnspod","godaddy-ddns","google-domains","porkbun"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeessy2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-08-26T08:17:51.000Z","updated_at":"2025-05-01T07:03:24.000Z","dependencies_parsed_at":"2022-07-09T19:16:23.152Z","dependency_job_id":"fbb7d745-b53d-41ab-becc-e705a3c50876","html_url":"https://github.com/jeessy2/ddns-go","commit_stats":{"total_commits":436,"total_committers":43,"mean_commits":10.13953488372093,"dds":0.3646788990825688,"last_synced_commit":"ca3027b1117aca95fef5e3f1ade4982598d254f3"},"previous_names":[],"tags_count":172,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeessy2%2Fddns-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeessy2%2Fddns-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeessy2%2Fddns-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeessy2%2Fddns-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeessy2","download_url":"https://codeload.github.com/jeessy2/ddns-go/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251857022,"owners_count":21655121,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alidns","baiduyun","cloudflare","ddns","ddns-go","dnspod","godaddy-ddns","google-domains","porkbun"],"created_at":"2024-07-31T08:01:02.206Z","updated_at":"2025-05-12T03:47:25.361Z","avatar_url":"https://github.com/jeessy2.png","language":"Go","funding_links":[],"categories":["Go","HarmonyOS","网络服务","DNS","DDNS"],"sub_categories":["Windows Manager","网络服务_其他"],"readme":"# ddns-go\n\n[![GitHub release](https://img.shields.io/github/release/jeessy2/ddns-go.svg?logo=github\u0026style=flat-square) ![GitHub release downloads](https://img.shields.io/github/downloads/jeessy2/ddns-go/total?logo=github)](https://github.com/jeessy2/ddns-go/releases/latest) [![Go version](https://img.shields.io/github/go-mod/go-version/jeessy2/ddns-go)](https://github.com/jeessy2/ddns-go/blob/master/go.mod) [![](https://goreportcard.com/badge/github.com/jeessy2/ddns-go/v6)](https://goreportcard.com/report/github.com/jeessy2/ddns-go/v6) [![](https://img.shields.io/docker/image-size/jeessy/ddns-go)](https://registry.hub.docker.com/r/jeessy/ddns-go) [![](https://img.shields.io/docker/pulls/jeessy/ddns-go)](https://registry.hub.docker.com/r/jeessy/ddns-go)\n\n中文 | [English](https://github.com/jeessy2/ddns-go/blob/master/README_EN.md)\n\n自动获得你的公网 IPv4 或 IPv6 地址，并解析到对应的域名服务。\n\n- [特性](#特性)\n- [系统中使用](#系统中使用)\n- [Docker中使用](#docker中使用)\n- [使用IPv6](#使用ipv6)\n- [Webhook](#webhook)\n- [Callback](#callback)\n- [界面](#界面)\n- [开发\u0026自行编译](#开发自行编译)\n\n## 特性\n\n- 支持Mac、Windows、Linux系统，支持ARM、x86架构\n- 支持的域名服务商 `阿里云` `腾讯云` `Dnspod` `Cloudflare` `华为云` `Callback` `百度云` `Porkbun` `GoDaddy` `Namecheap` `NameSilo` `Dynadot`\n- 支持接口/网卡/[命令](https://github.com/jeessy2/ddns-go/wiki/通过命令获取IP参考)获取IP\n- 支持以服务的方式运行\n- 默认间隔5分钟同步一次\n- 支持同时配置多个DNS服务商\n- 支持多个域名同时解析\n- 支持多级域名\n- 网页中配置，简单又方便，默认勾选`禁止从公网访问`\n- 网页中方便快速查看最近50条日志\n- 支持Webhook通知\n- 支持TTL\n- 支持部分DNS服务商[传递自定义参数](https://github.com/jeessy2/ddns-go/wiki/传递自定义参数)，实现地域解析/多IP等功能\n\n\u003e [!NOTE]\n\u003e 建议在启用公网访问时，使用 Nginx 等反向代理软件启用 HTTPS 访问，以保证安全性。[FAQ](https://github.com/jeessy2/ddns-go/wiki/FAQ)\n\n## 系统中使用\n\n- 从 [Releases](https://github.com/jeessy2/ddns-go/releases) 下载并解压 ddns-go\n- 安装服务\n  - Mac/Linux: `sudo ./ddns-go -s install`\n  - Win(以管理员打开cmd): `.\\ddns-go.exe -s install`\n- 配置\n  - 打开浏览器并访问`http://localhost:9876`进行初始化配置\n- [可选] 服务卸载\n  - Mac/Linux: `sudo ./ddns-go -s uninstall`\n  - Win(以管理员打开cmd): `.\\ddns-go.exe -s uninstall`\n- [可选] 支持安装带参数\n  - `-l` 监听地址\n  - `-f` 同步间隔时间(秒)\n  - `-cacheTimes` 间隔N次与服务商比对\n  - `-c` 自定义配置文件路径\n  - `-noweb` 不启动web服务\n  - `-skipVerify` 跳过证书验证\n  - `-dns` 自定义 DNS 服务器\n  - `-resetPassword` 重置密码\n- [可选] 参考示例\n  - 10分钟同步一次, 并指定了配置文件地址\n    ```bash\n    ./ddns-go -s install -f 600 -c /Users/name/.ddns_go_config.yaml\n    ```\n  - 每 10 秒检查一次本地 IP 变化, 每 30 分钟对比一下 IP 变化, 实现 IP 变化即时触发更新且不会被服务商限流, 如果使用接口获取IP, 需要注意接口限流\n    ```bash\n    ./ddns-go -s install -f 10 -cacheTimes 180\n    ```\n  - 重置密码\n    ```bash\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\n  ```bash\n  docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root jeessy/ddns-go\n  ```\n\n- 打开浏览器并访问`http://Docker主机IP:9876`进行初始化配置\n\n- [可选] 使用 `ghcr.io` 镜像\n\n  ```bash\n  docker run -d --name ddns-go --restart=always --net=host -v /opt/ddns-go:/root ghcr.io/jeessy2/ddns-go\n  ```\n\n- [可选] 支持启动带参数 `-l`监听地址 `-f`间隔时间(秒)\n\n  ```bash\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\n- [可选] 不使用docker host模式\n\n  ```bash\n  docker run -d --name ddns-go --restart=always -p 9876:9876 -v /opt/ddns-go:/root jeessy/ddns-go\n  ```\n\n- [可选] 重置密码\n\n  ```bash\n  docker exec ddns-go ./ddns-go -resetPassword 123456\n  docker restart ddns-go\n  ```\n\n## 使用IPv6\n\n- 前提：你的电脑或终端能正常获取IPv6，并能正常访问IPv6\n- Windows/Mac：推荐 [系统中使用](#系统中使用)，Windows/Mac桌面版的docker不支持`--net=host`\n- 群晖：\n  - 套件中心下载docker并打开\n  - 注册表中搜索`ddns-go`并下载\n  - 映像 -\u003e 选择`jeessy/ddns-go` -\u003e 启动 -\u003e 高级设置 -\u003e 网络中勾选`使用与 Docker Host 相同的网络`，高级设置中勾选`启动自动重新启动`\n  - 在浏览器中打开`http://群晖IP:9876`，修改你的配置，成功\n- Linux的x86或arm架构，推荐使用Docker的`--net=host`模式。参考 [Docker中使用](#Docker中使用)\n- 虚拟机中使用有可能正常获取IPv6，但不能正常访问IPv6\n\n## Webhook\n\n- 支持webhook, 域名更新成功或不成功时, 会回调填写的URL\n- 支持的变量\n\n  |  变量名   | 说明  |\n  |  ----  | ----  |\n  | #{ipv4Addr}  | 新的IPv4地址 |\n  | #{ipv4Result}  | IPv4地址更新结果: `未改变` `失败` `成功`|\n  | #{ipv4Domains}  | IPv4的域名，多个以`,`分割 |\n  | #{ipv6Addr}  | 新的IPv6地址 |\n  | #{ipv6Result}  | IPv6地址更新结果: `未改变` `失败` `成功`|\n  | #{ipv6Domains}  | IPv6的域名，多个以`,`分割 |\n\n- 如 RequestBody 为空则为 GET 请求，否则为 POST 请求\n- \u003cdetails\u003e\u003csummary\u003eServer酱\u003c/summary\u003e\n\n  ```\n  https://sctapi.ftqq.com/[SendKey].send?title=你的公网IP变了\u0026desp=主人IPv4变了#{ipv4Addr},域名更新结果:#{ipv4Result}\n  ```\n- \u003cdetails\u003e\u003csummary\u003eBark\u003c/summary\u003e\n\n  ```\n  https://api.day.app/[YOUR_KEY]/主人IPv4变了#{ipv4Addr},域名更新结果:#{ipv4Result}\n  ```\n  \u003c/details\u003e\n- \u003cdetails\u003e\u003csummary\u003e钉钉\u003c/summary\u003e\n\n  - 钉钉电脑端 -\u003e 群设置 -\u003e 智能群助手 -\u003e 添加机器人 -\u003e 自定义\n  - 只勾选 `自定义关键词`, 输入的关键字必须包含在RequestBody的content中, 如：`你的公网IP变了`\n  - URL中输入钉钉给你的 `Webhook地址`\n  - RequestBody中输入\n    ```json\n    {\n        \"msgtype\": \"markdown\",\n        \"markdown\": {\n            \"title\": \"你的公网IP变了\",\n            \"text\": \"#### 你的公网IP变了 \\n - IPv4地址：#{ipv4Addr} \\n - 域名更新结果：#{ipv4Result} \\n\"\n        }\n    }\n    ```\n  \u003c/details\u003e\n- \u003cdetails\u003e\u003csummary\u003e飞书\u003c/summary\u003e\n\n  - 飞书电脑端 -\u003e 群设置 -\u003e 添加机器人 -\u003e 自定义机器人\n  - 安全设置只勾选 `自定义关键词`, 输入的关键字必须包含在RequestBody的content中, 如：`你的公网IP变了`\n  - URL中输入飞书给你的 `Webhook地址`\n  - RequestBody中输入\n    ```json\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  \u003c/details\u003e\n- \u003cdetails\u003e\u003csummary\u003eTelegram\u003c/summary\u003e\n\n  [ddns-telegram-bot](https://github.com/WingLim/ddns-telegram-bot)\n  \u003c/details\u003e\n- \u003cdetails\u003e\u003csummary\u003eplusplus 推送加\u003c/summary\u003e\n\n  - [获取token](https://www.pushplus.plus/push1.html)\n  - URL中输入 `https://www.pushplus.plus/send`\n  - RequestBody中输入\n    ```json\n    {\n        \"token\": \"your token\",\n        \"title\": \"你的公网IP变了\",\n        \"content\": \"你的公网IP变了 \\n - IPv4地址：#{ipv4Addr} \\n - 域名更新结果：#{ipv4Result} \\n\"\n    }\n    ```\n  \u003c/details\u003e\n- \u003cdetails\u003e\u003csummary\u003eDiscord\u003c/summary\u003e\n\n  - Discord任意客户端 -\u003e 伺服器 -\u003e 频道设置 -\u003e 整合 -\u003e 查看Webhook -\u003e 新Webhook -\u003e 复制Webhook网址\n  - URL中输入Discord复制的 `Webhook网址`\n  - RequestBody中输入\n    ```json\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  \u003c/details\u003e\n\n- [查看更多Webhook配置参考](https://github.com/jeessy2/ddns-go/issues/327)\n\n## Callback\n\n- 通过自定义回调可支持更多的第三方DNS服务商\n- 配置的域名有几行, 就会回调几次\n- 支持的变量\n\n  |  变量名   | 说明  |\n  |  ----  | ----  |\n  | #{ip}  | 新的IPv4/IPv6地址 |\n  | #{domain}  | 当前域名 |\n  | #{recordType}  | 记录类型 `A`或`AAAA` |\n  | #{ttl}  | TTL |\n- 如 RequestBody 为空则为 GET 请求，否则为 POST 请求\n- [Callback配置参考](https://github.com/jeessy2/ddns-go/wiki/Callback配置参考)\n\n## 界面\n\n![screenshots](https://raw.githubusercontent.com/jeessy2/ddns-go/master/ddns-web.png)\n\n## 开发\u0026自行编译\n\n- 如果喜欢从源代码编译自己的版本，可以使用本项目提供的 Makefile 构建\n- 使用 `make build` 生成本地编译后的 `ddns-go` 可执行文件\n- 使用 `make build_docker_image` 自行编译 Docker 镜像\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeessy2%2Fddns-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeessy2%2Fddns-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeessy2%2Fddns-go/lists"}