diff --git a/FAQ.md b/FAQ.md index aee29a6..66429a8 100644 --- a/FAQ.md +++ b/FAQ.md @@ -2,9 +2,9 @@ * [Why AdGuard Home doesn't block ads?](#doesntblock) * [How to configure AdGuard Home to write verbose-level logs](#verboselog) + * [How to show a custom block page](#customblock) * [After installing AdGuard Home, how to change dashboard interface's address?](#webaddr) * [How to set up AdGuard Home as default DNS server?](#defaultdns) - * [How to configure AdGuard Home to run together with pixelsrv-tls?](#pixelsrv) * [Are there any known limitations?](#limitations) * [Why am I getting "bind: address already in use" error when trying to install on Ubuntu?](#bindinuse) * [How to configure a reverse proxy server for AdGuard Home?](#reverseproxy) @@ -98,6 +98,88 @@ required. Here's how to enable it: + + +## How to show a custom block page? + + ### A note about HTTPS + +Before doing any of this, please note that modern browsers are set up to use +HTTPS, and so they validate the certificate of the web server they're trying to +reach for authenticity. That means that using any of these will result in +warning screens. + +There are a couple of proposed extensions that, when they become reasonably well +supported by clients, would allow for a better user experience, including the +[RFC 8914 Extended DNS Error codes][rfc8914] and the [DNS Access Denied Error +Page RFC draft][rfcaccess]. We'll implement them when browsers actually start +to support them. + +[rfc8914]: https://datatracker.ietf.org/doc/html/rfc8914 +[rfcaccess]: https://datatracker.ietf.org/doc/html/draft-reddy-dnsop-error-page-08 + + + + ### Prerequisites + +To use any of these ways to show a custom block page, you'll need an HTTP server +running on some IP address and serving the page in question on all routes. +Something like [`pixelserv-tls`][pxsrv]. + +[pxsrv]: https://github.com/kvic-z/pixelserv-tls + + + + ### Custom block page for parental control and safe browsing filters + +There is currently no way to set these parameters from the UI, so you'll need to +edit the configuration file manually: + +1. Stop AdGuard Home: + + ```sh + ./AdGuardHome -s stop + ``` + +1. Open `AdGuardHome.yaml` in your editor. + +1. Set the `dns.parental_block_host` or `dns.safebrowsing_block_host` settings + to the IP address of the server (in this example, `192.168.123.45`): + + ```yaml + # … + dns: + # … + + # NOTE: Change to the actual IP address of your server. + parental_block_host: 192.168.123.45 + safebrowsing_block_host: 192.168.123.45 + ``` + +1. Restart AdGuard Home: + + ```sh + ./AdGuardHome -s start + ``` + + + + ### Custom block page for other filters + +1. Open the web UI. + +1. Open the “Settings → DNS settings” page. + +1. In the “DNS server configuration” section, select the “Custom IP” radio + button in the “Blocking mode” selector and enter the IPv4 and IPv6 addresses + of the server. + +1. Click “Save”. + + + ## After installing AdGuard Home, how to change dashboard interface's address? 1. Stop AdGuard Home: @@ -215,26 +297,12 @@ and you won't need to configure each of them manually. -## How to configure AdGuard Home to run together with pixelsrv-tls? - -1. Open the web UI. - -1. Go to “Settings → DNS settings”. - -1. Scroll to the “DNS server configuration” section. - -1. For the “Blocking mode” setting select the “Custom IP” radio button and - enter the IP address of the pixelsrv-tls instance. - -1. Click “Save”. - - - -## Are there any known limitations? +## Are there any known limitations? Here are some examples of what cannot be blocked by a DNS-level blocker: * YouTube, Twitch ads. + * Facebook, Twitter, Instagram sponsored posts. Essentially, any advertising that shares a domain with content cannot be blocked @@ -291,7 +359,7 @@ yourself by following these steps: ```sh sudo mv /etc/resolv.conf /etc/resolv.conf.backup - ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf + sudo ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf ``` 1. Restart `DNSStubListener`: diff --git a/Home.md b/Home.md index 22fdf6f..c1db7d0 100644 --- a/Home.md +++ b/Home.md @@ -1,38 +1,35 @@ - # AdGuard Home - Wiki + # AdGuard Home - Wiki -  +

- AdGuard Home + AdGuard Home

Privacy protection center for you and your devices

- Free and open source, powerful network-wide ads & trackers blocking DNS server. + Free and open source, powerful network-wide ads & trackers blocking DNS server.

- -
- +

- +

- -
+
Welcome to the AdGuard Home wiki! -## Guides +## Guides -* [Getting Started](Getting-Started) - * [FAQ](FAQ) - * [How to Write Hosts Blocklists](Hosts-Blocklists) - * [Comparing AdGuard Home to Other Solutions](Comparison) -* Configuring AdGuard - * [Configuration](Configuration) - * [Configuring AdGuard Home Clients](Clients) - * [AdGuard Home as a DoH, DoT, or DoQ Server](Encryption) - * [AdGuard Home as a DNSCrypt Server](DNSCrypt) - * [AdGuard Home as a DHCP Server](DHCP) -* Installing AdGuard Home - * [Docker](Docker) - * [How to Install and Run AdGuard Home on a Raspberry Pi](Raspberry-Pi) - * [How to Install and Run AdGuard Home on a Virtual Private Server](VPS) -* [Verifying Releases](Verify-Releases) + * [Getting Started](Getting-Started) + * [FAQ](FAQ) + * [How to Write Hosts Blocklists](Hosts-Blocklists) + * [Comparing AdGuard Home to Other Solutions](Comparison) + * Configuring AdGuard + * [Configuration](Configuration) + * [Configuring AdGuard Home Clients](Clients) + * [AdGuard Home as a DoH, DoT, or DoQ Server](Encryption) + * [AdGuard Home as a DNSCrypt Server](DNSCrypt) + * [AdGuard Home as a DHCP Server](DHCP) + * Installing AdGuard Home + * [Docker](Docker) + * [How to Install and Run AdGuard Home on a Raspberry Pi](Raspberry-Pi) + * [How to Install and Run AdGuard Home on a Virtual Private Server](VPS) + * [Verifying Releases](Verify-Releases)