ddns-go README

The project's README from github.com/jeessy2/ddns-go. As one markdown file: README.md.

DDNS-GO

GitHub release GitHub release downloads Go version

中文 | English

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

特性

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

系统中使用

Docker中使用

使用IPv6

Webhook

Callback

界面

screenshots

开发&自行编译

ddns-go (jeessy2/ddns-go)

Searching Database…

17.4K ·GitHub
What is this?DDNS-GO is a dynamic DNS tool: it watches your public IPv4 or IPv6 address and automatically updates your DNS records whenever it changes, so your domain always points to your current IP.
Is it a hosted service or something I run myself?You run it yourself: a single Go binary that installs as a background service on your machine or NAS and serves a small local web page where all the configuration happens.
How do I get it running?Download the binary from GitHub Releases and install it as a service: 'sudo ./ddns-go -s install' on Mac/Linux, 'ddns-go.exe -s install' as admin on Windows. Then configure it in the browser — nothing else to install first.
Does IPv6 need anything special?Your machine has to actually obtain IPv6 and reach the IPv6 network. VMs sometimes get an address without real access, and on Windows/Mac prefer the native install since Docker Desktop lacks --net=host mode.
What systems does it run on?macOS, Windows and Linux, on ARM, x86 and RISC-V architectures — so desktops, servers, ARM boards and NAS devices all work.
How often does it check for IP changes?Every 5 minutes by default. The interval is configurable, and a cache option makes it compare with the DNS provider only every N cycles — so it can watch the local IP frequently without hitting provider rate limits.
How does it detect my public IP?Three ways: read it from the network interface, query an IP API, or run a command you specify.
Can I control the TTL of the DNS records?Yes, TTL is supported. Some providers also accept custom parameters, enabling things like regional resolution or multi-IP setups.
Can I see what the tool is actually doing?The web page shows the last 50 log entries, so you can quickly check recent updates and spot failures.
Creator
jeessy2
Size
24.6 MB
Stars
17.4K
Age
6y
Commits · 90 Days