Browse code

Clarify --block-ipv6 intent and direction.

--block-ipv6 is a fairly special-purpose option, and only blocks packet
in the client->server direction. This is implied by not ever mentioning
the other direction in the existing documentation, but not written down.

Make this explicit, avoid confusion.

Also, point why this option exist (avoid IPv6 leakage from dual-stacked
clients around IPv4-only VPN offerings).

Trac: #1351

Signed-off-by: Gert Doering <gert@greenie.muc.de>
Acked-by: Richard Bonhomme <tincanteksup@gmail.com>
Message-Id: <20201225164214.22771-1-gert@greenie.muc.de>
URL: https://www.mail-archive.com/openvpn-devel@lists.sourceforge.net/msg21407.html
Signed-off-by: Gert Doering <gert@greenie.muc.de>

Gert Doering authored on 2020/12/26 01:42:14
Showing 1 changed files
... ...
@@ -21,7 +21,8 @@ routing.
21 21
   For this option to make sense you actually have to route traffic to the
22 22
   tun interface. The following example config block would send all IPv6
23 23
   traffic to OpenVPN and answer all requests with no route to host,
24
-  effectively blocking IPv6.
24
+  effectively blocking IPv6 (to avoid IPv6 connections from dual-stacked
25
+  clients leaking around IPv4-only VPN services).
25 26
 
26 27
   **Client config**
27 28
     ::
... ...
@@ -38,6 +39,12 @@ routing.
38 38
        --push "redirect-gateway ipv6"
39 39
        --block-ipv6
40 40
 
41
+  Note: this option does not influence traffic sent from the server
42
+  towards the client (neither on the server nor on the client side).
43
+  This is not seen as necessary, as such traffic can be most easily
44
+  avoided by not configuring IPv6 on the server tun, or setting up a
45
+  server-side firewall rule.
46
+
41 47
 --dev device
42 48
   TUN/TAP virtual network device which can be :code:`tunX`, :code:`tapX`,
43 49
   :code:`null` or an arbitrary name string (:code:`X` can be omitted for