██████╗ ██████╗ ██████╗ ███╗ ██╗███████╗
██╔════╝ ██╔═══██╗██╔══██╗████╗ ██║██╔════╝
██║ ███╗██║ ██║██║ ██║██╔██╗ ██║███████╗
██║ ██║██║ ██║██║ ██║██║╚██╗██║╚════██║
╚██████╔╝╚██████╔╝██████╔╝██║ ╚████║███████║
╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═══╝╚══════╝
GoDNS is a dynamic DNS (DDNS) client tool, it is based on my early open source project: DynDNS.
Now I rewrite DynDNS by Golang and call it GoDNS.
- Cloudflare (https://cloudflare.com)
- DNSPod (https://www.dnspod.cn/)
- HE.net (Hurricane Electric) (https://dns.he.net/)
- AliDNS (https://help.aliyun.com/product/29697.html)
- Linux
- MacOS
- ARM Linux (Raspberry Pi, etc...)
- Windows
- MIPS32 platform
To compile binaries for MIPS (mips or mipsle):
GOOS=linux GOARCH=mips/mipsle GOMIPS=softfloat go build -a
And the binary can run well on routers.
-
Register and own a domain.
-
Domain's nameserver points to DNSPod or HE.net or Cloudflare or AliDNS.
- Get source code from Github:
git clone https://github.com/timothyye/godns.git
- Go into the godns directory, get related library and then build it:
cd cmd/godns
go get -v
go build
Download compiled binaries from releases
$ ./godns -h
Usage of ./godns:
-c string
Specify a config file (default "./config.json")
-h Show help
- Get config_sample.json from Github.
- Rename it to config.json.
- Configure your provider, domain/subdomain info, username and password, etc.
- Configure the SMTP options if you want, a mail notification will sent to your mailbox once the IP is changed.
- Save it in the same directory of GoDNS, or use -c=your_conf_path command.
For Cloudflare, you need to provide email & Global API Key as password, and config all the domains & subdomains.
{
"provider": "Cloudflare",
"email": "[email protected]",
"password": "Global API Key",
"domains": [{
"domain_name": "example.com",
"sub_domains": ["www","test"]
},{
"domain_name": "example2.com",
"sub_domains": ["www","test"]
}
],
"ip_url": "https://ifconfig.co/ip",
"socks5_proxy": ""
}
For DNSPod, you need to provide email & password, and config all the domains & subdomains.
{
"provider": "DNSPod",
"password": "",
"login_token": "your_id,your_token",
"domains": [{
"domain_name": "example.com",
"sub_domains": ["www","test"]
},{
"domain_name": "example2.com",
"sub_domains": ["www","test"]
}
],
"ip_url": "http://members.3322.org/dyndns/getip",
"socks5_proxy": ""
}
For AliDNS, you need to provide AccessKeyID
& AccessKeySecret
as email
& password
, and config all the domains & subdomains.
{
"provider": "AliDNS",
"email": "AccessKeyID",
"password": "AccessKeySecret",
"login_token": "",
"domains": [{
"domain_name": "example.com",
"sub_domains": ["www","test"]
},{
"domain_name": "example2.com",
"sub_domains": ["www","test"]
}
],
"ip_url": "http://members.3322.org/dyndns/getip",
"socks5_proxy": ""
}
For HE, email is not needed, just fill DDNS key to password, and config all the domains & subdomains.
{
"provider": "HE",
"password": "YourPassword",
"login_token": "",
"domains": [{
"domain_name": "example.com",
"sub_domains": ["www","test"]
},{
"domain_name": "example2.com",
"sub_domains": ["www","test"]
}
],
"ip_url": "http://members.3322.org/dyndns/getip",
"socks5_proxy": ""
}
Add a new "A record", make sure that "Enable entry for dynamic dns" is checked:
Fill your own DDNS key or generate a random DDNS key for this new created "A record":
Remember the DDNS key and fill it as password to the config.json.
NOTICE: If you have multiple domains or subdomains, make sure their DDNS key are the same.
For some reasons if you want to get an IP directly from the interface, say eth0
for Linux or Local Area Connection
for Windows, update config file like this:
"ip_url": "",
"ip_interface": "eth0",
If you set both ip_url
and ip_interface
, it first tries to get an IP address online, and if not succeed, gets
an IP address from the interface as a fallback.
Note that IPv6 address will be ignored currently.
Update config file and provide your SMTP options, a notification mail will be sent to your mailbox once the IP is changed and updated.
"notify": {
"enabled": true,
"smtp_server": "smtp.example.com",
"smtp_username": "user",
"smtp_password": "password",
"smtp_port": 25,
"send_to": "[email protected]"
}
Notification mail example:
You can also use SOCKS5 proxy, just fill SOCKS5 address to the socks5_proxy
item:
"socks5_proxy": "127.0.0.1:7070"
Now all the queries will go through the specified SOCKS5 proxy.
nohup ./godns &
- Install
upstart
first - Copy
./upstart/godns.conf
to/etc/init
- Start it as a system service:
sudo start godns
- Modify
./systemd/godns.service
and config it. - Copy
./systemd/godns.service
to/lib/systemd/system
- Start it as a systemd service:
sudo systemctl enable godns
sudo systemctl start godns
Now godns supports to run in docker.
- Get config_sample.json from Github.
- Rename it to config.json.
- Run GoDNS with docker:
docker run -d --name godns --restart=always \
-v /path/to/config.json:/usr/local/godns/config.json timothyye/godns:latest
- Get birkett/srvany-ng from Github.
- Uncompress and place the executable
srvany-ng.exe
to the same directory wheregodns.exe
in. - Create a service and add registry keys according to the guide here.