3d6cd44629
The client package allows to create a new wifi interface with direct access to the local Freifunk network but with alternative exit gateways for internet connectivity. A custom ESSID can be chosen. The provider package is the counterpart to the client package and configures the firewall of the selected Gluon node to grant permission to route packets between the client and wan zone. Note that the Gluon Alt-ESC provider package is not mandatory for the Gluon Alt-ESC client package. In fact, any client device in the mesh network can be chosen and configured to provide internet access for the Alt-ESC client package. Signed-off-by: Linus Lüssing <linus.luessing@c0d3.blue>
42 lines
1.6 KiB
ReStructuredText
42 lines
1.6 KiB
ReStructuredText
gluon-alt-esc-client
|
|
====================
|
|
|
|
The *gluon-alt-esc-client* package allows to create an additional wifi interface
|
|
with an alternative default gateway.
|
|
|
|
Accessibility
|
|
-------------
|
|
|
|
The alternative default gateway is configured by its MAC address in the config
|
|
mode. This host with its MAC needs to be a accessible directly within the mesh
|
|
network (client zone).
|
|
|
|
An easy way is to use the *gluon-alt-esc-provider* package and copy the
|
|
MAC address it presents in the config mode and paste it into the client
|
|
side configuration. However, the provider package is not mandatory - in fact
|
|
any host in the mesh network can potentially be chosen as an alternative default
|
|
gateway (as long as it allows routing, of course).
|
|
|
|
Only Off-link subnets are rerouted to the alternative exit. On-link subnets are
|
|
excluded. They are currently determined via *prefix4*, *prefix6*, *extra_prefixes4*
|
|
and *extra_prefixes6* from the site.conf.
|
|
|
|
Naming / ESSID
|
|
--------------
|
|
|
|
The name (so called ESSID) for the newly created wifi interface can be
|
|
freely chosen. However the author suggests to not use the word "Freifunk"
|
|
in it (for quite a while the internet is not a free/libre network anymore).
|
|
|
|
The following two hash tags are automatically appended:
|
|
|
|
*Zone-ID*: It prevents potential roaming conflicts. (Technically, it is generated
|
|
by taking the first four bytes of the hexadecimal form of an md5sum over
|
|
"<ipv4-gw-MAC>,<ipv6-gw-MAC>,<essid>")
|
|
|
|
*Site Code*: The communities site code is appended. To Freifunk enthusiasts it
|
|
signalizes:
|
|
|
|
- free and unaltered access to the Freifunk intranet of the local community
|
|
- that this node contributes to the local Freifunk community as a mesh node
|