Difference between revisions of "Template:Networking rutos manual dns"

From Teltonika Networks Wiki
m (Text replacement - "\{\{Template: Networking_rutos_manual_fw_disclosure (.*) (.*) (.*) (.*) \}\}" to "{{Template: Networking_device_manual_fw_disclosure | series = {{{series}}} | name = {{{name}}} | fw_version ={{Template: Networking_device_manual_latest_fw | series = {{{series}}} | name = {{{name}}} }} }}")
 
(One intermediate revision by the same user not shown)
Line 23: Line 23:
 
The <b>General Settings</b> section is used to set up the main DNS parameters. Refer to the table below for information on each configuration field.
 
The <b>General Settings</b> section is used to set up the main DNS parameters. Refer to the table below for information on each configuration field.
  
−
[[File:Networking_rutos_manual_dns_general_settings.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_dns_general_settings_v2.png|border|class=tlt-border]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
Line 33: Line 33:
 
     <tr>
 
     <tr>
 
         <td>Log queries</td>
 
         <td>Log queries</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off {{!}} on; default: <b>off</b></td>
−
         <td>When enabled, write received DNS requests to syslog.</td>
+
         <td>Write received DNS requests to syslog.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
         <td>DNS forwardings</td>
 
         <td>DNS forwardings</td>
−
         <td>string; default: <b>none</b></td>
+
         <td>Hostname (domain name) {{!}} IP address (ip); default: <b>none</b></td>
−
         <td>List of DNS servers to forward requests to.</td>
+
         <td>List of DNS servers to forward requests to. See the dnsmasq -S option man page for syntax details.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Addresses</td>
 +
        <td>Hostname (domain name) {{!}} IP address (ip); default: <b>none</b></td>
 +
        <td>List of IP addresses for queried domains. See the dnsmasq -A option man page for syntax details.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
         <td>Rebind protection</td>
 
         <td>Rebind protection</td>
−
         <td>off | on; default: <b>on</b></td>
+
         <td>off {{!}} on; default: <b>on</b></td>
 
         <td>Discards upstream RFC1918 responses. When enabled, the device will not resolve domain names for internal hosts.</td>
 
         <td>Discards upstream RFC1918 responses. When enabled, the device will not resolve domain names for internal hosts.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
         <td>Local Service Only</td>
 
         <td>Local Service Only</td>
−
         <td>off | on; default: <b>off</b></td>
+
         <td>off {{!}} on; default: <b>off</b></td>
−
         <td>Limit DNS service to subnets and interfaces on which this device is serving as a DNS server.</td>
+
         <td>Limit DNS service to subnets interfaces on which we are serving DNS.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
         <td>Listen Interfaces</td>
 
         <td>Listen Interfaces</td>
 
         <td>network interface(s); default: <b>none</b></td>
 
         <td>network interface(s); default: <b>none</b></td>
−
         <td>Limits listening for DNS queries to interfaces specified in this field and loopback. Leave empty to listen on all interfaces.</td>
+
         <td>Limit DHCP and DNS requests listening to these interfaces, and loopback. Leave empty to listen on all interfaces.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
         <td>Exclude Interfaces</td>
 
         <td>Exclude Interfaces</td>
 
         <td>network interface(s); default: <b>none</b></td>
 
         <td>network interface(s); default: <b>none</b></td>
−
         <td>Prevents listening for DNS queries on interfaces specified in this field. Leave empty to listen on all interfaces.</td>
+
         <td>Prevent DHCP and DNS requests listening on these interfaces. Leave empty to listen on all interfaces.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
  
−
==Advanced Settings==
+
===Advanced Settings===
  
 
The <b>Advanced Settings</b> section is used to set up some of the more specific DNS parameters. Refer to the table below for information on each configuration field.
 
The <b>Advanced Settings</b> section is used to set up some of the more specific DNS parameters. Refer to the table below for information on each configuration field.
  
−
[[File:Networking_rutos_manual_dns_advanced_settings.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_dns_advanced_settings_v2.png|border|class=tlt-border]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
Line 77: Line 82:
 
     <tr>
 
     <tr>
 
         <td>Filter private</td>
 
         <td>Filter private</td>
−
         <td>off | on; default: <b>on</b></td>
+
         <td>off {{!}} on; default: <b>on</b></td>
 
         <td>Do not forward reverse lookups for local networks.</td>
 
         <td>Do not forward reverse lookups for local networks.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
         <td>Localise queries</td>
 
         <td>Localise queries</td>
−
         <td>off | on; default: <b>on</b></td>
+
         <td>off {{!}} on; default: <b>on</b></td>
 
         <td>Localise hostname depending on the requesting subnet if multiple IPs are available.</td>
 
         <td>Localise hostname depending on the requesting subnet if multiple IPs are available.</td>
 
     </tr>
 
     </tr>
Line 93: Line 98:
 
         <td>Size of DNS query cache</td>
 
         <td>Size of DNS query cache</td>
 
         <td>integer [0..10000]; default: <b>none</b></td>
 
         <td>integer [0..10000]; default: <b>none</b></td>
−
         <td>Number of cached DNS entries. Set to 0 for no caching.</td>
+
         <td>Number of cached DNS entries (max is 10000, 0 is no caching).</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
 +
 +
==HTTPS DNS Proxy==
 +
 +
Light-weight DNS-over-HTTPS, non-caching translation proxy for the RFC 8484 DoH standard. It receives regular (UDP) DNS requests and resolves them via DoH resolver.
 +
 +
<b>Note:</b> IGMP Proxy is additional software that can be installed from the <b>System → [[{{{name}}} Package Manager|Package Manager]]</b> page.
 +
 +
===HTTPS DNS proxy configuration===
 +
 +
The <b>HTTPS DNS proxy configuration</b> section is used to enable the service. Refer to the table below for information on each configuration field.
 +
 +
[[File:Networking_rutos_manual_https_dns_proxy.png|border|class=tlt-border]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>Field</th>
 +
        <th>Value</th>
 +
        <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
        <td>Enable</td>
 +
        <td>off {{!}} on; default: <b>off</b></td>
 +
        <td>Enables HTTPS DNS proxy configuration.</td>
 +
    </tr>
 +
</table>
 +
 +
===DNS over HTTPS resolvers===
 +
 +
 +
The <b>DNS over HTTPS resolvers</b> section is used to set up some of the more specific DNS parameters. Refer to the table below for information on each configuration field.
 +
 +
[[File:Networking_rutos_manual_dns_over_https_resolvers.png|border|class=tlt-border]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>Field</th>
 +
        <th>Value</th>
 +
        <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
        <td>Preset</td>
 +
        <td>Custom {{!}} Google {{!}} CloudFlare; default: <b>CloudFlare</b></td>
 +
        <td>Presets for popular DNS over HTTPS resolvers. Use "Custom" to set your resolver.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Bootsrap DNS</td>
 +
        <td>IPv4/IPv6 address; default: <b>depends on the service provider</b></td>
 +
        <td>This DNS is used for the initial "Resolver URL" resolve.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Resolver URL</td>
 +
        <td>url; default: <b>depends on the service provider</b></td>
 +
        <td>Resolver URL.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Port</td>
 +
        <td>integer [1..65535]; default: <b>depends on the service provider</b></td>
 +
        <td>Internal port used for this resolver. Change only if it collides with existing ports on this device.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Actions</td>
 +
        <td>-interactive button; default: <b>Delete</b></td>
 +
        <td>Deletes the preset.</td>
 +
    </tr>
 +
</table>
 +
 +
<b>Note:</b> If more than one resolver is specified then the first is used as the main one and others are used as failovers.
  
 
[[Category:{{{name}}} Network section]]
 
[[Category:{{{name}}} Network section]]

Latest revision as of 15:00, 27 June 2024

The information in this page is updated in accordance with firmware version .

Summary

The DNS page is used to to set up how the device utilizes its own and other DNS servers.

This manual page provides an overview of the DNS windows in {{{name}}} devices.

If you're having trouble finding this page or some of the parameters described here on your device's WebUI, you should turn on "Advanced WebUI" mode. You can do that by clicking the "Advanced" button, located at the top of the WebUI.

Networking rutos manual webui basic advanced mode 75.gif

General Settings

The General Settings section is used to set up the main DNS parameters. Refer to the table below for information on each configuration field.

Networking rutos manual dns general settings v2.png

Field Value Description
Log queries off | on; default: off Write received DNS requests to syslog.
DNS forwardings Hostname (domain name) | IP address (ip); default: none List of DNS servers to forward requests to. See the dnsmasq -S option man page for syntax details.
Addresses Hostname (domain name) | IP address (ip); default: none List of IP addresses for queried domains. See the dnsmasq -A option man page for syntax details.
Rebind protection off | on; default: on Discards upstream RFC1918 responses. When enabled, the device will not resolve domain names for internal hosts.
Local Service Only off | on; default: off Limit DNS service to subnets interfaces on which we are serving DNS.
Listen Interfaces network interface(s); default: none Limit DHCP and DNS requests listening to these interfaces, and loopback. Leave empty to listen on all interfaces.
Exclude Interfaces network interface(s); default: none Prevent DHCP and DNS requests listening on these interfaces. Leave empty to listen on all interfaces.

Advanced Settings

The Advanced Settings section is used to set up some of the more specific DNS parameters. Refer to the table below for information on each configuration field.

Networking rutos manual dns advanced settings v2.png

Field Value Description
Filter private off | on; default: on Do not forward reverse lookups for local networks.
Localise queries off | on; default: on Localise hostname depending on the requesting subnet if multiple IPs are available.
Additional servers file text file; default: none Uploads an additional DNS servers file. This file may contain lines like 'server=/domain/1.2.3.4' or 'server=1.2.3.4' for domain-specific or full upstream DNS servers.
Size of DNS query cache integer [0..10000]; default: none Number of cached DNS entries (max is 10000, 0 is no caching).

HTTPS DNS Proxy

Light-weight DNS-over-HTTPS, non-caching translation proxy for the RFC 8484 DoH standard. It receives regular (UDP) DNS requests and resolves them via DoH resolver.

Note: IGMP Proxy is additional software that can be installed from the System → [[{{{name}}} Package Manager|Package Manager]] page.

HTTPS DNS proxy configuration

The HTTPS DNS proxy configuration section is used to enable the service. Refer to the table below for information on each configuration field.

Networking rutos manual https dns proxy.png

Field Value Description
Enable off | on; default: off Enables HTTPS DNS proxy configuration.

DNS over HTTPS resolvers

The DNS over HTTPS resolvers section is used to set up some of the more specific DNS parameters. Refer to the table below for information on each configuration field.

Networking rutos manual dns over https resolvers.png

Field Value Description
Preset Custom | Google | CloudFlare; default: CloudFlare Presets for popular DNS over HTTPS resolvers. Use "Custom" to set your resolver.
Bootsrap DNS IPv4/IPv6 address; default: depends on the service provider This DNS is used for the initial "Resolver URL" resolve.
Resolver URL url; default: depends on the service provider Resolver URL.
Port integer [1..65535]; default: depends on the service provider Internal port used for this resolver. Change only if it collides with existing ports on this device.
Actions -interactive button; default: Delete Deletes the preset.

Note: If more than one resolver is specified then the first is used as the main one and others are used as failovers.

[[Category:{{{name}}} Network section]]

Retrieved from "https://wiki.teltonika-networks.com/index.php?title=Template:Networking_rutos_manual_dns&oldid=128104"