Layer3Firmware
Allgemeine Informationen
Die Gatewayfirmware kann sehr einfach mithilfe des Skripts configuregateway auf Basis von Hoodfile (/www/hood/keyxchangev2data) und der Gatewaykonfiguration (/etc/config/gateway) konfiguriert werden.
Das Skript konfiguriert den Router entsprechend der /etc/config/gateway und Hoodfile und muss bei Änderungen erneut ausgeführt werden. configuregateway wird nie automatisch ausgeführt, entsprechend verliert der Router bei einem Update alle Einstellungen!
ACHTUNG: Unbekannte Einstellungen werden möglicherweise entfernt!
ULA und Wifi bezieht das Skript aus der Hoodfile, den Rest aus /etc/config/gateway.
Hostname und Position müssen aktuell manuell in /etc/config/fff eingetragen werden, das Webinterface ist aus $Gründen kaputt.
Die Gatewayfirmware wird aktuell größtenteils hier entwickelt: https://github.com/fblaese/firmware/tree/l3
Fertige Builds gibt es entsprechend den Tags aus dem o.g. Repository hier: http://fw.sgstbr.de/gateway/
Eine Bespielkonfiguration mit einem direkten Peer und einem Wireguardpeer gibts hier: https://gist.github.com/fblaese/ca4d903b20b4d7033553f48625b93ca6
configuregateway
Folgende Parameter können übergeben werden:
- -c: Konfiguriert das Gateway mit uci. Kein commit, kein Anwenden der Einstellungen!
- -t: Startet alle Dienste neu, damit werden die Einstellungen aus -c angewendet. Skript wartet bis zu 200s darauf, dass es beendet wird (Strg + c wenn ssh nicht verloren geht, ansonsten kill(all)). Wird das Skript in dieser Zeit nicht beendet, werden die Einstellungen zurückgesetzt und die Dienste erneut neu gestartet.
- -a: Applied die Änderungen (uci commit), startet Dienste neu.
- -r: Revert changes.
/etc/config/gateway
gateway
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | no | |
| peer_ip | IPv4 Adresse | no | IPv4 Adresse für Peerings |
| peer_ip6 | IPv6 Adresse | no | IPv6 Adresse für Peerings |
vlan
| Name | Type | Required | Description |
|---|---|---|---|
| comment | string | no | |
| port | list | no | Ports auf dem Standard-Switch |
client
| Name | Type | Required | Description |
|---|---|---|---|
| iface | interface | no | Clientnetz auf Interface legen |
| vlan | number | no | Clientnetz auf VLAN mit angegebener IP auf dem Standard-Switch legen (Alternativ zu iface!!) |
| ipaddr | IPv4 Adresse | no | Router-IP im Client-Netz (CIDR Notation) |
| ip6addr | IPv6 Adresse | no | Router-IP im Client-Netz (CIDR Notation) |
| dhcp_start | IPv4 Adresse | no | DHCP Startadresse |
| dhcp_limit | number | no | Maximale Anzahl an DHCP-Leases |
dns
| Name | Type | Required | Description |
|---|---|---|---|
| server | list | no | DNS-Server, auf den geforwarded wird |
batman
| Name | Type | Required | Description |
|---|---|---|---|
| iface | interface | no | Batman auf physikalisches auf Interface legen |
| vlan | number | no | Batman auf VLAN mit angegebener IP auf dem Standard-Switch legen (Alternativ zu iface!!) |
babelpeer
| Name | Type | Required | Description |
|---|---|---|---|
| iface | interface | no | Babel auf physikalisches Interface legen |
| vlan | number | no | Babel auf VLAN mit angegebener IP auf dem Standard-Switch legen (Alternativ zu iface!!) |
| type | babel-type | no | Babel Verbindungstyp (z.B. wired, tunnel, ..) |
wireguardpeer
| Name | Type | Required | Description |
|---|---|---|---|
| endpoint_host | host oder ip | yes | |
| endpoint_port | port | yes | |
| persistent_keepalive | seconds | no | |
| public_key | wireguard pubkey | yes | |
| private_key | wireguard privkey | no | automatically generated if unspcified |
