Freifunk MWU Wiki - Benutzerbeiträge [de]

Backbone/Architektur

2015-09-03T20:09:16Z

Matthias:

Hier sammeln wir Vorschläge für die Backbone-Architektur

==Vorschlag von Thomas Füll==

Es sollten in den Städen (Mainz, Wiesbaden) 2 Ringe enstehen die komplett
redundant und ausfallsicher sind. Zusätzlich noch in den Ringen jeweils ein weiterer Ring.
Die eingesetzte Hardware muss ein Gemisch zwischen TL-Router(n) und Ubiquity Komponenten sein.
Das Backbone sollte an mindestens 2 unterschiedlichen Stellen mit einem Gateway verbunden sein.
Jeder Backbone Knoten muss mittels Richtfunk seine Nachbarn (Rechts und Links) sehen,
zusätzlich eine Mesh Anbindung für die FF Router in seiner Nähe zur Verfügung stellen.
Die Ringe untereinander sollten an 2-3 Punkten mittels Richtfunk mit dem äußeren Ring verbunden sein.
Ebenfalls sollten die Backbone Knoten mit einer langen USV versehen sein, alternativ mit Solar
oder Wind versorgt sein. Als Betreiber sehe ich einen Verein oder Organisation, der/die sicher
stellen kann, dass die Knoten 24/7 erreichbar sind und funktionieren. Es sollte außerdem
Ersatzhardware zur Verfügung stehen, was bedeutet das die Knoten alle gleich aufgebaut werden sollten.
Vom äußeren Ring sollte außerdem versucht werden Linkstrecken zu anderen Städten herzustellen.

== Vorschlag von Moritz (leicht modifiziert und mit Prosa versehen von Kai) ==
[[File:FF-Backbone.svg|200px|thumb|Grafische Darstellung der Architektur]]
=== Standort-Klassifikation ===

Es gibt unterschiedliche Arten von Backbone-Standorten, die unterschiedliche Aufgaben erfüllen und in einer gewissen Hierarchie zueinander stehen. Die Topologie, die alle diese Standorte aufspannen, wird davon abhängen, wie die uns zur Verfügung stehenden Standorte örtlich verteilt sind und wie die Topographie dazwischen aussieht. Dabei wollen wir darauf achten, dass alle Standorte dieses Netzes redundant erreichbar sind.

Die hier beschriebene Klassifikation ist ein theoretisches Modell, das Kommunikation und Planung erleichtern soll. In der Praxis wird es immer wieder vorkommen, dass Standorte, die im Wesentlichen einer der beschriebenen Klassen entsprechen, zusätzlich auch Elemente anderer Klassen aufweisen.

Diese Arten von Backbone-Standorten werden definiert:

* '''Backbone-Verteiler''':
::oberste Ebene und zentrale Installationen des Backbone (Bsp: UniMedizin);
::Ein Backbone-Verteiler hat p2p-Verbindungen (''point-to-point'') zu anderen Backbone-Verteilern. In seiner weiteren Umgebung verteilt er das Backbone-Netz mit Sektorantennen im 5GHz-Band (z.B. NSM5) an die nächste Ebene von Backbone-Standorten (p2mp (''point-2-multipoint'')); alle sinnvollen Richtung sollen dabei abgedeckt werden. Für diese Verteilungsaufgabe benötigen Backbone-Verteiler in der Regel einen sehr exponierten Standort.
::Wenn es sich anbietet, agiert ein Backbone-Verteiler auch gleichzeitig als Backbone-Knoten und verteilt - zusätzlich zu seinen eigentlichen Aufgaben - Freifunk-Netz in seiner näheren Umgebung.
::Es könnten drei bis vier Backbone-Verteiler pro Stadt sinnvoll sein. Backbone-Verteiler sollten vom Backbone-Team betrieben werden.

* '''Backbone-Relais''':
::gehören zur obersten Ebene des Backbone
::Wie ein Backbone-Verteiler, hat auch der -Relais p2p-Verbindungen zu Backbone-Verteilern (seltener zu anderen -Relais). Allerdings verteilt er das Backbone-Netz nicht nach dem p2mp-Prinzip. Ein Backbone-Relais hat den Zweck, ein topographisches Hindernis (Erhebung) zu überwinden und dadurch mehrere Backbone-Verteiler zu verbinden, oder Backbone-Netz an eine bestimmte Stelle zu bringen.
::Backbone-Relais sollten vom Backbone-Team betrieben werden.

* '''Backbone-Knoten''':
::untere Ebene des Backbone (Bsp: Holzturm);
::Der Backbone-Knoten erhält sein Backbone-Netz über Verbindungen zu Backbone-Verteilern (direkt, oder zusätzlich indirekt über benachbarte Backbone-Knoten) und verteilt es in seiner Umgebung weiter (ebenfalls über Sektorantennen im 5GHz-Band). Darüber hinaus "verteilt" er auch das Freifunk-Netz (Mesh und Client) in seiner näheren Umgebung. Letzteres kann im 2.4- oder auch 5GHz-Band erfolgen, oder auch in beiden; in vielen Fällen werden sich auch hier Sektorantennen anbieten.
::Backbone-Knoten operieren in etwa auf Stadtteil-Ebene. Backbone-Knoten sollten vom Backbone-Team betrieben werden.

