diff options
Diffstat (limited to 'middleware/reverse/README.md')
-rw-r--r-- | middleware/reverse/README.md | 86 |
1 files changed, 0 insertions, 86 deletions
diff --git a/middleware/reverse/README.md b/middleware/reverse/README.md deleted file mode 100644 index 2bc4b2e1d..000000000 --- a/middleware/reverse/README.md +++ /dev/null @@ -1,86 +0,0 @@ -# reverse - -The *reverse* middleware allows CoreDNS to respond dynamically to a PTR request and the related A/AAAA request. - -## Syntax - -~~~ -reverse NETWORK... { - hostname TEMPLATE - [ttl TTL] - [fallthrough] - [wildcard] -~~~ - -* **NETWORK** one or more CIDR formatted networks to respond on. -* `hostname` injects the IP and zone to a template for the hostname. Defaults to "ip-{IP}.{zone[1]}". See below for template. -* `ttl` defaults to 60 -* `fallthrough` if zone matches and no record can be generated, pass request to the next middleware. -* `wildcard` allows matches to catch all subdomains as well. - -### Template Syntax - -The template for the hostname is used for generating the PTR for a reverse lookup and matching the -forward lookup back to an IP. - -#### `{ip}` - -The `{ip}` symbol is **required** to make reverse work. -For IPv4 lookups the IP is directly extracted -With IPv6 lookups the ":" is removed, and any zero ranged are expanded, e.g., -"ffff::ffff" results in "ffff000000000000000000000000ffff" - -#### `{zone[i]}` - -The `{zone[i]}` symbol is **optional** and can be replaced by a fixed (zone) string. -The zone will be matched by the zones listed in *this* configuration stanza. -`i` needs to be replaced with the index of the configured listener zones, starting with 1. - -## Examples - -~~~ txt -arpa compute.internal { - # proxy unmatched requests - proxy . 8.8.8.8 - - # answer requests for IPs in this network - # PTR 1.0.32.10.in-addr.arpa. 3600 ip-10.0.32.1.compute.internal. - # A ip-10.0.32.1.compute.internal. 3600 10.0.32.1 - # v6 is also possible - # PTR 1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.1.0.d.f.ip6.arpa. 3600 ip-fd010000000000000000000000000001.compute.internal. - # AAAA ip-fd010000000000000000000000000001.compute.internal. 3600 fd01::1 - reverse 10.32.0.0/16 fd01::/16 { - # template of the ip injection to hostname, zone resolved to compute.internal. - hostname ip-{ip}.{zone[2]} - - ttl 3600 - - # Forward unanswered or unmatched requests to proxy - # without this flag, requesting A/AAAA records on compute.internal. will end here. - fallthrough - } -} -~~~ - - -~~~ txt -32.10.in-addr.arpa.arpa arpa.company.org { - - reverse 10.32.0.0/16 { - # template of the ip injection to hostname, zone resolved to arpa.company.org. - hostname "ip-{ip}.v4.{zone[2]}" - - ttl 3600 - - # fallthrough is not required, v4.arpa.company.org. will be only answered here - } - - # cidr closer to the ip wins, so we can overwrite the "default" - reverse 10.32.2.0/24 { - # its also possible to set fix domain suffix - hostname ip-{ip}.fix.arpa.company.org. - - ttl 3600 - } -} -~~~ |