From 3d75334d43e50800dbc17fabceec798497fc039a Mon Sep 17 00:00:00 2001
From: Ainar Garipov <a.garipov@adguard.com>
Date: Tue, 10 Aug 2021 12:38:48 +0300
Subject: [PATCH] Pull request: Hosts-Blocklists: mention upstream bug
Merge in DNS/adguard-home-wiki from ups-file to master
Squashed commit of the following:
commit ae5edb6af9d660f89adcf77a5551ddf2a7d917c8
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date: Mon Aug 9 21:22:12 2021 +0300
Hosts-Blocklists: mention upstream bug
---
Configuration.md | 6 ++++++
Hosts-Blocklists.md | 4 ++--
2 files changed, 8 insertions(+), 2 deletions(-)
diff --git a/Configuration.md b/Configuration.md
index 1ca5932..aec4662 100644
--- a/Configuration.md
+++ b/Configuration.md
@@ -169,6 +169,11 @@ may want to load them from a separate file instead of setting all upstreams in
AdGuard Home settings. To do that, simply specify the path to a file with your
list in the `upstream_dns_file` field of `AdGuardHome.yaml`.
+**BUG:** The file, just like the input in the web interface, currently doesn't
+accept internationalized domain names (e.g. `пример.рф` or `例子.中国`). As
+a workaround, convert them to Punycode (e.g. `xn--e1afmkfd.xn--p1ai` or
+`xn--fsqu00a.xn--fiqs8s` respectively). See [issue 2915][2915].
+
### <a href="#upstreams-for-rdns" id="upstreams-for-rdns" name="upstreams-for-rdns">Specifying Upstreams For Reverse DNS</a>
Using the domain-specific upstream notation, you can specify dedicated upstream
@@ -249,6 +254,7 @@ Since **v0.106.0** you can enable and disable this feature with “Enable client
hostname resolution” setting in the “Upstream DNS servers” section or via the
`resolve_clients` field in the configuration file.
+[2915]: https://github.com/AdguardTeam/AdGuardHome/issues/2915
[DNS Stamps]: https://dnscrypt.info/stamps/
[DNS-over-HTTPS]: https://en.wikipedia.org/wiki/DNS_over_HTTPS
[DNS-over-QUIC]: https://datatracker.ietf.org/doc/html/draft-ietf-dprive-dnsoquic-03
diff --git a/Hosts-Blocklists.md b/Hosts-Blocklists.md
index 3e45390..9ca5914 100644
--- a/Hosts-Blocklists.md
+++ b/Hosts-Blocklists.md
@@ -316,8 +316,8 @@ $dnstype=value2
* `||example.org^$dnstype=AAAA`: block DNS queries for the IPv6 addresses of
`example.org`.
- * `||example.org^$dnstype=~A|~CNAME`: only allow `A` and `CNAME` DNS queries for
- `example.org`, block out the rest.
+ * `||example.org^$dnstype=~A|~CNAME`: only allow `A` and `CNAME` DNS queries
+ for `example.org`, block out the rest.
#### <a href="#dnsrewrite" id="dnsrewrite" name="dnsrewrite">`dnsrewrite`</a>