Skip to content

Commit 3f06b95

Browse files
committed
docs: explain the IPv6 default and how to test for a leak
VPN_ALLOWED_IPS keeps ::/0 while the stack itself carries IPv4 only, and nothing said why. The value is deliberate: IPv6 traffic enters the tunnel and stops there, so a client falls back to IPv4 instead of sending IPv6 around the VPN and exposing its real address. Say that plainly, warn against removing the value as a speed fix, and give the steps to verify a client with a leak test and the Pi-hole query log.
1 parent 615c852 commit 3f06b95

1 file changed

Lines changed: 22 additions & 0 deletions

File tree

README.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -210,6 +210,28 @@ VPN_ALLOWED_IPS=10.2.0.0/24
210210
The clients that exist already do not change. Make a new client after a
211211
change, or edit the client in the web interface.
212212

213+
### IPv6 and DNS leaks
214+
215+
The default value contains `::/0`. This stack carries IPv4 traffic only.
216+
Therefore the IPv6 traffic of a client goes into the tunnel and stops there.
217+
218+
This behaviour is correct and safe. A client with IPv6 tries IPv6 first,
219+
receives no answer, and then uses IPv4 through the VPN. Your real address
220+
stays secret.
221+
222+
Do not remove `::/0` to make IPv6 faster. Without this value, the client
223+
sends the IPv6 traffic outside the tunnel. Then a website sees your real
224+
address, and the DNS queries do not reach Pi-hole. Disable IPv6 on the
225+
client if you do not want the small delay.
226+
227+
Test your VPN with these steps:
228+
229+
1. Connect a client to the VPN.
230+
2. Open https://dnsleaktest.com and start the standard test.
231+
3. The test must show one server only. The server must be your own server.
232+
4. Open the Pi-hole page and look at the query log. The log must show the
233+
queries of your client.
234+
213235
## Configuration
214236

215237
All settings are in the file `.env`. The file `.env.example` describes each

0 commit comments

Comments
 (0)