98 lines
2.4 KiB
Groff
98 lines
2.4 KiB
Groff
.\" generated with Ronn/v0.7.3
|
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
|
.
|
|
.TH "COREDNS\-HOSTS" "7" "March 2018" "CoreDNS" "CoreDNS plugins"
|
|
.
|
|
.SH "NAME"
|
|
\fIhosts\fR \- enables serving zone data from a \fB/etc/hosts\fR style file\.
|
|
.
|
|
.SH "DESCRIPTION"
|
|
The hosts plugin is useful for serving zones from a /etc/hosts file\. It serves from a preloaded file that exists on disk\. It checks the file for changes and updates the zones accordingly\. This plugin only supports A, AAAA, and PTR records\. The hosts plugin can be used with readily available hosts files that block access to advertising servers\.
|
|
.
|
|
.P
|
|
This plugin can only be used once per Server Block\.
|
|
.
|
|
.SH "SYNTAX"
|
|
.
|
|
.nf
|
|
|
|
hosts [FILE [ZONES\.\.\.]] {
|
|
[INLINE]
|
|
fallthrough [ZONES\.\.\.]
|
|
}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBFILE\fR the hosts file to read and parse\. If the path is relative the path from the \fIroot\fR directive will be prepended to it\. Defaults to /etc/hosts if omitted\. We scan the file for changes every 5 seconds\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBZONES\fR zones it should be authoritative for\. If empty, the zones from the configuration block are used\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBINLINE\fR the hosts file contents inlined in Corefile\. If there are any lines before fallthrough then all of them will be treated as the additional content for hosts file\. The specified hosts file path will still be read but entries will be overrided\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBfallthrough\fR If zone matches and no record can be generated, pass request to the next plugin\. If \fB[ZONES\.\.\.]\fR is omitted, then fallthrough happens for all zones for which the plugin is authoritative\. If specific zones are listed (for example \fBin\-addr\.arpa\fR and \fBip6\.arpa\fR), then only queries for those zones will be subject to fallthrough\.
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.SH "EXAMPLES"
|
|
Load \fB/etc/hosts\fR file\.
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
\&\. {
|
|
hosts
|
|
}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
Load \fBexample\.hosts\fR file in the current directory\.
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
hosts example\.hosts
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
Load example\.hosts file and only serve example\.org and example\.net from it and fall through to the next plugin if query doesn\'t match\.
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
hosts example\.hosts example\.org example\.net {
|
|
fallthrough
|
|
}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
Load hosts file inlined in Corefile\.
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
hosts example\.hosts example\.org {
|
|
10\.0\.0\.1 example\.org
|
|
fallthrough
|
|
}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
|