vyos/vyos-documentation
1
0
Fork 0
mirror of https://github.com/vyos/vyos-documentation.git synced 2025-10-26 08:41:46 +01:00
Code Issues Packages Projects Releases Wiki Activity

Second update dns.rst

Browse Source 
Based on the discussion here: https://forum.vyos.io/t/dynamic-dns-not-wollowing-web-options/12309 it seems necessary to note that setting the web-options on a given interface is not sufficient for determining the IP address when behind NAT. 

I've added some additional detail, which I think will make that more clear, as well as listed the commands as required to set up DDNS behind NAT. 

Further I updated the section on RFC2136 to accurately show address instead of interface
This commit is contained in:
Dibins 2023-10-02 16:53:29 -05:00 committed by GitHub
parent cf1c7eb76d
commit fa84bc4b35
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 16 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/configuration/service/dns.rst
View File

@ -216,36 +216,36 @@ Configuration
:rfc:`2136` Based :rfc:`2136` Based
----------------- -----------------
.. cfgcmd:: set service dns dynamic interface <interface> rfc2136 <service-name> .. cfgcmd:: set service dns dynamic address <interface> rfc2136 <service-name>
Create new :rfc:`2136` DNS update configuration which will update the IP Create new :rfc:`2136` DNS update configuration which will update the IP
address assigned to `<interface>` on the service you configured under address assigned to `<interface>` on the service you configured under
`<service-name>`. `<service-name>`.
.. cfgcmd:: set service dns dynamic interface <interface> rfc2136 <service-name> .. cfgcmd:: set service dns dynamic address <interface> rfc2136 <service-name>
key <keyfile> key <keyfile>
File identified by `<keyfile>` containing the secret RNDC key shared with File identified by `<keyfile>` containing the secret RNDC key shared with
remote DNS server. remote DNS server.
.. cfgcmd:: set service dns dynamic interface <interface> rfc2136 <service-name> .. cfgcmd:: set service dns dynamic address <interface> rfc2136 <service-name>
server <server> server <server>
Configure the DNS `<server>` IP/FQDN used when updating this dynamic Configure the DNS `<server>` IP/FQDN used when updating this dynamic
assignment. assignment.
.. cfgcmd:: set service dns dynamic interface <interface> rfc2136 <service-name> .. cfgcmd:: set service dns dynamic address <interface> rfc2136 <service-name>
zone <zone> zone <zone>
Configure DNS `<zone>` to be updated. Configure DNS `<zone>` to be updated.
.. cfgcmd:: set service dns dynamic interface <interface> rfc2136 <service-name> .. cfgcmd:: set service dns dynamic address <interface> rfc2136 <service-name>
record <record> record <record>
Configure DNS `<record>` which should be updated. This can be set multiple Configure DNS `<record>` which should be updated. This can be set multiple
times. times.
.. cfgcmd:: set service dns dynamic interface <interface> rfc2136 <service-name> .. cfgcmd:: set service dns dynamic address <interface> rfc2136 <service-name>
ttl <ttl> ttl <ttl>
Configure optional TTL value on the given resource record. This defaults to Configure optional TTL value on the given resource record. This defaults to
@ -381,15 +381,21 @@ By default, ddclient_ will update a dynamic dns record using the IP address
directly attached to the interface. If your VyOS instance is behind NAT, your directly attached to the interface. If your VyOS instance is behind NAT, your
record will be updated to point to your internal IP. record will be updated to point to your internal IP.
ddclient_ has another way to determine the WAN IP address. This is controlled Above, command syntax isn noted to configure dynamic dns on a specific interface.
by: It is possible to overlook the additional address option, web, when completeing
those commands. ddclient_ has another way to determine the WAN IP address, using
a web-based url to determine the external IP. Each of the commands above will
need to be modified to use 'web' as the 'interface' specified if this functionality
is to be utilized.
.. cfgcmd:: set service dns dynamic address <interface> web-options url <url> This functionality is controlled by adding the following configuration:
.. cfgcmd:: set service dns dynamic address web web-options url <url>
Use configured `<url>` to determine your IP address. ddclient_ will load Use configured `<url>` to determine your IP address. ddclient_ will load
`<url>` and tries to extract your IP address from the response. `<url>` and tries to extract your IP address from the response.
.. cfgcmd:: set service dns dynamic address <interface> web-options skip <pattern> .. cfgcmd:: set service dns dynamic address web web-options skip <pattern>
ddclient_ will skip any address located before the string set in `<pattern>`. ddclient_ will skip any address located before the string set in `<pattern>`.