* '''Backbone-Client''':
::nicht mehr Teil des Backbone, aber mit Verbindung dorthin (Bsp: Peng);
::Ein Backbone-Client bezieht über eine Verbindung zu Backbone-Knoten (in Einzelfällen auch direkt von Backbone-Verteilern) Backbone-Netz, verteilt es aber nicht mehr weiter. Er nimmt aber normal am Mesh in seiner näheren Umgebung teil und bedient auch Clients mit dem Freifunk-Netz. Insofern handelt es sich um einen normalen Freifunk-Knoten mit zusätzlichem Link ins Backbone.
::Backbone-Clients werden in der Regel nicht von Backbone-Team betrieben.

* '''Backbone-Uplink''':
::Übergang ins kabelgebundene Netz;
::Ein Backbone-Uplink beheimatet ein Gateway, das dem Backbone eine direkte und schnelle (>=50/10MBps) Verbindung ins Internet ermöglicht. Dafür wird der Backbone-Uplink über p2p-Verbindungen in das Netz der Backbone-Verteiler eingebunden.
:: Backbone-Uplinks sollten vom Backbone-Team betrieben werden.

=== Klassifikation der Verbindungen ===

Aus dem obigen Vorschlag zur Klassifikation der Standorte ergeben sich gewisse Verbindungen zwischen den Standorten.

* ''' Backbone-Link''':
::Ein Backbone-Link verbindet genau zwei Backbone-Verteiler miteinander, oder einen Backbone-Uplink mit einem Backbone-Verteiler (hier können auch Backbone-Relais als Teilnehmer auftauchen).
::Wir nutzen dafür das 5GHz-Band und stark gerichtete Antennen; schon deshalb handelt es sich um p2p-Verbindungen. Die Verbindung wird verschlüsselt und der Schlüssel braucht das Backbone-Team auch nicht verlassen. Wir können hier proprietäre Hardware und Protokolle einsetzen. Die Nutzlast besteht aus B.A.T.M.A.N-Paketen.

* '''Backbone-Verteilung''':
::Sowohl Backbone-Verteiler, als auch Backbone-Knoten "verteilen" Backbone-Netz in ihre Umgebungen an Backbone-Knoten und -Clients. Das nennen wir Backbone-Verteilung. <small>''(NB:Wenn jemand einen besseren Namen hat, immer her damit!)''</small>
::Auch hier nutzen wir das 5GHz-Band, aber mit Sektorantennen. Dadurch sollen sich p2mp-Verbindungen ergeben. Auch diese Verbindungen werden noch verschlüsselt, der Schlüssel ist aber Betreibern von Backbone-Clients zugänglich. Auch hier setzen wir auf proprietäre Hardware und Protokolle. Die Nutzlast besteht aus B.A.T.M.A.N-Paketen.

* '''Freifunk-Netz''':
::Das ist das Freifunk-Netz, das wir schon können. Es besteht aus zwei Netzen, dem "normalen W-LAN", in dass sich End-User einklinken und das Mesh, das die Freifunk-Knoten verbindet.
::Das Freifunk-Netz nutzt das 2.4HGz- und das 5HGz-Band, es ist unverschlüsselt und funktioniert mit offenen Protokollen (Mz&Wi verwenden Gluon).

[[Kategorie:Backbone]]

Backbone/Architektur

2015-09-03T20:07:42Z

Matthias: /* Vorschlag von Moritz (leicht modifiziert und mit Prosa versehen von Kai) */

Hier sammeln wir Vorschläge für die Backbone-Architektur

==Vorschlag von Thomas Füll==

Es sollten in den Städen (Mainz, Wiesbaden) 2 Ringe enstehen die komplett
redundant und ausfallsicher sind. Zusätzlich noch in den Ringen jeweils ein weiterer Ring.
Die eingesetzte Hardware muss ein Gemisch zwischen TL-Router(n) und Ubiquity Komponenten sein.
Das Backbone sollte an mindestens 2 unterschiedlichen Stellen mit einem Gateway verbunden sein.
Jeder Backbone Knoten muss mittels Richtfunk seine Nachbarn (Rechts und Links) sehen,
zusätzlich eine Mesh Anbindung für die FF Router in seiner Nähe zur Verfügung stellen.
Die Ringe untereinander sollten an 2-3 Punkten mittels Richtfunk mit dem äußeren Ring verbunden sein.
Ebenfalls sollten die Backbone Knoten mit einer langen USV versehen sein, alternativ mit Solar
oder Wind versorgt sein. Als Betreiber sehe ich einen Verein oder Organisation, der/die sicher
stellen kann, dass die Knoten 24/7 erreichbar sind und funktionieren. Es sollte außerdem
Ersatzhardware zur Verfügung stehen, was bedeutet das die Knoten alle gleich aufgebaut werden sollten.
Vom äußeren Ring sollte außerdem versucht werden Linkstrecken zu anderen Städten herzustellen.

== Vorschlag von Moritz (leicht modifiziert und mit Prosa versehen von Kai) ==
[[File:FF-Backbone.svg|200px|thumb|grafische Darstellung der Architektur]]
=== Standort-Klassifikation ===

