Update DNS resolution docs

This commit is contained in:
Joey Hafner 2022-11-09 14:20:02 -08:00
parent ac266c16d3
commit fae1fb8bdf

View File

@ -2,21 +2,24 @@
graph TB; graph TB;
Upstream["dns.google (8.8.8.8; 8.8.4.4)"] Upstream["dns.google (8.8.8.8; 8.8.4.4)"]
Clients["Clients [192.168.1.0/24]"] Clients["Clients [192.168.1.0/24]"]
Router["VyOS Router [192.168.1.23]"] Router["VyOS Router [192.168.1.1]"]
PiHole["PiHole [192.168.1.23]"] PiHole["PiHole [192.168.1.22]"]
PiHole2["PiHole [192.168.1.21]"]
BlackHole["Black Hole"] BlackHole["Black Hole"]
Router --"Sends DHCP with DNS=192.168.1.23"--> Clients Router --"Sends DHCP with DNS=192.168.1.1"--> Clients
Clients --"First connect"--> Router Clients --"DNS Requests"--> Router
Clients --"Subsequent requests"--> PiHole Router --"Primary"--> PiHole
Router ----> PiHole Router --"Fallback"--> PiHole2
PiHole --"Blacklisted domains"--> BlackHole PiHole --"Blacklisted domains"--> BlackHole
PiHole2 --"Blacklisted domains"--> BlackHole
PiHole --"Valid requests"--> Upstream PiHole --"Valid requests"--> Upstream
PiHole2 --"Valid requests"--> Upstream
``` ```
Clients connecting to the local network for the first time will receive as part of the DHCP negotiation ([code 6](https://en.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol#Information)) the domain name server's address. This address will correspond to the IP address of the PiHole server (currently a RasPi at `192.168.1.23`). Clients connecting to the local network for the first time will receive as part of the DHCP negotiation ([code 6](https://en.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol#Information)) the domain name server's address. This address will correspond to the IP address of the router (`192.168.1.1`).
From that point, the client's DNS requests will go directly to the PiHole on an IP level. This means the PiHole will be able to track requests per-client. From that point, the client's DNS requests will go directly to the router. This means the PiHole will not be able to track requests per-client.
However, a client can be manually configured to request DNS resolution from the router, which will forward requests to the PiHole. However, a client can be manually configured to request DNS resolution directly from the Pihole.
DNS requests to the PiHole will be checked against the [configured adlists](https://pihole.jafner.net/groups-adlists.php). If matched, the request will be blocked. If a user is attempting to access a website that is blocked, the request should quickly resolve to a Domain Not Found error. It will look like this: DNS requests to the PiHole will be checked against the [configured adlists](https://pihole.jafner.net/groups-adlists.php). If matched, the request will be blocked. If a user is attempting to access a website that is blocked, the request should quickly resolve to a Domain Not Found error. It will look like this: