@@ -9,12 +9,12 @@ Configuration
9
9
10
10
VyOS provides DNS infrastructure for small networks. It is designed to be
11
11
lightweight and have a small footprint, suitable for resource constrained
12
- routers and firewalls, for this we utilize PowerDNS recursor.
12
+ routers and firewalls. For this we utilize PowerDNS recursor.
13
13
14
14
The VyOS DNS forwarder does not require an upstream DNS server. It can serve as
15
15
a full recursive DNS server - but it can also forward queries to configurable
16
16
upstream DNS servers. By not configuring any upstream DNS servers you also
17
- avoid to be tracked by the provider of your upstream DNS server.
17
+ avoid being tracked by the provider of your upstream DNS server.
18
18
19
19
.. cfgcmd :: set service dns forwarding system
20
20
@@ -29,38 +29,38 @@ avoid to be tracked by the provider of your upstream DNS server.
29
29
.. cfgcmd :: set service dns forwarding domain <domain-name> server <address>
30
30
31
31
Forward received queries for a particular domain
32
- (specified via `domain-name `) to a given name-server . Multiple nameservers
32
+ (specified via `domain-name `) to a given nameserver . Multiple nameservers
33
33
can be specified. You can use this feature for a DNS split-horizon
34
34
configuration.
35
35
36
36
.. note :: This also works for reverse-lookup zones (``18.172.in-addr.arpa``).
37
37
38
38
.. cfgcmd :: set service dns forwarding allow-from <network>
39
39
40
- Given the fact that open DNS recursors could be used on DDOS amplification
41
- attacts , you must configure the networks which are allowed to use this
40
+ Given the fact that open DNS recursors could be used on DDoS amplification
41
+ attacks , you must configure the networks which are allowed to use this
42
42
recursor. A network of ``0.0.0.0/0 `` or ``::/0 `` would allow all IPv4 and
43
- IPv6 networks to query this server. This is on general a bad idea.
43
+ IPv6 networks to query this server. This is generally a bad idea.
44
44
45
45
.. cfgcmd :: set service dns forwarding dnssec
46
46
<off | process-no-validate | process | log-fail | validate>
47
47
48
- The PowerDNS Recursor has 5 different levels of DNSSEC processing, which can
48
+ The PowerDNS recursor has 5 different levels of DNSSEC processing, which can
49
49
be set with the dnssec setting. In order from least to most processing, these
50
50
are:
51
51
52
52
* **off ** In this mode, no DNSSEC processing takes place. The recursor will
53
53
not set the DNSSEC OK (DO) bit in the outgoing queries and will ignore the
54
54
DO and AD bits in queries.
55
55
56
- * **process-no-validate ** In this mode the Recursor acts as a "security
56
+ * **process-no-validate ** In this mode the recursor acts as a "security
57
57
aware, non-validating" nameserver, meaning it will set the DO-bit on
58
58
outgoing queries and will provide DNSSEC related RRsets (NSEC, RRSIG) to
59
59
clients that ask for them (by means of a DO-bit in the query), except for
60
60
zones provided through the auth-zones setting. It will not do any
61
61
validation in this mode, not even when requested by the client.
62
62
63
- * **process ** When dnssec is set to process the behaviour is similar to
63
+ * **process ** When dnssec is set to process the behavior is similar to
64
64
process-no-validate. However, the recursor will try to validate the data
65
65
if at least one of the DO or AD bits is set in the query; in that case,
66
66
it will set the AD-bit in the response when the data is validated
@@ -77,17 +77,17 @@ avoid to be tracked by the provider of your upstream DNS server.
77
77
queries will be validated and will be answered with a SERVFAIL in case of
78
78
bogus data, regardless of the client's request.
79
79
80
- .. note :: The famous UNIX /Linux ``dig`` tool sets the AD-bit in the query.
80
+ .. note :: The popular Unix /Linux ``dig`` tool sets the AD-bit in the query.
81
81
This might lead to unexpected query results when testing. Set ``+noad ``
82
- on the ``dig `` commandline when this is the case.
82
+ on the ``dig `` command line when this is the case.
83
83
84
84
.. note :: The ``CD``-bit is honored correctly for process and validate. For
85
85
log-fail, failures will be logged too.
86
86
87
87
.. cfgcmd :: set service dns forwarding ignore-hosts-file
88
88
89
- Do not use local ``/etc/hosts `` file in name resolution. VyOS DHCP server
90
- will use this file to add resolvers to assigned addresses.
89
+ Do not use the local ``/etc/hosts `` file in name resolution. VyOS DHCP
90
+ server will use this file to add resolvers to assigned addresses.
91
91
92
92
.. cfgcmd :: set service dns forwarding max-cache-entries
93
93
@@ -206,7 +206,7 @@ Configuration
206
206
.. cfgcmd :: set service dns dynamic interface <interface> rfc2136 <service-name>
207
207
ttl <ttl>
208
208
209
- Configure optional TTL value on the given resource record. This defualts to
209
+ Configure optional TTL value on the given resource record. This defaults to
210
210
600 seconds.
211
211
212
212
Example
@@ -304,7 +304,7 @@ Use DynDNS as your preferred provider:
304
304
set service dns dynamic interface eth0 service dyndns host-name my-dyndns-hostname
305
305
306
306
.. note :: Multiple services can be used per interface. Just specify as many
307
- serives per interface as you like!
307
+ services per interface as you like!
308
308
309
309
Running Behind NAT
310
310
------------------
0 commit comments