History

Miek Gieben 818d2b10ad cidr everywhere: check all middleware (#915 ) * cidr everywhere: check all middleware Add tests for cidr in only that middleware that already tests for this. Check the other ones manually (and put reverse in the tests cases anyway). Make etcd setup_test run without +build etcd tag - it is not needed for this test - move rest of the code to lookup_test.go. Cleanup proxy test a bit and remove TempDir as there is test.TempFile that does the same thing. Fixes #909 * coredns package * Fix test compile		2017-08-13 18:16:25 +01:00
..
auto.go	Fix import path `github.com/miekg/coredns` -> `github.com/coredns/coredns` (#547 )	2017-02-22 06:51:47 +00:00
README.md	middleware/{file, auto}: resolve external CNAMEs	2016-11-09 21:26:49 +00:00
regexp.go	middleware/auto: add (#333 )	2016-10-17 18:37:56 +01:00
regexp_test.go	middleware/auto: add (#333 )	2016-10-17 18:37:56 +01:00
setup.go	core: replace GetMiddleware (#885 )	2017-08-10 21:31:36 +01:00
setup_test.go	cidr everywhere: check all middleware (#915 )	2017-08-13 18:16:25 +01:00
walk.go	middleware/file: don't reload zone when SOA isn't changed (#707 )	2017-06-08 18:43:11 +01:00
walk_test.go	middleware/auto: handle non-existent directory (#385 )	2016-11-06 19:37:43 +00:00
watcher_test.go	finish missing watcher check (#387 )	2016-11-07 08:00:30 +00:00
zone.go	Fix import path `github.com/miekg/coredns` -> `github.com/coredns/coredns` (#547 )	2017-02-22 06:51:47 +00:00

README.md

auto

auto enables serving zone data from an RFC 1035-style master file which is automatically picked up from disk.

The auto middleware is used for an "old-style" DNS server. It serves from a preloaded file that exists on disk. If the zone file contains signatures (i.e. is signed, i.e. DNSSEC) correct DNSSEC answers are returned. Only NSEC is supported! If you use this setup you are responsible for resigning the zonefile. New zones or changed zone are automatically picked up from disk.

Syntax

auto [ZONES...] {
    directory DIR [REGEXP ORIGIN_TEMPLATE [TIMEOUT]]
    no_reload
    upstream ADDRESS...
}

ZONES zones it should be authoritative for. If empty, the zones from the configuration block are used.

directory loads zones from the speficied DIR. If a file name matches REGEXP it will be used to extract the origin. ORIGIN_TEMPLATE will be used as a template for the origin. Strings like {<number>} are replaced with the respective matches in the file name, i.e. {1} is the first match, {2} is the second, etc.. The default is: db\.(.*) {1} e.g. from a file with the name db.example.com, the extracted origin will be example.com. TIMEOUT specifies how often CoreDNS should scan the directory, the default is every 60 seconds. This value is in seconds. The minimum value is 1 second.
no_reload by default CoreDNS will reload a zone from disk whenever it detects a change to the file. This option disables that behavior.
upstream defines upstream resolvers to be used resolve external names found (think CNAMEs) pointing to external names.

All directives from the file middleware are supported. Note that auto will load all zones found, even though the directive might only receive queries for a specific zone. I.e:

auto example.org {
    directory /etc/coredns/zones
}

Will happily pick up a zone for example.COM, except it will never be queried, because the auto directive only is authoritative for example.ORG.

Examples

Load org domains from /etc/coredns/zones/org and allow transfers to the internet, but send notifies to 10.240.1.1

auto org {
    directory /etc/coredns/zones/org
    transfer to *
    transfer to 10.240.1.1
}

Load org domains from /etc/coredns/zones/org and looks for file names as www.db.example.org, where example.org is the origin. Scan every 45 seconds.

auto org {
    directory /etc/coredns/zones/org www\.db\.(.*) {1} 45
}