diff options
| author | kmpm <peter@birchroad.net> | 2019-01-20 12:11:31 +0100 |
|---|---|---|
| committer | kmpm <peter@birchroad.net> | 2019-01-20 12:13:48 +0100 |
| commit | 9a04c5abf4f2b7f961975ee61aede4ec9e99b565 (patch) | |
| tree | 90096f60dcc1a4e4e5d664094f728c931342ceb0 /docs/services/dns-forwarding.rst | |
| parent | ce02006259e45ea9b0ab5f30ac3f1639d2338505 (diff) | |
| download | vyos-documentation-9a04c5abf4f2b7f961975ee61aede4ec9e99b565.tar.gz vyos-documentation-9a04c5abf4f2b7f961975ee61aede4ec9e99b565.zip | |
services in own folder
* spitting services into multiple files in it's own folder
* making image links absolute
* some linting
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' |