diff options
| author | Yuriy Andamasov <andamasov@gmail.com> | 2019-01-20 16:17:30 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2019-01-20 16:17:30 +0100 |
| commit | 612ab4def61755afc369c8e226588b15db0bc751 (patch) | |
| tree | 8356346a5b7a4b51339a4975f10da3f4b9123ef9 /docs/services/dns-forwarding.rst | |
| parent | ce02006259e45ea9b0ab5f30ac3f1639d2338505 (diff) | |
| parent | 1ac4afa392eb4c077507cf3866ebc1b8b3cb1793 (diff) | |
| download | vyos-documentation-612ab4def61755afc369c8e226588b15db0bc751.tar.gz vyos-documentation-612ab4def61755afc369c8e226588b15db0bc751.zip | |
Merge pull request #7 from kmpm/festures/split-services
services in own folder
Diffstat (limited to 'docs/services/dns-forwarding.rst')
| -rw-r--r-- | docs/services/dns-forwarding.rst | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/docs/services/dns-forwarding.rst b/docs/services/dns-forwarding.rst new file mode 100644 index 00000000..a8501c8f --- /dev/null +++ b/docs/services/dns-forwarding.rst @@ -0,0 +1,59 @@ +DNS Forwarding +-------------- + +Use DNS forwarding if you want your router to function as a DNS server for the +local network. There are several options, the easiest being 'forward all +traffic to the system DNS server(s)' (defined with set system name-server): + +.. code-block:: sh + + set service dns forwarding system + +Manually setting DNS servers for forwarding: + +.. code-block:: sh + + set service dns forwarding name-server 8.8.8.8 + set service dns forwarding name-server 8.8.4.4 + +Manually setting DNS servers with IPv6 connectivity: + +.. code-block:: sh + + set service dns forwarding name-server 2001:4860:4860::8888 + set service dns forwarding name-server 2001:4860:4860::8844 + +Setting a forwarding DNS server for a specific domain: + +.. code-block:: sh + + set service dns forwarding domain example.com server 192.0.2.1 + +Example 1 +^^^^^^^^^ + +Router with two interfaces eth0 (WAN link) and eth1 (LAN). A DNS server for the +local domain (example.com) is at 192.0.2.1, other DNS requests are forwarded +to Google's DNS servers. + +.. code-block:: sh + + set service dns forwarding domain example.com server 192.0.2.1 + set service dns forwarding name-server 8.8.8.8 + set service dns forwarding name-server 8.8.4.4 + set service dns forwarding listen-on 'eth1' + +Example 2 +^^^^^^^^^ + +Same as example 1 but with additional IPv6 addresses for Google's public DNS +servers: + +.. code-block:: sh + + set service dns forwarding domain example.com server 192.0.2.1 + set service dns forwarding name-server 8.8.8.8 + set service dns forwarding name-server 8.8.4.4 + set service dns forwarding name-server 2001:4860:4860::8888 + set service dns forwarding name-server 2001:4860:4860::8844 + set service dns forwarding listen-on 'eth1' |