Es gibt unterschiedliche Arten von Backbone-Standorten, die unterschiedliche Aufgaben erfüllen und in einer gewissen Hierarchie zueinander stehen. Die Topologie, die alle diese Standorte aufspannen, wird davon abhängen, wie die uns zur Verfügung stehenden Standorte örtlich verteilt sind und wie die Topographie dazwischen aussieht. Dabei wollen wir darauf achten, dass alle Standorte dieses Netzes redundant erreichbar sind.

Die hier beschriebene Klassifikation ist ein theoretisches Modell, das Kommunikation und Planung erleichtern soll. In der Praxis wird es immer wieder vorkommen, dass Standorte, die im Wesentlichen einer der beschriebenen Klassen entsprechen, zusätzlich auch Elemente anderer Klassen aufweisen.

Diese Arten von Backbone-Standorten werden definiert:

* '''Backbone-Verteiler''':
::oberste Ebene und zentrale Installationen des Backbone (Bsp: UniMedizin);
::Ein Backbone-Verteiler hat p2p-Verbindungen (''point-to-point'') zu anderen Backbone-Verteilern. In seiner weiteren Umgebung verteilt er das Backbone-Netz mit Sektorantennen im 5GHz-Band (z.B. NSM5) an die nächste Ebene von Backbone-Standorten (p2mp (''point-2-multipoint'')); alle sinnvollen Richtung sollen dabei abgedeckt werden. Für diese Verteilungsaufgabe benötigen Backbone-Verteiler in der Regel einen sehr exponierten Standort.
::Wenn es sich anbietet, agiert ein Backbone-Verteiler auch gleichzeitig als Backbone-Knoten und verteilt - zusätzlich zu seinen eigentlichen Aufgaben - Freifunk-Netz in seiner näheren Umgebung.
::Es könnten drei bis vier Backbone-Verteiler pro Stadt sinnvoll sein. Backbone-Verteiler sollten vom Backbone-Team betrieben werden.

* '''Backbone-Relais''':
::gehören zur obersten Ebene des Backbone
::Wie ein Backbone-Verteiler, hat auch der -Relais p2p-Verbindungen zu Backbone-Verteilern (seltener zu anderen -Relais). Allerdings verteilt er das Backbone-Netz nicht nach dem p2mp-Prinzip. Ein Backbone-Relais hat den Zweck, ein topographisches Hindernis (Erhebung) zu überwinden und dadurch mehrere Backbone-Verteiler zu verbinden, oder Backbone-Netz an eine bestimmte Stelle zu bringen.
::Backbone-Relais sollten vom Backbone-Team betrieben werden.

* '''Backbone-Knoten''':
::untere Ebene des Backbone (Bsp: Holzturm);
::Der Backbone-Knoten erhält sein Backbone-Netz über Verbindungen zu Backbone-Verteilern (direkt, oder zusätzlich indirekt über benachbarte Backbone-Knoten) und verteilt es in seiner Umgebung weiter (ebenfalls über Sektorantennen im 5GHz-Band). Darüber hinaus "verteilt" er auch das Freifunk-Netz (Mesh und Client) in seiner näheren Umgebung. Letzteres kann im 2.4- oder auch 5GHz-Band erfolgen, oder auch in beiden; in vielen Fällen werden sich auch hier Sektorantennen anbieten.
::Backbone-Knoten operieren in etwa auf Stadtteil-Ebene. Backbone-Knoten sollten vom Backbone-Team betrieben werden.

* '''Backbone-Client''':
::nicht mehr Teil des Backbone, aber mit Verbindung dorthin (Bsp: Peng);
::Ein Backbone-Client bezieht über eine Verbindung zu Backbone-Knoten (in Einzelfällen auch direkt von Backbone-Verteilern) Backbone-Netz, verteilt es aber nicht mehr weiter. Er nimmt aber normal am Mesh in seiner näheren Umgebung teil und bedient auch Clients mit dem Freifunk-Netz. Insofern handelt es sich um einen normalen Freifunk-Knoten mit zusätzlichem Link ins Backbone.
::Backbone-Clients werden in der Regel nicht von Backbone-Team betrieben.

* '''Backbone-Uplink''':
::Übergang ins kabelgebundene Netz;
::Ein Backbone-Uplink beheimatet ein Gateway, das dem Backbone eine direkte und schnelle (>=50/10MBps) Verbindung ins Internet ermöglicht. Dafür wird der Backbone-Uplink über p2p-Verbindungen in das Netz der Backbone-Verteiler eingebunden.
:: Backbone-Uplinks sollten vom Backbone-Team betrieben werden.

=== Klassifikation der Verbindungen ===

Aus dem obigen Vorschlag zur Klassifikation der Standorte ergeben sich gewisse Verbindungen zwischen den Standorten.

* ''' Backbone-Link''':
::Ein Backbone-Link verbindet genau zwei Backbone-Verteiler miteinander, oder einen Backbone-Uplink mit einem Backbone-Verteiler (hier können auch Backbone-Relais als Teilnehmer auftauchen).
::Wir nutzen dafür das 5GHz-Band und stark gerichtete Antennen; schon deshalb handelt es sich um p2p-Verbindungen. Die Verbindung wird verschlüsselt und der Schlüssel braucht das Backbone-Team auch nicht verlassen. Wir können hier proprietäre Hardware und Protokolle einsetzen. Die Nutzlast besteht aus B.A.T.M.A.N-Paketen.

