mirror of
https://github.com/AdguardTeam/AdGuardHome.git
synced 2024-11-21 20:45:33 +03:00
Pull request: FAQ: add entry abt custom block pages
Merge in DNS/adguard-home-wiki from 3176-custom-block to master
Squashed commit of the following:
commit e1be9586f79ad1d11165c9d16d2adf29c6fc32a9
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date: Tue Dec 14 21:01:43 2021 +0300
FAQ: merge pixelserv section, imp examples
commit d862a802471ed6f871ba5fc98e96df8b8952e960
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date: Tue Dec 14 16:24:02 2021 +0300
FAQ: fix toc
commit db620821a290adaae08198f86c457a3c7939667b
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date: Tue Dec 14 16:19:19 2021 +0300
FAQ: fmt
commit ce9c977b83f17ebde6369afc05bb027866158ede
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date: Tue Dec 14 16:16:49 2021 +0300
FAQ: add entry abt custom block pages
Ainar Garipov
parent
edeb7a4a53
commit
87b9707c47
2 changed files with 109 additions and 44 deletions
104
FAQ.md
104
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:
|
|||
|
||||
|
||||
|
||||
<!-- There are still links to the #pixelsrv section which was merged into this
|
||||
one on the Internet, and Cool URIs Don't Change, so use an additional ID/name
|
||||
anchor into this header. -->
|
||||
|
||||
## <a href="#customblock" id="customblock" name="customblock"><span id="pixelsrv" name="pixelsrv"/>How to show a custom block page?</a>
|
||||
|
||||
### 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”.
|
||||
|
||||
|
||||
|
||||
## <a href="#webaddr" id="webaddr" name="webaddr">After installing AdGuard Home, how to change dashboard interface's address?</a>
|
||||
|
||||
1. Stop AdGuard Home:
|
||||
|
|
@ -215,26 +297,12 @@ and you won't need to configure each of them manually.
|
|||
|
||||
|
||||
|
||||
## <a href="#pixelsrv" id="pixelsrv" name="pixelsrv">How to configure AdGuard Home to run together with pixelsrv-tls?</a>
|
||||
|
||||
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”.
|
||||
|
||||
|
||||
|
||||
## <a id="limitations" name="limitations">Are there any known limitations?</a>
|
||||
## <a href="#limitations" id="limitations" name="limitations">Are there any known limitations?</a>
|
||||
|
||||
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`:
|
||||
|
|
|
|||
5
Home.md
5
Home.md
|
|
@ -1,6 +1,6 @@
|
|||
# AdGuard Home - Wiki
|
||||
|
||||
|
||||
<br/>
|
||||
<p align="center">
|
||||
<img src="https://cdn.adguard.com/public/Adguard/Common/adguard_home.svg" width="300px" alt="AdGuard Home" />
|
||||
</p>
|
||||
|
|
@ -8,13 +8,10 @@
|
|||
<p align="center">
|
||||
Free and open source, powerful network-wide ads & trackers blocking DNS server.
|
||||
</p>
|
||||
|
||||
<br/>
|
||||
|
||||
<p align="center">
|
||||
<img src="https://cdn.adguard.com/public/Adguard/Common/adguard_home.gif" width="800"/>
|
||||
</p>
|
||||
|
||||
<hr/>
|
||||
|
||||
Welcome to the AdGuard Home wiki!
|
||||
|
|
|
|||
Loading…
Reference in a new issue