Pull request: add-h3

Merge in DNS/adguard-home-wiki from add-h3 to master

Squashed commit of the following:

commit 4112b34fc9a174c4cb8ca3794319fbab7dfd9629
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Tue Oct 4 15:36:42 2022 +0300

    Configuration: add http/3
Ainar Garipov 2022-10-04 15:57:03 +03:00
parent ba1ee9ed95
commit 938cfdc71a
1 changed files with 10 additions and 2 deletions

@ -87,6 +87,9 @@ Examples:
* `https://dns-unfiltered.adguard.com/dns-query`: encrypted [DNS-over-HTTPS]; * `https://dns-unfiltered.adguard.com/dns-query`: encrypted [DNS-over-HTTPS];
* `h3://dns-unfiltered.adguard.com/dns-query`: encrypted [DNS-over-HTTPS] with
forced [HTTP/3] and no fallback to HTTP/2 and below;
* `quic://dns-unfiltered.adguard.com`: encrypted [DNS-over-QUIC]; * `quic://dns-unfiltered.adguard.com`: encrypted [DNS-over-QUIC];
* `sdns://...`: [DNS Stamps] for [DNSCrypt] or [DNS-over-HTTPS] resolvers; * `sdns://...`: [DNS Stamps] for [DNSCrypt] or [DNS-over-HTTPS] resolvers;
@ -295,6 +298,7 @@ hostname resolution” setting in the “Upstream DNS servers” section or via
[DNS-over-QUIC]: https://datatracker.ietf.org/doc/html/rfc9250 [DNS-over-QUIC]: https://datatracker.ietf.org/doc/html/rfc9250
[DNS-over-TLS]: https://en.wikipedia.org/wiki/DNS_over_TLS [DNS-over-TLS]: https://en.wikipedia.org/wiki/DNS_over_TLS
[DNSCrypt]: https://dnscrypt.info/ [DNSCrypt]: https://dnscrypt.info/
[HTTP/3]: https://en.wikipedia.org/wiki/HTTP/3
[dnsmasq-man]: http://www.thekelleys.org.uk/dnsmasq/docs/dnsmasq-man.html [dnsmasq-man]: http://www.thekelleys.org.uk/dnsmasq/docs/dnsmasq-man.html
[private-ip]: https://tools.ietf.org/html/rfc6303 [private-ip]: https://tools.ietf.org/html/rfc6303
@ -413,6 +417,8 @@ Settings are stored in [YAML format](https://en.wikipedia.org/wiki/YAML), possib
- `fastest_timeout` (**since v0.107.0**) — The timeout used for dialing the - `fastest_timeout` (**since v0.107.0**) — The timeout used for dialing the
addresses while picking the fastest. Values other than positive ones are addresses while picking the fastest. Values other than positive ones are
replaced with the default one, `1s`. replaced with the default one, `1s`.
- `use_http3_upstreams` (**since v0.107.15**): Enables DNS-over-HTTP/3
for DNS-over-HTTPS upstreams that support it.
- **ECS settings** - **ECS settings**
- `edns_client_subnet` — Add EDNS Client Subnet (ECS) option to upstream - `edns_client_subnet` — Add EDNS Client Subnet (ECS) option to upstream
requests and log the values sent by the clients in the query log. Please requests and log the values sent by the clients in the query log. Please
@ -481,6 +487,8 @@ Settings are stored in [YAML format](https://en.wikipedia.org/wiki/YAML), possib
servers. Zero value will be rewritten with default one which is `10s`. servers. Zero value will be rewritten with default one which is `10s`.
- `resolve_clients` **(since v0.106.0):** Enable/disable resolving clients' - `resolve_clients` **(since v0.106.0):** Enable/disable resolving clients'
addresses by sending PTR requests. addresses by sending PTR requests.
- `serve_http3` (**since v0.107.15**): Enables DNS-over-HTTP/3 serving for
DNS-over-HTTPS clients as well as for the web UI.
- `filters` — List of filters, each filter has the following values: - `filters` — List of filters, each filter has the following values:
- `enabled` — Current filter's status (enabled/disabled). - `enabled` — Current filter's status (enabled/disabled).
- `url` — URL pointing to the filter contents (filtering rules). - `url` — URL pointing to the filter contents (filtering rules).