* '''Backbone-Verteilung''':
::Sowohl Backbone-Verteiler, als auch Backbone-Knoten "verteilen" Backbone-Netz in ihre Umgebungen an Backbone-Knoten und -Clients. Das nennen wir Backbone-Verteilung. <small>''(NB:Wenn jemand einen besseren Namen hat, immer her damit!)''</small>
::Auch hier nutzen wir das 5GHz-Band, aber mit Sektorantennen. Dadurch sollen sich p2mp-Verbindungen ergeben. Auch diese Verbindungen werden noch verschlüsselt, der Schlüssel ist aber Betreibern von Backbone-Clients zugänglich. Auch hier setzen wir auf proprietäre Hardware und Protokolle. Die Nutzlast besteht aus B.A.T.M.A.N-Paketen.

* '''Freifunk-Netz''':
::Das ist das Freifunk-Netz, das wir schon können. Es besteht aus zwei Netzen, dem "normalen W-LAN", in dass sich End-User einklinken und das Mesh, das die Freifunk-Knoten verbindet.
::Das Freifunk-Netz nutzt das 2.4HGz- und das 5HGz-Band, es ist unverschlüsselt und funktioniert mit offenen Protokollen (Mz&Wi verwenden Gluon).

[[Kategorie:Backbone]]

Datei:FF-Backbone.svg

2015-09-03T20:01:17Z

Matthias: Matthias lud eine neue Version von „Datei:FF-Backbone.svg“ hoch

Backbone Architektur

Datei:FF-Backbone.svg

2015-09-03T19:59:23Z

Matthias: Backbone Architektur

Backbone Architektur

Howto/Per SSH auf Freifunk Router verbinden

2015-06-21T13:14:21Z

Matthias: /* Schlüsselpaar unter Windows erzeugen */

__NOTOC__
Auf dieser Seite soll beschrieben werden, wie du dich per SSH auf deinen Freifunk-Router verbinden kannst, um z.B. [[Howto/Gluon_Konfig_Aendern | Einstellungen]] am Knoten-Namen, den Geo-Daten o.Ä. vorzunehmen.

Um dich zu verbinden, brauchst du erstens ein Tool und zweitens die richtige Adresse deines Knotens. Für beides soll es hier ein paar Einstiegshilfen geben.

Der Zugriff auf deinen Freifunk-Knoten muss per IPV6 erfolgen (dein Knoten hat keine IPV4-Adresse). Daher muss dein Rechner, von dem aus du dich verbinden willst, IPV6 unterstützen. Bei manchen Windows-Rechnern ist das standardmäßig nicht der Fall. Daher kann stattdessen z.B. auch Smartphone aus zugegriffen werden z.B. mit dem SSH-Client namens "JuiceSSH".

=IP-Adresse herausfinden=
Um auf deinen Knoten zuzugreifen, musst du also erstmal seine Adresse ermitteln. Eine Möglichkeit, die IPV6-Adresse herauszufinden, mit der du dich auf deinen Knoten verbinden kannst, ist der Meshviewer. Klicke im [http://meshviewer.freifunk-mainz.de Meshviewer] auf deinen Knoten, dann werden dir links in der Übersicht 2 Adressen angezeigt. Für dich wichtig ist die obere der beiden, im Bild mit einem roten Rahmen markiert.

[[Datei:IPimMeshviewer.PNG]]

==Per DNS auf Router zugreifen==
Statt die Adresse aus der Map auszulesen, kannst du auch die zweite Möglichkeit nutzen und per DNS-Name auf deinen Router zugreifen. Der DNS Name bildet sich wie folgt:
Knotenname + .nodes.ffmz.org
In unserem obigen Beispiel heißt der Knoten "genNode". Daraus wird im DNS:
genNode.nodes.ffmz.org

Hast du in deinem Knotennamen Zeichen verwendet, die im DNS nicht erlaubt sind, wird einfach kein DNS Eintrag erzeugt und du kannst diese Funktion leider nicht nutzen.

=Knoten für den Zugriff per SSH vorbereiten=
Um den Knoten über SSH überhaupt erreichen zu können, musst du die entsprechenden Einstellungen während der [https://wiki.freifunk-mainz.de/w/Howto/Gluon_Konfigurieren#Remotezugriff Einrichtung] bereits getätigt haben oder dies jetzt [https://wiki.freifunk-mainz.de/w/Howto/Gluon_Konfig_Aendern nachholen].
==SSH Zugriff mittels Passwort==
Der Zugriff mittels Passwort ist die einfachere Variante dafür aber auch nicht so sicher wie der Zugriff mittels Schlüsselpaar. Entscheidest du dich trotzdem hierfür, solltest du ein möglichst sicheres Passwort in den roten umrandeten Feldern eingetragen haben:

[[Datei:SSH_GluonConfigPasswort.png|600px|]]

Falls du deinen Knoten schon eingerichtet hast, erfährst du [https://wiki.freifunk-mainz.de/w/Howto/Gluon_Konfig_Aendern hier] wie du die Konfigurationsoberfläche wieder erreichen kannst. Ist dieser Schritt erledigt, kannst du bei dem nächsten [https://wiki.freifunk-mainz.de/w/Howto/Per_SSH_auf_Freifunk_Router_verbinden#Einloggen_auf_dem_Freifunk-Knoten Schritt(Einloggen auf dem Freifunk-Knoten)] weiter machen.

==SSH Zugriff mittels Schlüsselpaar==
Der Zugriff auf den Knoten mittels eines Schlüsselpaares, den sogenannten SSH-Keys ist schon etwas anspruchsvoller, mit dieser Anleitung aber auch zu meistern. Interessant ist die Einrichtung vorallem auch dann, wenn man gerne mehrere Knoten verwalten möchte.
Für diese Variante benötigst du, wer hätte es gedacht, zunächst ein Schlüsselpaar. Die Erzeugung eines solchen ist betriebssystemabhängig. Entsprechend sind die nächsten Abschnitt für Windows, Linux und Mac OS untergliedert.
===Schlüsselpaar unter Windows erzeugen===
Für die Erzeugung eines Schlüsselpaares unter Windows benötigst du das Programm PuTTYgen, das du [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html hier] herunterladen kannst.

[[Datei:DownloadPuTTYgen.PNG]]

Nach dem Download startest du das Programm "puttygen.exe" mit einem Doppelklick. Danach solltest du das folgende Fenster sehen:

[[Datei:PuTTYgenStart.PNG]]

In diesem Fenster klickst du den Button "Generate" an, worauf im oberen Bereich unter Key ein Ladebalken sowie die Aufforderung "Please generate some randomness by moving the mouse over the blank area" erscheint.

[[Datei:PuTTYgenRandomness.PNG]]

Mit der "blank area" ist der graue Bereich unterhalb des Ladebalkens gemeint. Nun also die Maus in diesem Bereich hin und her geschubbst und schon bewegt sich der Ladebalken kontinuierlich weiter nach rechts. Sobald der Ladebalken rechts angekommen ist, dauert es nur noch einen kleinen Moment und dein Schlüsselpaar ist erzeugt. Die Oberfläche des Programms sollte nun so aussehen. Die Schlüssel auf dem Bild und jene bei dir Unterscheiden sich natürlich!

[[Datei:PuTTYgenKeys.PNG]]

Nachdem das Schlüsselpaar erzeugt ist, kannst du es nun noch mit einem Kommentar versehen, damit du deine Schlüssel, für den Fall dass du einmal viele davon hast, zuordnen kannst. Hierzu kannst du das Feld "Key comment" verwenden.
Die Felder "Key passphrase" und "Confirm passphrase" dienen dazu, dein Schlüsselpaar zusätzlich mit einer Passphrase zu versehen. Falls dein geheimer Schlüssel jemals in fremde Hände fällt, braucht der Fremde auch noch diese Passphrase, um deinen Schlüssel verwenden zu können (du musst dir die Passphrase natürlich auch merken, möchtest du den Schlüssel verwenden!) Wie du siehst, wurden die Felder in unserem Beispiel entsprechend ausgefüllt.

[[Datei:PuTTYgenKeysEnde.PNG]]

Jetzt geht es ans Eingemachte! Um die Schlüssel mit deinem Knoten verwenden zu können, musst du Sie zunächst als Dateien speichern. Lege dir dazu am besten ein Verzeichnis an. In dieses Verzeichnis speicherst du mit einem Klick auf "Save public key" zunächst deinen öffentlichen Schlüssel. Wähle in dem erschienen "Speichern"-Dialog dein Ordner aus und entscheide dich für einen Dateinamen, in unserem Beispiel nennen wir die Datei "gennode_pub.txt".

[[Datei:PuTTYgenPubkeySpeichern.PNG]]

Anschließend speicherst du deinen privaten, geheimen Schlüssel mit einem Klick auf "Save private key" unter dem Namen "gennode_priv.ppk" im selben Verzeichnis wie deinen öffentlichen Schlüssel.

[[Datei:PuTTYgenPrivkeySpeichern.PNG]]

Lasse das PuTTYgen-Fenster mit dem erzeugten Schlüsselpaar unbedingt geöffnet. Im nächsten Schritt benötigst du die Zeichenkette im Feld "Public key for pasting into OpenSSH authorized_keys file".

[[Datei:PuTTYgenKeysEndeMarkiert.PNG]]

Zunächst ist es allerdings nötig, dass du wie [https://wiki.freifunk-mainz.de/w/Howto/Gluon_Konfig_Aendern hier] beschrieben die Konfiguration deines Knotens aufrufst und dich im Expertenmodus zum Remotezugriff [https://wiki.freifunk-mainz.de/w/Howto/Gluon_Konfigurieren durchklickst]. Dort angekommen solltest du die unten abgebildete Maske sehen:

[[Datei:SSH GluonConfigSSH.png|600px|]]

Mache einen Rechtsklick in "Public key for pasting into OpenSSH authorized_keys file" und klicke auf "Alles auswählen". Der Schlüssel sollte nun markiert sein. Anschließend machst du wieder einen Rechtsklick und wählst "Kopieren" aus. Nun öffnest du wieder das Fenster mit der Remotezugriff-Konfiguration deines Knotens. Dort klickst du in das gelbe Feld unter SSH-Keys und fügst den Schlüssel dort ein. Achte unbedingt darauf, dass der eingefügte Schlüssel in einer einzigen Zeile, also ohne Zeilenumbruch, steht. Mit einem Klick auf "Speichern" ist die Konfiguration auf dem Router abgeschlossen und du kannst zu dem Kapitel [https://wiki.freifunk-mainz.de/w/Howto/Per_SSH_auf_Freifunk_Router_verbinden#Einloggen_auf_dem_Freifunk-Knoten Einloggen auf dem Freifunk-Knoten] springen.

===Schlüsselpaar unter Linux erzeugen===
Anleitung folgt
===Schlüsselpaar unter Mac OS erzeugen===
Anleitung folgt

=Einloggen auf dem Freifunk-Knoten =
Im zweiten Schritt musst du die - wie oben beschrieben ermittelte - IPV6-Adresse deines Knotens eintragen. Den Rest übernimmt eigentlich das Tool. Zum Einloggen benötigst du natürlich dein Passwort, das du hoffentlich beim Konfigurieren des Knotens gesetzt (und dir gemerkt) hast.

Falls du kein Passwort gesetzt hast, kannst du dich nicht per SSH verbinden. Dann musst du den Router entweder nochmal in den Konfig-Modus starten und das Passwort in der Weboberfläche setzen. Oder du startest ihn in den Fail-Safe-Modus (da ist er nur per Telnet erreichbar) und setzt ein SSH-Passwort. Beides soll aber nicht Bestandteil dieser Anleitung sein.

==Windows: Putty==
[[Datei:putty1.png]]

Nach dem Verbinden mit dem user '''root''' und dem bei der Installation eingerichteten Passwort anmelden
==Android: JuiceSSH==
Installation aus Playstore. Angeben der o.g. Adresse.

Howto/Per SSH auf Freifunk Router verbinden

2015-06-21T13:05:42Z

Matthias: /* Schlüsselpaar unter Windows erzeugen */

__NOTOC__
Auf dieser Seite soll beschrieben werden, wie du dich per SSH auf deinen Freifunk-Router verbinden kannst, um z.B. [[Howto/Gluon_Konfig_Aendern | Einstellungen]] am Knoten-Namen, den Geo-Daten o.Ä. vorzunehmen.

Um dich zu verbinden, brauchst du erstens ein Tool und zweitens die richtige Adresse deines Knotens. Für beides soll es hier ein paar Einstiegshilfen geben.

Der Zugriff auf deinen Freifunk-Knoten muss per IPV6 erfolgen (dein Knoten hat keine IPV4-Adresse). Daher muss dein Rechner, von dem aus du dich verbinden willst, IPV6 unterstützen. Bei manchen Windows-Rechnern ist das standardmäßig nicht der Fall. Daher kann stattdessen z.B. auch Smartphone aus zugegriffen werden z.B. mit dem SSH-Client namens "JuiceSSH".

=IP-Adresse herausfinden=
Um auf deinen Knoten zuzugreifen, musst du also erstmal seine Adresse ermitteln. Eine Möglichkeit, die IPV6-Adresse herauszufinden, mit der du dich auf deinen Knoten verbinden kannst, ist der Meshviewer. Klicke im [http://meshviewer.freifunk-mainz.de Meshviewer] auf deinen Knoten, dann werden dir links in der Übersicht 2 Adressen angezeigt. Für dich wichtig ist die obere der beiden, im Bild mit einem roten Rahmen markiert.

[[Datei:IPimMeshviewer.PNG]]

==Per DNS auf Router zugreifen==
Statt die Adresse aus der Map auszulesen, kannst du auch die zweite Möglichkeit nutzen und per DNS-Name auf deinen Router zugreifen. Der DNS Name bildet sich wie folgt:
Knotenname + .nodes.ffmz.org
In unserem obigen Beispiel heißt der Knoten "genNode". Daraus wird im DNS:
genNode.nodes.ffmz.org

Hast du in deinem Knotennamen Zeichen verwendet, die im DNS nicht erlaubt sind, wird einfach kein DNS Eintrag erzeugt und du kannst diese Funktion leider nicht nutzen.

=Knoten für den Zugriff per SSH vorbereiten=
Um den Knoten über SSH überhaupt erreichen zu können, musst du die entsprechenden Einstellungen während der [https://wiki.freifunk-mainz.de/w/Howto/Gluon_Konfigurieren#Remotezugriff Einrichtung] bereits getätigt haben oder dies jetzt [https://wiki.freifunk-mainz.de/w/Howto/Gluon_Konfig_Aendern nachholen].
==SSH Zugriff mittels Passwort==
Der Zugriff mittels Passwort ist die einfachere Variante dafür aber auch nicht so sicher wie der Zugriff mittels Schlüsselpaar. Entscheidest du dich trotzdem hierfür, solltest du ein möglichst sicheres Passwort in den roten umrandeten Feldern eingetragen haben:

[[Datei:SSH_GluonConfigPasswort.png|600px|]]

Falls du deinen Knoten schon eingerichtet hast, erfährst du [https://wiki.freifunk-mainz.de/w/Howto/Gluon_Konfig_Aendern hier] wie du die Konfigurationsoberfläche wieder erreichen kannst. Ist dieser Schritt erledigt, kannst du bei dem nächsten [https://wiki.freifunk-mainz.de/w/Howto/Per_SSH_auf_Freifunk_Router_verbinden#Einloggen_auf_dem_Freifunk-Knoten Schritt(Einloggen auf dem Freifunk-Knoten)] weiter machen.

==SSH Zugriff mittels Schlüsselpaar==
Der Zugriff auf den Knoten mittels eines Schlüsselpaares, den sogenannten SSH-Keys ist schon etwas anspruchsvoller, mit dieser Anleitung aber auch zu meistern. Interessant ist die Einrichtung vorallem auch dann, wenn man gerne mehrere Knoten verwalten möchte.
Für diese Variante benötigst du, wer hätte es gedacht, zunächst ein Schlüsselpaar. Die Erzeugung eines solchen ist betriebssystemabhängig. Entsprechend sind die nächsten Abschnitt für Windows, Linux und Mac OS untergliedert.
===Schlüsselpaar unter Windows erzeugen===
Für die Erzeugung eines Schlüsselpaares unter Windows benötigst du das Programm PuTTYgen, das du [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html hier] herunterladen kannst.

[[Datei:DownloadPuTTYgen.PNG]]

Nach dem Download startest du das Programm "puttygen.exe" mit einem Doppelklick. Danach solltest du das folgende Fenster sehen:

[[Datei:PuTTYgenStart.PNG]]

In diesem Fenster klickst du den Button "Generate" an, worauf im oberen Bereich unter Key ein Ladebalken sowie die Aufforderung "Please generate some randomness by moving the mouse over the blank area" erscheint.

[[Datei:PuTTYgenRandomness.PNG]]

Mit der "blank area" ist der graue Bereich unterhalb des Ladebalkens gemeint. Nun also die Maus in diesem Bereich hin und her geschubbst und schon bewegt sich der Ladebalken kontinuierlich weiter nach rechts. Sobald der Ladebalken rechts angekommen ist, dauert es nur noch einen kleinen Moment und dein Schlüsselpaar ist erzeugt. Die Oberfläche des Programms sollte nun so aussehen. Die Schlüssel auf dem Bild und jene bei dir Unterscheiden sich natürlich!

[[Datei:PuTTYgenKeys.PNG]]

Nachdem das Schlüsselpaar erzeugt ist, kannst du es nun noch mit einem Kommentar versehen, damit du deine Schlüssel, für den Fall dass du einmal viele davon hast, zuordnen kannst. Hierzu kannst du das Feld "Key comment" verwenden.
Die Felder "Key passphrase" und "Confirm passphrase" dienen dazu, dein Schlüsselpaar zusätzlich mit einer Passphrase zu versehen. Falls dein geheimer Schlüssel jemals in fremde Hände fällt, braucht der Fremde auch noch diese Passphrase, um deinen Schlüssel verwenden zu können (du musst dir die Passphrase natürlich auch merken, möchtest du den Schlüssel verwenden!) Wie du siehst, wurden die Felder in unserem Beispiel entsprechend ausgefüllt.

[[Datei:PuTTYgenKeysEnde.PNG]]

Jetzt geht es ans Eingemachte! Um die Schlüssel mit deinem Knoten verwenden zu können, musst du Sie zunächst als Dateien speichern. Lege dir dazu am besten ein Verzeichnis an. In dieses Verzeichnis speicherst du mit einem Klick auf "Save public key" zunächst deinen öffentlichen Schlüssel. Wähle in dem erschienen "Speichern"-Dialog dein Ordner aus und entscheide dich für einen Dateinamen, in unserem Beispiel nennen wir die Datei "gennode_pub.txt".

[[Datei:PuTTYgenPubkeySpeichern.PNG]]

Anschließend speicherst du deinen privaten, geheimen Schlüssel mit einem Klick auf "Save private key" unter dem Namen "gennode_priv.ppk" im selben Verzeichnis wie deinen öffentlichen Schlüssel.

[[Datei:PuTTYgenPrivkeySpeichern.PNG]]

Lasse das PuTTYgen-Fenster mit dem erzeugten Schlüsselpaar unbedingt geöffnet. Im nächsten Schritt benötigst du die Zeichenkette im Feld "Public key for pasting into OpenSSH authorized_keys file".

[[Datei:PuTTYgenKeysEndeMarkiert.PNG]]

Zunächst ist es allerdings nötig, dass du wie [https://wiki.freifunk-mainz.de/w/Howto/Gluon_Konfig_Aendern hier] beschrieben die Konfiguration deines Knotens aufrufst und dich im Expertenmodus zum Remotezugriff ([https://wiki.freifunk-mainz.de/w/Howto/Gluon_Konfigurieren durchklickst]). Dort angekommen solltest du die unten abgebildete Maske sehen:

[[Datei:SSH GluonConfigSSH.png|600px|]]

Mache einen Rechtsklick in "Public key for pasting into OpenSSH authorized_keys file" und klicke auf "Alles auswählen". Der Schlüssel sollte nun markiert sein. Anschließend machst du wieder einen Rechtsklick und wählst "Kopieren" aus. Nun öffnest du wieder das Fenster mit der Remotezugriff-Konfiguration deines Knotens. Dort klickst du in das gelbe Feld unter SSH-Keys und fügst den Schlüssel dort ein. Achte unbedingt darauf, dass der eingefügte Schlüssel in einer einzigen Zeile, also ohne Zeilenumbruch, steht. Mit einem Klick auf "Speichern" ist die Konfiguration auf dem Router abgeschlossen und du kannst zu dem Kapitel [https://wiki.freifunk-mainz.de/w/Howto/Per_SSH_auf_Freifunk_Router_verbinden#Einloggen_auf_dem_Freifunk-Knoten Einloggen auf dem Freifunk-Knoten] springen.

===Schlüsselpaar unter Linux erzeugen===
Anleitung folgt
===Schlüsselpaar unter Mac OS erzeugen===
Anleitung folgt

=Einloggen auf dem Freifunk-Knoten =
Im zweiten Schritt musst du die - wie oben beschrieben ermittelte - IPV6-Adresse deines Knotens eintragen. Den Rest übernimmt eigentlich das Tool. Zum Einloggen benötigst du natürlich dein Passwort, das du hoffentlich beim Konfigurieren des Knotens gesetzt (und dir gemerkt) hast.

Falls du kein Passwort gesetzt hast, kannst du dich nicht per SSH verbinden. Dann musst du den Router entweder nochmal in den Konfig-Modus starten und das Passwort in der Weboberfläche setzen. Oder du startest ihn in den Fail-Safe-Modus (da ist er nur per Telnet erreichbar) und setzt ein SSH-Passwort. Beides soll aber nicht Bestandteil dieser Anleitung sein.

==Windows: Putty==
[[Datei:putty1.png]]

Nach dem Verbinden mit dem user '''root''' und dem bei der Installation eingerichteten Passwort anmelden
==Android: JuiceSSH==
Installation aus Playstore. Angeben der o.g. Adresse.

Datei:PuTTYgenKeysEndeMarkiert.PNG

2015-06-21T12:57:01Z

Matthias: PuTTYgen mit markiertem öffentlichem Schlüssel

PuTTYgen mit markiertem öffentlichem Schlüssel

Datei:SSH GluonConfigSSH.png

2015-06-21T12:51:25Z

Matthias: Matthias lud eine neue Version von „Datei:SSH GluonConfigSSH.png“ hoch

Gluon Konfiguration für SSH Zugriff mittels Schlüsselpaar(SSH-Keys)

Datei:PuTTYgenPubkeySpeichern.PNG

2015-06-21T12:50:08Z

Matthias: Mit PuTTYgen den öffentlichen Schlüssel speichern

Mit PuTTYgen den öffentlichen Schlüssel speichern

Datei:PuTTYgenPrivkeySpeichern.PNG

2015-06-21T12:49:11Z

Matthias: Matthias lud eine neue Version von „Datei:PuTTYgenPrivkeySpeichern.PNG“ hoch

Mit PuTTYgen den privaten Schlüssel speichern

Datei:PuTTYgenPrivkeySpeichern.PNG

2015-06-21T12:48:32Z

Matthias: Matthias lud eine neue Version von „Datei:PuTTYgenPrivkeySpeichern.PNG“ hoch

Mit PuTTYgen den privaten Schlüssel speichern

Datei:PuTTYgenPrivkeySpeichern.PNG

2015-06-21T12:43:16Z

Matthias: Mit PuTTYgen den privaten Schlüssel speichern

Mit PuTTYgen den privaten Schlüssel speichern

Datei:PuTTYgenKeysEnde.PNG

2015-06-21T12:12:45Z

Matthias: PuTTYgen fertig ausgefüllt

PuTTYgen fertig ausgefüllt

Howto/Per SSH auf Freifunk Router verbinden

2015-06-21T11:31:08Z

Matthias: /* Schlüsselpaar unter Windows erzeugen */

Datei:PuTTYgenKeys.PNG

2015-06-21T11:28:27Z

Matthias: PuTTYgen mit generiertem Schlüsselpaar

PuTTYgen mit generiertem Schlüsselpaar

Howto/Per SSH auf Freifunk Router verbinden

2015-06-21T11:25:34Z

Matthias: /* Schlüsselpaar unter Windows erzeugen */

Howto/Per SSH auf Freifunk Router verbinden

2015-06-21T11:25:10Z

Matthias: /* Schlüsselpaar unter Windows erzeugen */

Datei:PuTTYgenRandomness.PNG

2015-06-21T11:24:44Z

Matthias:

Datei:PuTTYgenStart.PNG

2015-06-21T11:17:36Z

Matthias: PuTTYgen nach dem Start

PuTTYgen nach dem Start

Howto/Per SSH auf Freifunk Router verbinden

2015-06-21T11:14:26Z

Matthias: /* SSH Zugriff mittels Schlüsselpaar */

Datei:DownloadPuTTYgen.PNG

2015-06-21T11:13:49Z

Matthias: Download PuTTYgen von Homepage

Download PuTTYgen von Homepage

Datei:SSH GluonConfigSSH.png

2015-06-21T11:01:51Z

Matthias: Gluon Konfiguration für SSH Zugriff mittels Schlüsselpaar(SSH-Keys)

Gluon Konfiguration für SSH Zugriff mittels Schlüsselpaar(SSH-Keys)

Howto/Per SSH auf Freifunk Router verbinden

2015-06-21T10:59:50Z

Matthias: /* Knoten für den Zugriff per SSH vorbereiten */

Howto/Per SSH auf Freifunk Router verbinden

2015-06-21T10:57:06Z