Commit 18b6d078 authored by chrissi^'s avatar chrissi^
Browse files

Parker: Mehr Inhalt


Signed-off-by: chrissi^'s avatarChris Fiege <chris@tinyhost.de>
parent fac46a99
Pipeline #1579 passed with stage
in 22 seconds
......@@ -3,24 +3,95 @@
Freifunk Project Parker
=======================
Im klassischen Gluon-basierenden Freifunk wird in der Regel mit B.A.T.M.A.N. ein großes Layer-2-Netz simuliert. Gerade in großen Netzen (ab einigen hundert Knoten bzw. Benutzern) führt dies zu Problemen. Project Parker versucht diesen Problemen mit klassischem Routing zu begegnen.
.. ffbsbox::
Das Projekt befindet sich derzeit in der Public Beta Phase.
| **Schnellzugriff**:
| `Firmware Download <https://w.freifunk-bs.de/parker_beta/>`__
| `Karte <https://w.freifunk-bs.de/meshviewer/>`__ und `Meshansicht <https://w.freifunk-bs.de/meshviewer/#!/de/graph>`__
| `Statistiken <https://w.freifunk-bs.de/grafana/d/LqfM5XSWz/global?orgId=1>`__
Im klassischen Gluon-basierenden Freifunk wird in der Regel mit B.A.T.M.A.N. ein großes Layer-2-Netz simuliert.
Gerade in großen Netzen (ab einigen hundert Knoten bzw. Benutzern) führt dies zu Problemen.
Im klassischen `Gluon <https://github.com/freifunk-gluon/gluon>`__ gibt es daher Unterstützung für
`Domains <https://gluon.readthedocs.io/en/v2020.1.x/features/multidomain.html>`__.
Diese Teilen ein Freifunk-Netz in mehrere kleine Abschnitte.
Project Parker setzt B.A.T.M.A.N. nur noch in lokalen Meshes ein und setzt für den Uplink auf Wireguard und Routing.
Project Parker versucht diesen Problemen mit einem anderen Ansatz zu begegnen.
Wir setzen auf klassisches Routing.
Diese Änderung erlaubt uns auch auf `fastd <https://wiki.freifunk.net/Fastd>`__ zu verzichten und stattdessen
`Wireguard <https://www.wireguard.com/>`__ einzusetzen.
Project Parker setzt B.A.T.M.A.N. nur noch dort ein, wo es den größten Vorteil bringt: in lokalen *Meshes* zwischen mehreren Knoten.
Dabei ist es egal ob einer oder mehrere Knoten in einem Mesh einen Uplink (VPN) haben.
Die Entwicklung wurde in 2018 begonnen und durch eine Serie an `Blogposts <https://stratum0.org/blog/categories/freifunk/>`__, sowie einem `Vortrag auf dem 35C3 <https://media.ccc.de/v/35c3oio-69-project-parker-klassisches-routing-fr-freifunk>`__ begleitet.
Das Projekt befindet sich derzeit in der Public Beta Phase.
Mitmachen!
----------
Wir suchen Leute, die mitmachen. Das heißt ein oder mehrere Freifunkrouter bei sich betreiben, das Netz nutzen und uns Feedback geben, insbesondere wenn etwas nicht wie erwartet funktioniert.
Wir suchen Leute, die bei diesem Projekt mitmachen wollen.
Es gibt folgende Möglichkeiten sich zu beteiligen:
Über Project Parker surfen
..........................
Dies ist der einfachste Weg mitzumachen.
Suche mit deinem Gerät nach dem WLAN **Freifunk-next** und verbinde dich mit diesem.
Du surfst nun über das Parker-Netz.
Im `Meshviewer <https://w.freifunk-bs.de/meshviewer/#!/de/map>`__ kannst du die Positionen vieler Router finden.
Außerdem kannst Du im Parker-Netz wie gewohnt alle anderen Knoten erreichen.
Eigene Router betreiben
.......................
Einen eigenen Knoten zu betreiben ist mit *Project Parker* genau so einfach, wie beim klassischen Freifunk:
1. Einen kompatiblen Router besorgen. Für *Project Parker* funktionieren alle Router, die auch für ein klassischen Gluon funktionieren.
2. Firmware herunterladen und Router flashen. Falls der Router vorher mit einem klassischen Gluon betrieben wurde setze bei der Installation die Einstellungen zurück.
3. Der Router bootet nun - wie gewohnt - in den Konfigurationsmodus. Hier kannst du wie gewohnt Einstellungen vornehmen.
4. Du brauchst am Ende des Einrichtens aber keinen Schlüssel bei uns einreichen. Dein Router funktioniert direkt!
Die folgenden Links enthalten weitere Informationen:
* Die Firmware findest du `hier <https://w.freifunk-bs.de/>`__
* Um das Netz im Blick zu behalten gibt es den `meshviewer <https://w.freifunk-bs.de/meshviewer/>`__, sowie ein `Grafana <https://w.freifunk-bs.de/grafana/>`__
Während des Beta-Betriebs haben die Entwickler Zugriff auf die Geräte und zusätzlich senden die Geräte ihre Logdaten via rsyslog an einen zentralen Logserver
Während des Beta-Betriebs haben die Entwickler Zugriff auf die Geräte.
Zusätzlich senden die Geräte ihre Logdaten an einen zentralen Logserver in unserem Netz.
Firmware selber bauen
.....................
Wer tiefer in die Materie einsteigen möchte, darf dies natürlich auch gerne tun.
Hier findest du die wichtigsten Informationen um tiefer in die Technik einzusteigen.
* Die Firmware zu *Project Pakrer* basiert auf Gluon.
Wir pflegen daher unseren eigenen Fork von Gluon mit unseren Änderungen.
Dieser befindet sich in unserem `Gitlab <https://gitli.stratum0.org/ffbs/ffbs-gluon/tree/master>`__.
Branches mit **-next** enthalten unsere Änderungen.
Der Basisname entspricht dabei dem Upstream-Branch, auf den wir aufgesetzt haben.
Zum Zeitpunkt des Schreibens ist der aktuelle Branch **v2020.1.x-ffbs-next**.
* Die passende Site befindet sich ebenfalls im `Gitlab <https://gitli.stratum0.org/ffbs/ffbs-site/-/tree/v2020.1.x-ffbs-next>`__.
Die **-next** -Branches gehören hier ebenfalls wieder zum *Project Parker*.
Zum Zeitpunkt des Schreibens ist der aktuelle Branch **v2020.1.x-ffbs-next**.
* Wir haben zusätzlich einen Fork des Upstream-Package Repos - ebenfalls im `Gitlab <https://gitli.stratum0.org/ffbs/packages/-/tree/v2020.1.x-ffbs-next>`__.
Die **-next** -Branches gehören hier ebenfalls wieder zum *Project Parker*.
Zum Zeitpunkt des Schreibens ist der aktuelle Branch **v2020.1.x-ffbs-next**.
* Unsere eigenen Pakete haben wir unserem `Package-Repository <https://gitli.stratum0.org/ffbs/ffbs-packages/-/tree/next>`__.
Hier liegen die passenden Pakete im **next** -Branch.
Die *Package*-Repositories werden bereits von unserem Gluon, bzw. dem der Site referenziert.
Diese müssen nicht besonders gecloned werden.
Darüber hinaus baut sich die *Project Parker* Firmware wie jedes andere Gluon.
Siehe dazu diese `Anleitung <https://gluon.readthedocs.io/en/v2020.1.x/user/getting_started.html>`__.
Firmware entwickeln
...................
Wer tiefer in die Materie einsteigen möchte, darf dies natürlich auch gerne tun. Einen guten Einstieg bietet `dieser Blogpost <https://stratum0.org/blog/posts/2020/01/12/freifunk-parker/>`__.
Wenn Du in die *Project Parker* Entwicklung einsteigen möchtest melde Dich
bei uns im `IRC </irc.html>`__ oder auf unserer `Kontaktadresse </kontakt.html>`__.
Aktuell treffen wir uns unregelmäßig ein, bis zweimal im Monat um die Entwicklung voran zu bringen.
Diese Treffen sind eine gute Gelegenheit in die Materie einzusteigen.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment