Skip to content

Commit fd531a1

Browse files
authored
Update README.md
1 parent 22e6799 commit fd531a1

File tree

1 file changed

+24
-23
lines changed

1 file changed

+24
-23
lines changed

README.md

Lines changed: 24 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,9 @@
1818
[13]: https://godoc.org/github.com/TimothyYe/godns?status.svg
1919
[14]: https://godoc.org/github.com/TimothyYe/godns
2020

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.
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.
2222

23+
<img src="https://github.com/TimothyYe/godns/blob/master/assets/snapshots/web-panel.jpg?raw=true" />
2324
---
2425

2526
- [Supported DNS Providers](#supported-dns-providers)
@@ -210,14 +211,14 @@ GoDNS supports dynamic loading of configuration. If you modify the configuration
210211
- `email` — Email or account name of the DNS provider.
211212
- `password` — Password of the DNS provider.
212213
- `login_token` — API token of the DNS provider.
213-
- `domains` — Domains list, with your sub domains.
214+
- `domains` — Domains list, with your subdomains.
214215
- `ip_urls` — A URL array for fetching one's public IPv4 address.
215216
- `ipv6_urls` — A URL array for fetching one's public IPv6 address.
216217
- `ip_type` — Switch deciding if IPv4 or IPv6 should be used (when [supported](#supported-dns-providers)). Available values: `IPv4` or `IPv6`.
217218
- `interval` — How often (in seconds) the public IP should be updated.
218219
- `socks5_proxy` — Socks5 proxy server.
219220
- `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.
221222

222223
### Update root domain
223224

@@ -234,9 +235,9 @@ By simply putting `@` into `sub_domains`, for example:
234235

235236
#### Cloudflare
236237

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.
238239

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.
240241

241242
<details>
242243
<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://
327328

328329
#### DigitalOcean
329330

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.
331332

332333
<details>
333334
<summary>Example</summary>
@@ -533,7 +534,7 @@ For DuckDNS, the only thing needed is to provide the `token`, config 1 default d
533534

534535
#### HE.net
535536

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.
537538

538539
<details>
539540
<summary>Example</summary>
@@ -570,7 +571,7 @@ Add a new "A record" and make sure that "Enable entry for dynamic dns" is checke
570571

571572
<img src="assets/snapshots/he1.png" width="640" />
572573

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":
574575

575576
<img src="assets/snapshots/he2.png" width="640" />
576577

@@ -612,7 +613,7 @@ For Scaleway, you need to provide an API Secret Key as the `login_token` ([How t
612613

613614
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.
614615

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.
616617

617618
The GoDNS Linode handler currently uses a fixed TTL of 30 seconds for Linode DNS records.
618619

@@ -642,7 +643,7 @@ The GoDNS Linode handler currently uses a fixed TTL of 30 seconds for Linode DNS
642643

643644
#### Strato
644645

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.
646647
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/)
647648

648649
<details>
@@ -674,7 +675,7 @@ More Info: [German](https://www.strato.de/faq/hosting/so-einfach-richten-sie-dyn
674675

675676
#### LoopiaSE
676677

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.
678679
More info: [Swedish](https://support.loopia.se/wiki/om-dyndns-stodet/)
679680

680681
<details>
@@ -707,7 +708,7 @@ More info: [Swedish](https://support.loopia.se/wiki/om-dyndns-stodet/)
707708

708709
#### Infomaniak
709710

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.
711712
More info: [English](https://faq.infomaniak.com/2376)
712713

713714
<details>
@@ -772,7 +773,7 @@ Make sure there is just one record.
772773

773774
#### OVH
774775

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.
776777
The needed values can be obtained by visiting [this site](https://www.ovh.com/auth/api/createToken)
777778
Rights should be '\*' on GET, POST and PUT
778779
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
885886
}
886887
```
887888

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:
889890

890891
<img src="https://github.com/TimothyYe/godns/blob/master/assets/snapshots/mail.png?raw=true" />
891892

@@ -905,7 +906,7 @@ To receive a [Telegram](https://telegram.org/) message each time the IP changes,
905906
}
906907
```
907908

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`.
909910

910911
#### Slack
911912

@@ -965,12 +966,12 @@ can be found on the Pushover [API description](https://pushover.net/api#priority
965966

966967
### Webhook
967968

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.
969970

970971
The configuration section `webhook` is used for customizing the webhook request. In general, there are 2 fields used for the webhook request:
971972

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.
974975
975976
Available variables:
976977

@@ -1004,7 +1005,7 @@ http://localhost:5000/api/v1/send?domain=ddns.example.com&ip=192.168.1.1&ip_type
10041005
}
10051006
```
10061007

1007-
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:
10081009

10091010
```json
10101011
{ "domain": "ddns.example.com", "ip": "192.168.1.1", "ip_type": "IPV4" }
@@ -1052,7 +1053,7 @@ To enable the `IPv6` support of GoDNS, there are two solutions to choose from:
10521053

10531054
#### Network interface IP address
10541055

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:
10561057

10571058
```json
10581059
"ip_urls": [""],
@@ -1096,7 +1097,7 @@ To display debug info, set `debug_info` as `true` to enable this feature. By def
10961097

10971098
#### Multiple API URLs
10981099

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:
11001101

11011102
```json
11021103
"ip_urls": [
@@ -1137,7 +1138,7 @@ There are a few ways to run GoDNS.
11371138

11381139
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`).
11391140

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.
11411142

11421143
```json
11431144
{
@@ -1199,7 +1200,7 @@ Available docker registries:
11991200
- <https://hub.docker.com/r/timothyye/godns>
12001201
- <https://github.com/TimothyYe/godns/pkgs/container/godns>
12011202

1202-
Visit <https://hub.docker.com/r/timothyye/godns> to fetch the latest docker image. The `-p 9000:9000` option is used to expose the web panel.
1203+
Visit <https://hub.docker.com/r/timothyye/godns> to fetch the latest docker image. The `-p 9000:9000` option exposes the web panel.
12031204

12041205
With `/path/to/config.json` as your local configuration file, run:
12051206

0 commit comments

Comments
 (0)