0b4cbec0e9
The group was renamed during the development of Gluon v2017.1, adjust the documentation accordingly.
50 lines
2.6 KiB
ReStructuredText
50 lines
2.6 KiB
ReStructuredText
WAN support
|
|
===========
|
|
|
|
As the WAN port of a node will be connected to a user's private network, it
|
|
is essential that the node only uses the WAN when it is absolutely necessary.
|
|
There are two cases in which the WAN port is used:
|
|
|
|
* Mesh VPN (package ``gluon-mesh-vpn-fastd``
|
|
* DNS to resolve the VPN servers' addresses (package ``gluon-wan-dnsmasq``)
|
|
|
|
After the VPN connection has been established, the node should be able to reach
|
|
the mesh's DNS servers and use these for all other name resolution.
|
|
|
|
|
|
Routing tables
|
|
~~~~~~~~~~~~~~
|
|
As a node may get IPv6 default routes both over the WAN and the mesh, Gluon
|
|
uses two routing tables for IPv6. As all normal traffic should go over the mesh,
|
|
the mesh routes are added to the default table (table 0). All routes on the WAN interface
|
|
are put into table 1 (see ``/lib/gluon/upgrade/110-network`` in ``gluon-core``).
|
|
|
|
There is also an *ip -6 rule* which routes all IPv6 traffic with a packet mark with the
|
|
bit 1 set though table 1.
|
|
|
|
|
|
libpacketmark
|
|
~~~~~~~~~~~~~
|
|
*libpacketmark* is a library which can be loaded with ``LD_PRELOAD`` and will set the packet mark of all
|
|
sockets created by a process in accordance with the ``LIBPACKETMARK_MARK`` environment variable. This allows setting
|
|
the packet mark for processes which don't support this themselves. The process must run as root (or at least
|
|
with ``CAP_NET_ADMIN``) for this to work.
|
|
|
|
Unfortunately there's no nice way to set the packet mark via iptables for outgoing packets. The iptables will
|
|
run after the packet has been created, to even when the packet mark is changed and the packet is re-routed, the
|
|
source address won't be rewritten to the default source address of the newly chosen route. *libpacketmark* avoids
|
|
this issue as the packet mark will already be set when the packet is created.
|
|
|
|
gluon-wan-dnsmasq
|
|
~~~~~~~~~~~~~~~~~
|
|
To separate the DNS servers in the mesh from the ones on the WAN, the ``gluon-wan-dnsmasq`` package provides
|
|
a secondary DNS daemon which runs on ``127.0.0.1:54``. It will automatically use all DNS servers explicitly
|
|
configured in ``/etc/config/gluon-wan-dnsmasq`` or received via DNS/RA on the WAN port. It is important that
|
|
no DNS servers for the WAN interface are configured in ``/etc/config/network`` and that ``peerdns`` is set to 0
|
|
so the WAN DNS servers aren't leaked to the primary DNS daemon.
|
|
|
|
*libpacketmark* is used to make the secondary DNS daemon send its requests over the WAN interface.
|
|
|
|
The package ``gluon-mesh-vpn-fastd`` provides an iptables rule which will redirect all DNS requests from processes running
|
|
with the primary group ``gluon-mesh-vpn`` to ``127.0.0.1:54``, thus making fastd use the secondary DNS daemon.
|