Quelltext der Seite Layer3Firmware

== Allgemeine Informationen ==

Die aktuelle Beta Version enthält die "layer3"-Variante.

'''Vorsicht''': Diese unterscheidet sich in der Konfiguration (teilweise deutlich) von den alten inoffiziellen Varianten. Bestehende Konfigurationen müssen ggf. überarbeitet werden.

'''Batman''': 
Zum aktuellen Stand ist kein Batman enthalten, ein Meshen über Batman mit der normalen Node Firmware ist zum aktuellen Zeitpunkt nicht möglich. Es müssen Accesspoints mit Stockfirmware, OpenWRT o.ä. angeschlossen werden.


Weiterhin gibt es die inoffizielle Firmware von Adrian, siehe [[Gatewayfirmware_Adrian]].

=== Wichtige Dateien ===

'''Gatewaykonfiguration'''<br />
<code>/etc/config/gateway</code>

=== Script ''configuregateway'' ===

Die Gatewayfirmware kann sehr einfach mithilfe des Skripts ''configuregateway'' auf Basis der '''Gatewaykonfiguration''' konfiguriert werden.

Das Script ''configuregateway'' wird aktuell nie automatisch ausgeführt. 
Entsprechend muss es nach Änderungen erneut ausgeführt werden, sowie nach Updates.
(Es werden zwar die o.g. Dateien beim Upgrade ''kopiert'', jedoch muss eben manuell ''configuregateway'' ausgeführt werden, um sie ''anzuwenden'')

'''Achtung:''' Unbekannte Einstellungen außerhalb der Gatewaykonfiguration (z.B. manuell gesetzte Einstellungen in /etc/config/network) werden möglicherweise entfernt!

=== Router Auswahl ===
Es wird ein von uns unterstützer Router mit mindestens 8MB Flash benötigt. Auf der Geschwindigkeitsseite kann angeguckt werden was die Modelle schaffen: https://wiki.freifunk-franken.de/w/Geschwindigkeiten#Leistungstests
Die Firmware wird genauso geflasht wie die normale Node Firmware https://wiki.freifunk-franken.de/w/Portal:Firmware, danach ist die Einrichtung allerdings anders

== Download ==

* https://dev.freifunk-franken.de/layer3/

== Typischer Ablauf einer Installation ==

# Router flashen; Frimware: https://dev.freifunk-franken.de/layer3/current/
# Als Client mit dem Router per SSH verbinden ''oder'' aus dem Heimnetzwerk über die WAN-IP des Routers per SSH verbinden: "SSH root@fdff::1" Passwort:ffol Bitte sofort ändern!
# [[#Generieren_der_Keys_für_WireGuard|WireGuard-Keypair generieren]] falls WireGuard verwendet wird (Schlüssel sichern!) oder sich für eine Richtfunkstrecke absprechen
# [[#Peering-Partner|Peering-Partner]] für WireGuard suchen, persönlich treffen und Schlüssel austauschen oder auf eigenen Server verbinden
# Die [[#.2Fetc.2Fconfig.2Fgateway|Gatewaykonfiguration]] auf das Gerät kopieren (/etc/config/gateway)
# Mit „[[#configuregateway|configuregateway]] -c“ die Einstellungen aus der Gatewayconfig in die Openwrt Configs übernehmen.
# Mit „[[#configuregateway|configuregateway]] -t“ die Einstellungen testen, falls das Script nicht manuell abgebrochen wird, werden nach 200 Sekunden die Einstellungen zurück gesetzt
# Falls der Router noch erreichbar ist, das Script beenden (STRG + C) falls man von der SSH Session heruntergeflogen ist, innerhalb 200 Sekunden erneut verbinden und das ''configuregateway''-Script killen (z.&nbsp;B. mit „killall configuregateway“). Sollte man auf den Router nicht mehr drauf kommen, werden nach 200 Sekunden alle Einstellungen zurück gesetzt und man ist wieder im Ursprungszustand
# Alle Einstellungen prüfen
# Mit „[[#configuregateway|configuregateway]] -a“ werden alle Einstellungen fest gespeichert, erst hiermit wird alles rebootfest geschrieben. Davor kann durch einen „reboot“ jederzeit der Urzustand wieder erreicht werden.

== Peering-Partner ==
https://wiki.freifunk-franken.de/w/Portal:Layer3Peering

Allgemein sollte eigene Infrastruktur (z.b. Richtfunk) dem VPN immer bevorzugt werden. Wir wollen unser eigenes Netz aufbauen und nicht auf den Rücken von großen Providern. Wenn es keine Möglichkeit gibt sich an dem Netz per Richtfunk oder andere eigene Transporttechnologien anzuschließen kann auch VPN über bestehende Internetleitung verwendet werden. Hier eignet sich wireguard oder GRE sehr gut was beides mit der Firmware möglich ist.

=== Per LAN Kabel/Richtfunk/Glasfaser ===
Bevorzugte Variante:
Es kann am Gateway Babel auf einen (oder mehrere) Ethernetport(s) (wenn nötig auch VLAN-getagget) gelegt werden. Somit kann auch über Kabel gepeered werden. 
Natürlich kann das Peering auch über [https://wiki.freifunk-franken.de/w/VLAN_und_Richtfunk Richtfunk], [[Glasfaser-Verbindung|Glasfaser]] oder sonstige Technologien (z.&nbsp;B. Internet-Exchange) realisiert werden.

=== VPN-Tunnel via WireGuard ===
Wenn du über das Internet peeren willst, muss die Gegenseite WireGuard sprechen.

Für WireGuard musst du dir einen Peering-Partner suchen – mit einem Menschen reden, ob er mit dir ein Peering eingehen will – und mit ihm deinen Public-Key austauschen. Mit diesem könnt ihr die VPN-Verbindung aufbauen.

==== Generieren der Keys für WireGuard ====

Ausführliche Anleitung: https://www.wireguard.com/quickstart/

Für WireGuard muss ein Keypair generiert werden. Am einfachsten macht man dies per SSH direkt am Gateway-Router:

<code>
wg genkey | tee privatekey | wg pubkey > publickey
</code>

Den ''privatekey'' in der gleichnamigen Datei trägst du in deine ''gatewayconfig'' ein. Den ''publickey'' teilst du deinem Peering-Partner mit.

Prinzipiell ist es möglich, pro Router jeweils ein Keypair zu generieren oder immer das gleiche Keypair für alle Gateways zu verwenden (mit größerem Risiko bei „Verlust“).

Es empfiehlt sich, den ''privatekey'' zu sichern, da man sonst vom Peering-Partner gehauen wird, wenn deswegen der Tunnel neu eingerichtet werden muss.

=== VPN über GRE ===
*folgt

== Babel Metrik ==

Siehe hier: [[Freifunk-Gateway_aufsetzen/Babel#Richtlinien_f.C3.BCr_Babel_Penalty_.28rxcost.29|Richtlinien für Babel Penalty bei dezentralen Hoods]]

== ''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. Script wartet bis zu 200 Sekunden darauf, dass es beendet wird (Strg + C, wenn SSH nicht verloren geht, ansonsten „kill(all)“). Wird das Script in dieser Zeit nicht beendet, werden die Einstellungen zurückgesetzt und die Dienste erneut neu gestartet.
* ''-a'': Übernimmt die Änderungen (''uci commit''), startet Dienste neu.
* ''-r'': Macht die Änderungen rückgängig.

== /etc/config/gateway ==

Siehe hier: [[Gatewayfirmware_Config]]



[[Kategorie:Technik]]
[[Kategorie:Dezentrale Hood]]
[[Kategorie:Gateways]]