You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[GoDNS](https://github.com/TimothyYe/godns) is a dynamic DNS (DDNS) client tool. It is a rewrite in [Go](https://golang.org) of my early [DynDNS](https://github.com/TimothyYe/DynDNS) opensource project.
21
+
[GoDNS](https://github.com/TimothyYe/godns) is a dynamic DNS (DDNS) client tool. It is a rewrite in [Go](https://golang.org) of my early [DynDNS](https://github.com/TimothyYe/DynDNS) open-source project.
-[Supported DNS Providers](#supported-dns-providers)
@@ -210,14 +211,14 @@ GoDNS supports dynamic loading of configuration. If you modify the configuration
210
211
-`email` — Email or account name of the DNS provider.
211
212
-`password` — Password of the DNS provider.
212
213
-`login_token` — API token of the DNS provider.
213
-
-`domains` — Domains list, with your sub domains.
214
+
-`domains` — Domains list, with your subdomains.
214
215
-`ip_urls` — A URL array for fetching one's public IPv4 address.
215
216
-`ipv6_urls` — A URL array for fetching one's public IPv6 address.
216
217
-`ip_type` — Switch deciding if IPv4 or IPv6 should be used (when [supported](#supported-dns-providers)). Available values: `IPv4` or `IPv6`.
217
218
-`interval` — How often (in seconds) the public IP should be updated.
218
219
-`socks5_proxy` — Socks5 proxy server.
219
220
-`resolver` — Address of a public DNS server to use. For instance to use [Google's public DNS](https://developers.google.com/speed/public-dns/docs/using), you can set `8.8.8.8` when using GoDNS in IPv4 mode or `2001:4860:4860::8888` in IPv6 mode.
220
-
-`skip_ssl_verify` - Skip verification of ssl certificates for https requests.
221
+
-`skip_ssl_verify` - Skip verification of SSL certificates for https requests.
221
222
222
223
### Update root domain
223
224
@@ -234,9 +235,9 @@ By simply putting `@` into `sub_domains`, for example:
234
235
235
236
#### Cloudflare
236
237
237
-
For Cloudflare, you need to provide the email & Global API Key as password (or to use the API token) and config all the domains & subdomains.
238
+
For Cloudflare, you need to provide the email & Global API Key as a password (or to use the API token) and configure all the domains & subdomains.
238
239
239
-
By setting the option `proxied = true`, the record is receiving the performance and security benefits of Cloudflare. This option is only available for Cloudflare.
240
+
By setting the option `proxied = true`, the record receives the performance and security benefits of Cloudflare. This option is only available for Cloudflare.
240
241
241
242
<details>
242
243
<summary>Using email & Global API Key</summary>
@@ -327,7 +328,7 @@ For DNSPod, you need to provide your API Token(you can create it [here](https://
327
328
328
329
#### DigitalOcean
329
330
330
-
For DigitalOcean, you need to provide a API Token with the `domain` scopes (you can create it [here](https://cloud.digitalocean.com/account/api/tokens/new)), and config all the domains & subdomains.
331
+
For DigitalOcean, you need to provide an API Token with the `domain` scopes (you can create it [here](https://cloud.digitalocean.com/account/api/tokens/new)), and config all the domains & subdomains.
331
332
332
333
<details>
333
334
<summary>Example</summary>
@@ -533,7 +534,7 @@ For DuckDNS, the only thing needed is to provide the `token`, config 1 default d
533
534
534
535
#### HE.net
535
536
536
-
For HE, email is not needed, just fill the DDNS key as password, and config all the domains & subdomains.
537
+
For HE, email is not needed, just fill in the DDNS key as a password, and configure all the domains & subdomains.
537
538
538
539
<details>
539
540
<summary>Example</summary>
@@ -570,7 +571,7 @@ Add a new "A record" and make sure that "Enable entry for dynamic dns" is checke
570
571
571
572
<imgsrc="assets/snapshots/he1.png"width="640" />
572
573
573
-
Fill in your own DDNS key or generate a random DDNS key for this new created "A record":
574
+
Fill in your own DDNS key or generate a random DDNS key for this newly created "A record":
574
575
575
576
<imgsrc="assets/snapshots/he2.png"width="640" />
576
577
@@ -612,7 +613,7 @@ For Scaleway, you need to provide an API Secret Key as the `login_token` ([How t
612
613
613
614
To authenticate with the Linode API you will need to provide a Personal Access Token with "Read/Write" access on the "Domain" scope. Linode has [a help page about creating access tokens](https://www.linode.com/docs/guides/getting-started-with-the-linode-api/). Pass this token into the `login_token` field of the config file.
614
615
615
-
The `domain_name` field of the config file must be the name of an existing Domain managed by Linode. Linode has [a help page about adding domains](https://www.linode.com/docs/guides/dns-manager/). The GoDNS Linode handler will not create domains automatically, but will create subdomains automatically.
616
+
The `domain_name` field of the config file must be the name of an existing Domain managed by Linode. Linode has [a help page about adding domains](https://www.linode.com/docs/guides/dns-manager/). The GoDNS Linode handler will not create domains automatically but will create subdomains automatically.
616
617
617
618
The GoDNS Linode handler currently uses a fixed TTL of 30 seconds for Linode DNS records.
618
619
@@ -642,7 +643,7 @@ The GoDNS Linode handler currently uses a fixed TTL of 30 seconds for Linode DNS
642
643
643
644
#### Strato
644
645
645
-
For Strato, you need to provide email & password, and config all the domains & subdomains.
646
+
For Strato, you need to provide email & password and configure all the domains & subdomains.
646
647
More Info: [German](https://www.strato.de/faq/hosting/so-einfach-richten-sie-dyndns-fuer-ihre-domains-ein/)[English](https://www.strato-hosting.co.uk/faq/hosting/this-is-how-easy-it-is-to-set-up-dyndns-for-your-domains/)
647
648
648
649
<details>
@@ -674,7 +675,7 @@ More Info: [German](https://www.strato.de/faq/hosting/so-einfach-richten-sie-dyn
674
675
675
676
#### LoopiaSE
676
677
677
-
For LoopiaSE, you need to provide username & password, and config all the domains & subdomains.
678
+
For LoopiaSE, you need to provide a username & password and configure all the domains & subdomains.
678
679
More info: [Swedish](https://support.loopia.se/wiki/om-dyndns-stodet/)
679
680
680
681
<details>
@@ -707,7 +708,7 @@ More info: [Swedish](https://support.loopia.se/wiki/om-dyndns-stodet/)
707
708
708
709
#### Infomaniak
709
710
710
-
For Infomaniak, you need to provide username & password, and config all the domains & subdomains.
711
+
For Infomaniak, you need to provide a username & password and configure all the domains & subdomains.
711
712
More info: [English](https://faq.infomaniak.com/2376)
712
713
713
714
<details>
@@ -772,7 +773,7 @@ Make sure there is just one record.
772
773
773
774
#### OVH
774
775
775
-
For OVH, you need to provide a Consumerkey, an Appsecret, an Appkey and configure all the domains & subdomains.
776
+
For OVH, you need to provide a Consumerkey, an Appsecret, and an Appkey and configure all the domains & subdomains.
776
777
The needed values can be obtained by visiting [this site](https://www.ovh.com/auth/api/createToken)
777
778
Rights should be '\*' on GET, POST and PUT
778
779
More info: [help.ovhcloud.com](https://help.ovhcloud.com/csm/en-gb-api-getting-started-ovhcloud-api?id=kb_article_view&sysparm_article=KB0042784)
@@ -885,7 +886,7 @@ Emails are sent over [SMTP](https://en.wikipedia.org/wiki/Simple_Mail_Transfer_P
885
886
}
886
887
```
887
888
888
-
Each time the IP changes, you will receive an email like that:
889
+
Each time the IP changes, you will receive an email like this:
@@ -905,7 +906,7 @@ To receive a [Telegram](https://telegram.org/) message each time the IP changes,
905
906
}
906
907
```
907
908
908
-
The `message_template` property supports [markdown](https://www.markdownguide.org). New lines needs to be escaped with `%0A`.
909
+
The `message_template` property supports [markdown](https://www.markdownguide.org). New lines need to be escaped with `%0A`.
909
910
910
911
#### Slack
911
912
@@ -965,12 +966,12 @@ can be found on the Pushover [API description](https://pushover.net/api#priority
965
966
966
967
### Webhook
967
968
968
-
Webhook is another feature that GoDNS provides to deliver notifications to the other applications while the IP is changed. GoDNS delivers a notification to the target URL via an HTTP `GET` or `POST` request.
969
+
Webhook is another feature that GoDNS provides to deliver notifications to other applications while the IP is changed. GoDNS delivers a notification to the target URL via an HTTP `GET` or `POST` request.
969
970
970
971
The configuration section `webhook` is used for customizing the webhook request. In general, there are 2 fields used for the webhook request:
971
972
972
-
> -`url`: The target URL for sending webhook request.
973
-
> -`request_body`: The content for sending `POST` request, if this field is empty, a HTTP GET request will be sent instead of the HTTP POST request.
973
+
> -`url`: The target URL for sending webhook requests.
974
+
> -`request_body`: The content for sending a `POST` request, if this field is empty, an HTTP GET request will be sent instead of the HTTP POST request.
For this example, a webhook will be triggered when the IP changes, the target URL `http://localhost:5000/api/v1/send` will receive an `HTTP POST` request with request body:
1008
+
For this example, a webhook will be triggered when the IP changes, and the target URL `http://localhost:5000/api/v1/send` will receive an `HTTP POST` request with the request body:
@@ -1052,7 +1053,7 @@ To enable the `IPv6` support of GoDNS, there are two solutions to choose from:
1052
1053
1053
1054
#### Network interface IP address
1054
1055
1055
-
For some reasons if you want to get the IP address associated to a network interface (instead of performing an online lookup), you can specify it in the configuration file this way:
1056
+
For some reasons, if you want to get the IP address associated with a network interface (instead of performing an online lookup), you can specify it in the configuration file this way:
1056
1057
1057
1058
```json
1058
1059
"ip_urls": [""],
@@ -1096,7 +1097,7 @@ To display debug info, set `debug_info` as `true` to enable this feature. By def
1096
1097
1097
1098
#### Multiple API URLs
1098
1099
1099
-
GoDNS supports to fetch the public IP from multiple URLs via a simple round-robin algorithm. If the first URL fails, it will try the next one until it succeeds. Here is an example of the configuration:
1100
+
GoDNS supports fetching the public IP from multiple URLs via a simple round-robin algorithm. If the first URL fails, it will try the next one until it succeeds. Here is an example of the configuration:
1100
1101
1101
1102
```json
1102
1103
"ip_urls": [
@@ -1137,7 +1138,7 @@ There are a few ways to run GoDNS.
1137
1138
1138
1139
Note: make sure to set the `run_once` parameter in your config file so the program will quit after the first run (the default is `false`).
1139
1140
1140
-
Can be added to `cron` or attached to other events on your system.
1141
+
It can be added to `cron` or attached to other events on your system.
1141
1142
1142
1143
```json
1143
1144
{
@@ -1199,7 +1200,7 @@ Available docker registries:
0 commit comments