mirror of
https://github.com/AdguardTeam/AdGuardHome.git
synced 2024-11-29 02:18:51 +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)
|
* [Why AdGuard Home doesn't block ads?](#doesntblock)
|
||||||
* [How to configure AdGuard Home to write verbose-level logs](#verboselog)
|
* [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)
|
* [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 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)
|
* [Are there any known limitations?](#limitations)
|
||||||
* [Why am I getting "bind: address already in use" error when trying to install on Ubuntu?](#bindinuse)
|
* [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)
|
* [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>
|
## <a href="#webaddr" id="webaddr" name="webaddr">After installing AdGuard Home, how to change dashboard interface's address?</a>
|
||||||
|
|
||||||
1. Stop AdGuard Home:
|
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>
|
## <a href="#limitations" id="limitations" name="limitations">Are there any known limitations?</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>
|
|
||||||
|
|
||||||
Here are some examples of what cannot be blocked by a DNS-level blocker:
|
Here are some examples of what cannot be blocked by a DNS-level blocker:
|
||||||
|
|
||||||
* YouTube, Twitch ads.
|
* YouTube, Twitch ads.
|
||||||
|
|
||||||
* Facebook, Twitter, Instagram sponsored posts.
|
* Facebook, Twitter, Instagram sponsored posts.
|
||||||
|
|
||||||
Essentially, any advertising that shares a domain with content cannot be blocked
|
Essentially, any advertising that shares a domain with content cannot be blocked
|
||||||
|
|
@ -291,7 +359,7 @@ yourself by following these steps:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
sudo mv /etc/resolv.conf /etc/resolv.conf.backup
|
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`:
|
1. Restart `DNSStubListener`:
|
||||||
|
|
|
||||||
49
Home.md
49
Home.md
|
|
@ -1,38 +1,35 @@
|
||||||
# AdGuard Home - Wiki
|
# AdGuard Home - Wiki
|
||||||
|
|
||||||
|
<br/>
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="https://cdn.adguard.com/public/Adguard/Common/adguard_home.svg" width="300px" alt="AdGuard Home" />
|
<img src="https://cdn.adguard.com/public/Adguard/Common/adguard_home.svg" width="300px" alt="AdGuard Home" />
|
||||||
</p>
|
</p>
|
||||||
<h3 align="center">Privacy protection center for you and your devices</h3>
|
<h3 align="center">Privacy protection center for you and your devices</h3>
|
||||||
<p align="center">
|
<p align="center">
|
||||||
Free and open source, powerful network-wide ads & trackers blocking DNS server.
|
Free and open source, powerful network-wide ads & trackers blocking DNS server.
|
||||||
</p>
|
</p>
|
||||||
|
<br/>
|
||||||
<br />
|
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="https://cdn.adguard.com/public/Adguard/Common/adguard_home.gif" width="800" />
|
<img src="https://cdn.adguard.com/public/Adguard/Common/adguard_home.gif" width="800"/>
|
||||||
</p>
|
</p>
|
||||||
|
<hr/>
|
||||||
<hr />
|
|
||||||
|
|
||||||
Welcome to the AdGuard Home wiki!
|
Welcome to the AdGuard Home wiki!
|
||||||
|
|
||||||
## Guides
|
## Guides
|
||||||
|
|
||||||
* [Getting Started](Getting-Started)
|
* [Getting Started](Getting-Started)
|
||||||
* [FAQ](FAQ)
|
* [FAQ](FAQ)
|
||||||
* [How to Write Hosts Blocklists](Hosts-Blocklists)
|
* [How to Write Hosts Blocklists](Hosts-Blocklists)
|
||||||
* [Comparing AdGuard Home to Other Solutions](Comparison)
|
* [Comparing AdGuard Home to Other Solutions](Comparison)
|
||||||
* Configuring AdGuard
|
* Configuring AdGuard
|
||||||
* [Configuration](Configuration)
|
* [Configuration](Configuration)
|
||||||
* [Configuring AdGuard Home Clients](Clients)
|
* [Configuring AdGuard Home Clients](Clients)
|
||||||
* [AdGuard Home as a DoH, DoT, or DoQ Server](Encryption)
|
* [AdGuard Home as a DoH, DoT, or DoQ Server](Encryption)
|
||||||
* [AdGuard Home as a DNSCrypt Server](DNSCrypt)
|
* [AdGuard Home as a DNSCrypt Server](DNSCrypt)
|
||||||
* [AdGuard Home as a DHCP Server](DHCP)
|
* [AdGuard Home as a DHCP Server](DHCP)
|
||||||
* Installing AdGuard Home
|
* Installing AdGuard Home
|
||||||
* [Docker](Docker)
|
* [Docker](Docker)
|
||||||
* [How to Install and Run AdGuard Home on a Raspberry Pi](Raspberry-Pi)
|
* [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)
|
* [How to Install and Run AdGuard Home on a Virtual Private Server](VPS)
|
||||||
* [Verifying Releases](Verify-Releases)
|
* [Verifying Releases](Verify-Releases)
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue