Pi-Hole/docs
1
0
Fork 0
mirror of https://github.com/pi-hole/docs.git synced 2026-05-27 11:05:30 +01:00
Code Issues Packages Projects Releases Wiki Activity

Rewrote English guide in one flow, added info about advances settings and conditional forwarding

Browse Source 
Signed-off-by: yubiuser <ckoenig@posteo.de>
This commit is contained in:
yubiuser
2021-01-13 20:51:06 +01:00
parent f2224ca9b9
commit e88efa8339
3 changed files with 49 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/images/fritzbox-advanced.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.9 KiB

docs/routers/fritzbox-de.md
+1 -1
View File
@@ -46,7 +46,7 @@ Mit dieser Konfiguration wird Pi-hole auch von der Fritz!Box selbst als Upstrea
(Clients) -> Fritz!Box -> Pi-hole -> Upstream DNS Server
```
Zum Einstellen muss die IP des Pi-hole als "Bevorzugter DNS-Server" **und** "Alternativer DNS-Server" in
Zum Einstellen muss die IP des Pi-hole als "Bevorzugter DNSv4-Server" **und** "Alternativer DNSv4-Server" in
```bash
Internet/Zugangsdaten/DNS-Server
docs/routers/fritzbox.md
+48 -34
View File
@@ -1,43 +1,27 @@
This guide was developed using FRITZ!OS 07.21 but should work for others too. It aims to line out a few basic principles to have a seamless DNS experience with Pi-hole and Fritz!Boxes .
This guide was developed using FRITZ!OS 07.21 but should work for others too. It aims to line out a few basic principles to have a seamless DNS experience with Pi-hole and Fritz!Boxes.
> Note:
There is no single way to do it right. Choose the one best fitting your needs.
This guide is IPv4 only. You need to adjust for IPv6 accordingly
This guide is IPv4 only. You need to adjust for IPv6 accordingly.
## 1) Using Pi-hole as upstream DNS server for your Fritz!Box
### Enable advanced settings
Using this configuration, Pi-hole is used for all devices within your network including the Fritz!Box itself. DNS requests are sent in this order
Some of the the follwowing settings might be visible only if advanced settings are enabled. Therefore, "View" has to be changed to advanced by clicking on "Standard" in the lower left corner.
```bash
Client -> Fritz!Box -> Pi-hole -> Upstream DNS Server
```
![Screenshot der Fritz!Box DHCP Einstellungen](../images/fritzbox-advanced.png)
To set it up, enter Pi-hole's IP as "Preferred DNS server" **and** "Alternative DNS server" in
```bash
Internet/Account Information/DNS server
```
![Screenshot of Fritz!Box WAN DNS Configuration](../images/fritzbox-wan-dns.png)
!!! warning
Don't set the Fitz!Box as upstrem DNS server for Pi-hole! This will lead to a DNS loop as the Pi-hole will send the queries to the Fritz!Box which in turn will send the to Pi-hole.
With this configuration, you won't see individual clients in Pi-hole's dashboard. For Pi-hole, all queries will appear as if they are coming from your Fritz!Box. You will therefore miss out on some features, e.g. Group Management. This can be solved using method #2.
## 2) Distribute Pi-hole as DNS server via DHCP
## Distribute Pi-hole as DNS server via DHCP
Using this configuration, all clients will get Pi-hole's IP offered as DNS server when they request a DHCP lease from your Fritz!Box.
DNS requests are sent in this order
DNS queries take the following path
```bash
Client -> Pi-hole -> Upstream DNS Server
```
> Note:
The Fritz!Box itself will use whatever is configured in Internet/Account Information/DNS server.
The Fritz!Box can be Pi-hole's upstream DNS server, as long Pi-hole itself is not the upstream server for the Fritz!Box. This would cause a DNS loop.
The Fritz!Box itself will use whatever is configured in Internet/Account Information/DNS server (see below).
The Fritz!Box can be Pi-hole's upstream DNS server, as long Pi-hole itself is not the upstream server of the Fritz!Box. This would cause a DNS loop.
To set it up, enter Pi-hole's IP as "Local DNS server" in
@@ -48,27 +32,57 @@ Home Network/Network/Network Settings/IP Adresses/IPv4 Configuration/Home Networ
![Screenshot of Fritz!Box DHCP Settings](../images/fritzbox-dhcp.png)
>Note:
Clients will notice changes in DHCP settings only after they acquire a new DHCP lease. The easiest way to force a renewal is to dis/reconnect the client from the network.
Clients will notice changes in DHCP settings only after they acquired a new DHCP lease. The easiest way to force a renewal is to dis/reconnect the client from the network.
You should see individual clients in Pi-hole's web dashboard.
Now you should see individual clients in Pi-hole's web dashboard.
## 3) Combining 1) and 2)
You can combine 1) and 2) which will let all clients send DNS requests to your Pi-hole **and** the Fritz!Box itself as well.
## Pi-hole as upstream DNS server for your Fritz!Box
With this configuration, Pi-hole is also used by the Fritz!Box itself as an upstream DNS server. DNS queries take the following path
```bash
Client (incl. Fritz!Box) -> Pi-hole -> Upstream DNS Server
(Clients) -> Fritz!Box -> Pi-hole -> Upstream DNS Server
```
To set it up, enter Pi-hole's IP as "Preferred DNSv4 server" **and** "Alternative DNSv4 server" in
```bash
Internet/Account Information/DNS server
```
![Screenshot of Fritz!Box WAN DNS Configuration](../images/fritzbox-wan-dns.png)
!!! warning
Don't set the Fritz!Box as upstrem DNS server for Pi-hole! This will lead to a DNS loop as the Pi-hole will send the queries to the Fritz!Box which in turn will send the to Pi-hole
Don't set the Fitz!Box as upstrem DNS server for Pi-hole if using this configuration! This will lead to a DNS loop as the Pi-hole will send the queries to the Fritz!Box which in turn will send them to Pi-hole.
## Using Pi-hole within the Guest Network
If only this configuration is used, you won't see individual clients in Pi-hole's dashboard. For Pi-hole, all queries will appear as if they are coming from your Fritz!Box. You will therefore miss out on some features, e.g. Group Management. If you want to use them, Pi-hole must (additionally) be distributed to the clients as DNS server via DHCP (see above).
You may have noticed, that there is no option to set the DNS server for the guest network in
### Using Pi-hole within the Guest Network
There is no option to set the DNS server for the guest network in
```bash
Home Network/Network/Network Settings/IP Adresses/IPv4 Configuration/Guest Network
```
The Fritz!Box always sets its own IP as DNS server for the guest network. To filter its traffic, you have to setup Pi-hole as upstream DNS server for your Fritz!Box (see #1). As there is no other option, all DNS requests from your guest network will appear as coming from your Fritz!Box.
The Fritz!Box always sets its own IP as DNS server for the guest network. To filter its traffic, you have to setup Pi-hole as upstream DNS server for your Fritz!Box. As there is no other option, all DNS requests from your guest network will appear as coming from your Fritz!Box. Individual filtering per client within the guest network is therefore not possible.
## Hostnames instead of IP addresses in Pi-hole's web interface - Conditional forwarding
In case the Fritz!Box is used as DHCP server, client's hostames are registered only there. By default, Pi-hole tries to resolve the IP addresses of the clients back into host names. Therefore, the requests must reach the Fritz!Box.
There are two ways to do this:
* The Fritz!Box is the upstream DNS server of the Pi-hole. This means that all queries end up with the Fritz!Box anyway, which can send the host names back to Pi-hole.
!!! warning
The Fritz!Box may only be the upstream DNS server of the Pi-hole if Pi-hole is not the upstream DNS server of the Fritz!Box. This would lead to a DNS loop.
* Only those queries are sent to the Fritz!Box that attempt to determine hostnames for IP addresses (clients) of the local network. All other requests are sent to the upstream DNS server of the Pi-Hole. The *Conditional forwarding* option is responsible for this.
The following settings must be made:
* **Local network in CIDR notation:** Standard IP range of the Fritz!Box is **192.168.178.0/24**
* **IP address of your DHCP server (router):** IP of the Fritz!Box, standard is **192.168.178.1**
* **Local domain name (optional):** Fritz!Box uses **fritz.box**
![Screenshot der Conditional Forwarding Einstellungen](../images/conditional-forwarding.png)