Differences

This shows you the differences between two versions of the page.

--- networking:dns:unbound:local_data [2020/12/08 08:49] – created peter
+++ networking:dns:unbound:local_data [2022/10/08 11:48] (current) – peter
@@ Line 1: / Line 1: @@
 ====== Networking - DNS - Unbound - Local Data ======
+Local data, which can override  A / AAAA addresses, can be configured to reply to DNS queries.
+The format for local-data is:
+<code bash>
+local-data: "<resource record string>"
+</code>
+<WRAP info>
+**NOTE:**
+  * The query has to match exactly unless you configure a local-zone as **redirect**.
+  * If  not matched exactly, the local-zone type determines further processing.
+  * If local-data is configured that is not a subdomain of a local-zone, a transparent local-zone is configured.
+  * For record types such as **TXT**, use  single quotes, as in <code bash>
+local-data: 'example. TXT "text"'.
+</code>
+</WRAP>
+<WRAP info>
+**NOTE:**  local-data is often associated with a [[Networking:DNS:Unbound:Local Zones|local-zone]]
+<code>
+local-zone: <zone> <type>
+local-data: "<resource record string>"
+</code>
+If you configure **local-data** without specifying **local-zone**, by default a transparent local-zone is created for the data.
+</WRAP>
+----
+You can add locally served data with:
+<code>
+local-zone: "local." static
+local-data: "mycomputer.local. IN A 192.0.2.51"
+local-data: 'mytext.local TXT "content of text record"'
+</code>
+You can override certain queries with:
+<code>
+local-data: "adserver.example.com A 127.0.0.1"
+</code>
+You can redirect a domain to a fixed address with:
+<code>
+# This makes example.com, www.example.com, etc, all go to 192.0.2.3.
+local-zone: "example.com" redirect
+local-data: "example.com A 192.0.2.3"
+</code>
+You can also add PTR records using local-data directly ("ipv4 name" or "ipv6 name"), but then you need to do the reverse notation yourself:
+<code>
+local-data-ptr: "192.0.2.3 www.example.com"
+</code>
+----
+===== Examples =====
 ^Type^Example^Comment^
@@ Line 5: / Line 70: @@
 |MX|local-data: "my.localdomain. MX 10 mail.example.org."|"@" Is not acceptable for unbound - replace the domain's FQDN instead. Unbound does not use the default domain in this specific case.|
 |SRV|local-data: "_sip._tcp 60 IN SRV 0 5 5060 pbx.example.org."| |
+----
+===== References =====
+https://nlnetlabs.nl/documentation/unbound/unbound.conf/
+https://fossies.org/linux/unbound/doc/example.conf.in