Fixed minor markdown layout issues with Gitlab and closed #4
This commit is contained in:
42
README.md
42
README.md
@@ -51,15 +51,15 @@ The setup of this solution consists of the following steps:
|
||||
1. Ensure that the Perl modules CGI and Net::DNS are installed.
|
||||
* on Debian/Ubuntu linux this can be done by:
|
||||
|
||||
```
|
||||
~~~
|
||||
sudo apt-get install libcgi-pm-perl libnet-dns-perl
|
||||
```
|
||||
~~~
|
||||
|
||||
* or directly from CPAN (assuming that is installed):
|
||||
|
||||
```
|
||||
~~~
|
||||
cpan CGI Net::DNS
|
||||
```
|
||||
~~~
|
||||
|
||||
2. Install the file `dyndns.pl` either in your cgi-bin directory or in a
|
||||
separate folder
|
||||
@@ -74,21 +74,21 @@ The setup of this solution consists of the following steps:
|
||||
server's cgi-bin directory) add the following line to your Apache virtual
|
||||
host configuration (replacing `[INSTALL_DIR]` with the install directory):
|
||||
|
||||
```
|
||||
~~~
|
||||
ScriptAlias /dyndns [INSTALL_DIR]/dyndns.pl
|
||||
```
|
||||
~~~
|
||||
|
||||
in case you have installed the script in a non-standard folder, you will
|
||||
also need the following to make this work on Apache 2.4 (again replacing
|
||||
`[INSTALL_DIR]` with the install directory):
|
||||
|
||||
```
|
||||
~~~
|
||||
<Directory [INSTALL_DIR]/>
|
||||
AllowOverride None
|
||||
Options +ExecCGI -MultiViews -Indexes
|
||||
Require all granted
|
||||
</Directory>
|
||||
```
|
||||
~~~
|
||||
|
||||
reload apache with `/etc/init.d/apache reload` to make the script
|
||||
available at <http://myserver.mydomain.tld/dyndns>.
|
||||
@@ -102,7 +102,7 @@ The setup of this solution consists of the following steps:
|
||||
(e.g. `include "named.dyndns.conf";`). For a basic dynamic DNS setup a
|
||||
configuration like below is required:
|
||||
|
||||
```
|
||||
~~~
|
||||
// Define the keys for DynDNS
|
||||
key "dyndns.mydomain.tld" {
|
||||
algorithm hmac-md5; secret "QdDJC7QVYmsCxgWoSAUmBg==";
|
||||
@@ -125,7 +125,7 @@ The setup of this solution consists of the following steps:
|
||||
grant siteuser name site.dyndns.mydomain.tld ANY;
|
||||
};
|
||||
};
|
||||
```
|
||||
~~~
|
||||
|
||||
The above defines a domain zone file `dyndns/db.dyndns.mydomain.tld` with
|
||||
two signer/keys. *siteuser* only can update `site.dyndns.mydomain.tld`
|
||||
@@ -139,20 +139,20 @@ The setup of this solution consists of the following steps:
|
||||
|
||||
* to generate a new key *dyndns.mydomain.tld*:
|
||||
|
||||
```
|
||||
~~~
|
||||
ddns-confgen -a hmac-md5 -k dyndns.mydomain.tld -z dyndns.mydomain.tld
|
||||
```
|
||||
~~~
|
||||
|
||||
* generate the required configuration for *siteuser* (or any new user):
|
||||
|
||||
```
|
||||
~~~
|
||||
ddns-confgen -a hmac-md5 -k siteuser -s site.dyndns.mydomain.tld
|
||||
```
|
||||
~~~
|
||||
|
||||
6. Generate an initial zone file like the one below for the dyndns domain in
|
||||
the location specified in the config file above.
|
||||
|
||||
```
|
||||
~~~
|
||||
$TTL 3600 ; 1 hour
|
||||
@ IN SOA auth.dns.mydomain.tld. hostmaster.mydomain.tld. (
|
||||
2019000001 ; serial
|
||||
@@ -164,7 +164,7 @@ The setup of this solution consists of the following steps:
|
||||
TXT "Dynamic DNS zone for mydomain.tld"
|
||||
|
||||
site A 1.2.3.4
|
||||
```
|
||||
~~~
|
||||
|
||||
Please note that Bind will rewrite this file and you need to be careful
|
||||
with it. Entries do not need to exist initially, as long as the signer/key
|
||||
@@ -507,7 +507,7 @@ DDNS registrations using a custom URL. The Basic format for the registration
|
||||
URL to register is:
|
||||
|
||||
~~~
|
||||
https://SERVER/cgi-bin/dyndns/update?host=HOSTNAME&ip=IPADDRESS&secret=KEY`
|
||||
https://SERVER/cgi-bin/dyndns/update?host=HOSTNAME&ip=IPADDRESS&secret=KEY
|
||||
~~~
|
||||
|
||||
Check the [list of parameters supported](req_params) for all available options,
|
||||
@@ -552,13 +552,13 @@ https://SERVER/cgi-bin/dyndns/view?host
|
||||
-------------------------------------------
|
||||
For Cisco routers add the following config:
|
||||
|
||||
```
|
||||
~~~
|
||||
ip ddns update method DYNDNS
|
||||
HTTP
|
||||
add https://SERVER/cgi-bin/dyndns/update?host=<h>&ip=<a>&secret=SECRET
|
||||
remove https://SERVER/cgi-bin/dyndns/delete?host=<h>&secret=SECRET
|
||||
interval maximum 0 1 0 0
|
||||
```
|
||||
~~~
|
||||
|
||||
replacing `SERVER` for the host the script is installed on and `SECRET`
|
||||
for a DNS key authorized to update the record. The cisco router will replace <a>
|
||||
@@ -566,11 +566,11 @@ and <h> with the IPv4 address and hostname.
|
||||
|
||||
To setup interface `Dialer0` to register as `hostname.dyndns.mydomain.tld` add:
|
||||
|
||||
```
|
||||
~~~
|
||||
interface Dialer0
|
||||
ip ddns update hostname hostname.dyndns.mydomain.tld
|
||||
ip ddns update DYNDNS
|
||||
```
|
||||
~~~
|
||||
|
||||
Which instructs to register using the address of Dialer0 as soon as that is up
|
||||
or changes (this also works for non-dialer devices).
|
||||
|
||||
Reference in New Issue
Block a user