Pull request 175: imp-conf
Squashed commit of the following: commit 861bf10a0b1ed49fc96ef9e3fdfe5f348a739b66 Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Fri Jul 14 22:06:23 2023 +0300 Configuration: imp docs
parent
6414132741
commit
8a03388ec8
|
@ -151,9 +151,10 @@ a configuration like this:
|
||||||
sends queries for `*.host.com` to `1.2.3.4` except for queries for
|
sends queries for `*.host.com` to `1.2.3.4` except for queries for
|
||||||
`*.www.host.com`, which are sent to `6.7.8.9`, which is the default upstream.
|
`*.www.host.com`, which are sent to `6.7.8.9`, which is the default upstream.
|
||||||
|
|
||||||
Since **v0.108.0-b.8** the wildcard `*` has a special meaning of "any subdomain",
|
Since **v0.108.0-b.8** the wildcard `*` has a special meaning of "any
|
||||||
so `--upstream=[/*.host.com/]1.2.3.4` will send queries for `*.host.com` to `1.2.3.4`,
|
subdomain", so `--upstream=[/*.host.com/]1.2.3.4` will send queries for
|
||||||
but `host.com` will be forwarded to default upstreams.
|
`*.host.com` to `1.2.3.4`, but `host.com` will be forwarded to default
|
||||||
|
upstreams.
|
||||||
|
|
||||||
#### Examples
|
#### Examples
|
||||||
|
|
||||||
|
@ -501,7 +502,7 @@ Settings are stored in [YAML format](https://en.wikipedia.org/wiki/YAML), possib
|
||||||
- `allowed_clients`: The list of CIDRs, IP addresses or ClientIDs of allowed
|
- `allowed_clients`: The list of CIDRs, IP addresses or ClientIDs of allowed
|
||||||
DNS clients. If this list has entries, AdGuard Home will accept requests
|
DNS clients. If this list has entries, AdGuard Home will accept requests
|
||||||
only from these clients.
|
only from these clients.
|
||||||
|
|
||||||
See also the note in the [Docker wiki page][docker-conf] about using this
|
See also the note in the [Docker wiki page][docker-conf] about using this
|
||||||
property within a container.
|
property within a container.
|
||||||
|
|
||||||
|
@ -509,14 +510,14 @@ Settings are stored in [YAML format](https://en.wikipedia.org/wiki/YAML), possib
|
||||||
disallowed DNS clients. If this list has entries, AdGuard Home will drop
|
disallowed DNS clients. If this list has entries, AdGuard Home will drop
|
||||||
requests from these clients. Note that this field is ignored if there are
|
requests from these clients. Note that this field is ignored if there are
|
||||||
entries in `allowed_clients`.
|
entries in `allowed_clients`.
|
||||||
|
|
||||||
See also the note in the [Docker wiki page][docker-conf] about using this
|
See also the note in the [Docker wiki page][docker-conf] about using this
|
||||||
property within a container.
|
property within a container.
|
||||||
|
|
||||||
- `blocked_hosts`: The list of domain names, wildcards or filtering rules to
|
- `blocked_hosts`: The list of domain names, wildcards or filtering rules to
|
||||||
match requests that shouldn't be processed at all. These wiil be ignored
|
match requests that shouldn't be processed at all. These are ignored by
|
||||||
by statistics and query log as well.
|
statistics and query log as well.
|
||||||
|
|
||||||
See also the note in the [Docker wiki page][docker-conf] about using this
|
See also the note in the [Docker wiki page][docker-conf] about using this
|
||||||
property within a container.
|
property within a container.
|
||||||
|
|
||||||
|
@ -581,7 +582,7 @@ Settings are stored in [YAML format](https://en.wikipedia.org/wiki/YAML), possib
|
||||||
addresses by sending PTR requests.
|
addresses by sending PTR requests.
|
||||||
- `serve_http3` (**since v0.107.15**): Enables DNS-over-HTTP/3 serving for
|
- `serve_http3` (**since v0.107.15**): Enables DNS-over-HTTP/3 serving for
|
||||||
DNS-over-HTTPS clients as well as for the web UI.
|
DNS-over-HTTPS clients as well as for the web UI.
|
||||||
- `theme` (**since v0.107.22**): The theme of UI. The possible values are:
|
- `theme` (**since v0.107.22**): The theme of UI. The possible values are:
|
||||||
`auto`, `dark`, `light`.
|
`auto`, `dark`, `light`.
|
||||||
- `querylog` (**since v0.107.24**) — Query log settings section:
|
- `querylog` (**since v0.107.24**) — Query log settings section:
|
||||||
- `enabled`: Query log status.
|
- `enabled`: Query log status.
|
||||||
|
@ -686,19 +687,18 @@ Settings are stored in [YAML format](https://en.wikipedia.org/wiki/YAML), possib
|
||||||
- `log` (**since v0.107.34**): Log settings.
|
- `log` (**since v0.107.34**): Log settings.
|
||||||
- `file` (**since v0.107.34**): Path to the log file. If empty, writes to
|
- `file` (**since v0.107.34**): Path to the log file. If empty, writes to
|
||||||
stdout, if `syslog` writes system log (or eventlog on Windows).
|
stdout, if `syslog` writes system log (or eventlog on Windows).
|
||||||
- `compress` (**since v0.107.34**): Compress determines if the rotated log
|
- `compress` (**since v0.107.34**): If `true`, enabled GZIP compression of
|
||||||
files should be compressed using gzip (default: false).
|
the log files.
|
||||||
- `local_time` (**since v0.107.34**): If the time used for formatting the
|
- `local_time` (**since v0.107.34**): If `true`, the time used for
|
||||||
timestamps in is the computer's local time (default: false [UTC]).
|
formatting the timestamps in is the computer's local time.
|
||||||
- `max_backups` (**since v0.107.34**): Maximum number of old log files to
|
- `max_backups` (**since v0.107.34**): Maximum number of old log files to
|
||||||
retain (MaxAge may still cause them to get deleted) (default: 0, which
|
retain. `0` means retain all old log files. Note that `max_age` may
|
||||||
retains all old log files).
|
still cause them to be deleted.
|
||||||
- `max_size` (**since v0.107.34**): Maximum size in megabytes of the log
|
- `max_size` (**since v0.107.34**): Maximum size of the log file before it
|
||||||
file before it gets rotated (default: 100 MB).
|
gets rotated, in megabytes.
|
||||||
- `max_age` (**since v0.107.34**): MaxAge is the maximum number of days to
|
- `max_age` (**since v0.107.34**): MaxAge is the maximum number of days to
|
||||||
retain old log files (default: 3).
|
retain old log files.
|
||||||
- `verbose` (**since v0.107.34**): Enable our disables debug verbose output
|
- `verbose` (**since v0.107.34**): If `true`, enables verbose debug output.
|
||||||
(default: false).
|
|
||||||
- `log_file` (**before v0.107.34**): See `log.file` above.
|
- `log_file` (**before v0.107.34**): See `log.file` above.
|
||||||
- `log_compress` (**before v0.107.34**): See `log.compress` above.
|
- `log_compress` (**before v0.107.34**): See `log.compress` above.
|
||||||
- `log_localtime` (**before v0.107.34**): See `log.local_time` above.
|
- `log_localtime` (**before v0.107.34**): See `log.local_time` above.
|
||||||
|
|
Loading…
Reference in New Issue