release/src/router/openvpn/README.IPv6

   1 Since 2.3.0, OpenVPN officially supports IPv6, and all widely used
   2 patches floating around for older versions have been integrated.
   3
   4 IPv6 payload support
   5 --------------------
   6
   7 This is for "IPv6 inside OpenVPN", with server-pushed IPv6 configuration
   8 on the client, and support for IPv6 configuration on the tun/tap interface
   9 from within the openvpn config.
  10
  11 The code in 2.3.0 supersedes the IPv6 payload patches from Gert Doering,
  12 formerly located at http://www.greenie.net/ipv6/openvpn.html
  13
  14
  15 The following options have been added to handle IPv6 configuration,
  16 analogous to their IPv4 counterparts (--server <-> --server-ipv6, etc.)
  17
  18      - server-ipv6
  19      - ifconfig-ipv6
  20      - ifconfig-ipv6-pool
  21      - ifconfig-ipv6-push
  22      - route-ipv6
  23      - iroute-ipv6
  24
  25 see "man openvpn" for details how they are used.
  26
  27
  28
  29 IPv6 transport support
  30 ----------------------
  31
  32 This is to enable OpenVPN peers or client/servers to talk to each other
  33 over an IPv6 network ("OpenVPN over IPv6").
  34
  35 The code in 2.3.0 supersedes the IPv6 transport patches from JuanJo Ciarlante,
  36 formerly located at http://github.com/jjo/openvpn-ipv6
  37
  38
  39 Use the following options to select IPv6 transport:
  40
  41   --proto udp6
  42   --proto tcp6-client
  43   --proto tcp6-server
  44   --proto tcp6 --client / --proto tcp6 --server
  45
  46 On systems that permit IPv4 connections on IPv6 sockets (Linux by
  47 default, FreeBSD and NetBSD if you turn off the "v6only" sysctl by
  48 running "sysctl -w net.inet6.ip6.v6only=0"), an OpenVPN server can
  49 handle IPv4 connections on the IPv6 socket as well, making it a true
  50 dual-stacked server.
  51
  52 On other systems, as of 2.3.0, you need to run separate server instances
  53 for IPv4 and IPv6.
  54
  55 The client side code is not really "dual-stacked" yet, as it does not
  56 automatically try both address families when connecting to a dual-stacked
  57 server.  For now, you can achieve this with <connection> stanzas in your
  58 openvpn config:
  59
  60   <connection>
  61      remote my.dual.stack.server 1194 udp6
  62   </connection>
  63   <connection>
  64      remote my.dual.stack.server 1194 udp
  65   </connection>