Freifunk Dresden - Anwender-Wiki - Benutzerbeiträge [de]

Freifunk Server Handbuch

2015-12-04T02:13:53Z

Johannes: /* Vorausetzungen */

== Git-Repositories ==

Für den Betreiber eines Freifunk Servers (Vserver) gibt es ein GIT Repository. Dieses erlaubt das fast automatische Aufsetzen eines Freifunk Servers (für Internet-Gateway).

* https://github.com/ddmesh/vserver-base

Informationen dazu sind derzeit in der readme.md auf github gegeben, werden aber in Zukunft hier gepflegt.

Bitte beachtet die Hinweise für andere Communities, welche auf der Dresdner Installation basieren sollen (Repos: firmware/vserver-base clonen, aktueller Stand von vserver-base bezüglich der Verwendbarkeit).

== Basic Vserver ==
Dieses Repository bildet die minimale Funktionalität eines Servers für Freifunk Dresden. Der Vserver arbeitet wie ein Freifunk Knoten und ist soweit konfiguriert, dass dieser eine Knotenwebseite anbietet, Backboneverbindungen (vtund) akzeptiert und via Openvpn Internettunnel für den Internetverkehr aus dem Freifunknetz aufbauen kann.

HINWEIS: Der Vserver ist auf Freifunk Dresden zugeschnitten. Soll dieses als Basis für andere Freifunk Communities
verwendet werden, müssen Anpassungen gemacht werden.

=== Vorausetzungen ===
Folgend sind die Vorausetzungen aufgeführt für das das Git Repository gedacht ist:
* Linux: Ubuntu Minimal Server (64bit) Ubuntu 14.04.3 LTS
* Netzwerk: min. 100Mbit/s Wenn weniger so sollte man nicht soviele Tunnel aufbauen und die bekanntgegebene Gateway-Geschwindigkeit in ''/etc/nvram.conf'' reduzieren. Das sollte man einfach über einen längeren Zeitraum beobachten und den niedrigstens Wert verwenden. Dazu aber den Traffic von verschiedenen Knoten aus testen!
batman_gateway_class="4mbit/4mbit"
* Kernel Module: tun.ko muss vorhanden sein. Evt sollte man sich vorher beim VServer Anbieter informieren. Nicht alle Anbieter haben einen Support im Kernel. Genutzt wird es vom Routing Protokoll, Backbone, Openvpn
* Speicher: mind. 512Mbyte RAM, 1GByte Swap Auf solchen systemen ist die Auslastung aber schon recht hoch, so dass oft Swap benutzt wird, was sehr nachteilig ist. Auf einen 512Mbyte System sollten maximal 50 Backbone tunnel (siehe nvram.conf) verwendet werden. Wenn möglich, sollten mind. '''1 Gbyte RAM, 2Gbyte Swap''' zurverfügung stehen.
* Virtualisierung: Wird der Freifunk Server auf einem virtuellen Server aufgesetzt, so funktionieren als Virtualisierungen '''KVM''', '''XEN''' und '''LXC''' sehr gut.

=== Installation ===
Schritte: 

# Bringe Ubuntu auf die aktuelle Version. Das geht bei Ubuntu Schrittweise von Version zu Version (https://help.ubuntu.com/community/UpgradeNotes). Wähle dafür aber die "server-⁠variante" (nicht desktop).
# Folgends cloned das Repository. Bitte verwendet eurer eignes geclontes Repository.
mkdir /⁠root/⁠freifunk
cd /⁠root/⁠freifunk
apt-⁠get install git
git clone git@github.com:ddmesh/vserver-base.git
cd freifunk-base
./⁠vserver-⁠install.sh

Es werden einige Pakete nachinstalliert, Files kopiert und am Ende noch einige Tools compiliert. Wenn das fertig ist, müssen Community-Spezifische Dinge angepasst werden:
*ddmesh-ipcalc.sh
*/etc/nvram.conf
*/etc/hostname
*/etc/issuer.net
*/etc/openvpn/....

Da hier ein Git Repository verwendet wird, kann dieses ab und zu updates erhalten (git pull). Diese Änderungen müssen dann allerdings manuell übernommen werden.

=== Hinweise ===
* '''Git''': Es empfielt sich dringend für andere Communities, dieses Repository zu clonen, da hier generelle Umstellungen zusammen mit der passenden Firmware für Dresnder Anforderungen erfolgen. Communities sollten dann auf das geclonte Repository (gilt auch für das "firmware" Repository) aufbauen. Jede Community trägt die alleinige Verantwortung und Kontrolle über ihr Netz und sollte eigene Erfahrene Leute/Admins bereitstellen. Hilfe von Dresden ist aber jederzeit möglich, aber Administrative Aufgaben oder Garantien werden nicht übernommen, da das einfach den organisatorischen Aufwand sprengt. Wir wissen selber nicht, wie sich das Netz in Zukunft noch verhält, wenn dieses weiter wächst.

* '''Routingprotokoll BMXD''': Diese Protokoll wurde anstelle von bmx6 oder bmx-advanced aus verschiedenen Gründen gewählt (siehe http://wiki.freifunk-dresden.de/). Es wird vom eigentlich Author nicht mehr weiterentwickelt oder gepflegt. Für Dresden habe ich einige Fehler behoben.

* '''Anpassungen''': Speziell gilt das für den IP Bereich und der Knotenberechnung. Aus Knotennummern werden mit ddmesh-ipcalc.sh alle notwendigen IP Adressen berechnet (http://wiki.freifunk-dresden.de/index.php/Technische_Information#Berechnung_IP_Adressen). Freifunk Dresden verwendet zwei IP Bereiche, eines für die Knoten selber (10.200.0.0/16) und eines für das Backbone (10.201.0.0/16). Dieses ist technisch bedingt. Wird bei freifunk.net nur ein solcher Bereich reserviert (z.b. 10.13.0.0/16), so muss das Script ddmesh-ipcalc.sh in der Berechnung angepasst werden, so dass zwei separate Bereich entstehen. Die Bereiche für 10.13.0.0/16 würden dann 10.13.0.0/17 und 10.128.0.0/17 sein.
* Das '''Script ddmesh-ipcalc.sh''' wird ebenfalls in der Firmware verwendet, welches dort auch angepasst werden muss. In der Firmware gibt es zwei weitere Stellen, die dafür angepasst werden müssen. Das sind /www/nodes.cgi und /www/admin/nodes.cgi. Hier wurde auf den Aufruf von ddmesh-ipcalc.sh verzichtet und die Berechnung direkt gemacht, da die Ausgabe der Router-Webpage extrem lange dauern würde.

* In '''/etc/nvram.conf''' werden die meisten Einstellungen für den Vserver hinterlegt. Evt. kann noch /etc/issuer.net und /etch/hostname angepasst werden, was beim Betreiben von mehreren Vservern hilfreich ist.

* '''Backbone''': Weiterhin verwendet das Freifunk Dresden Netz als Backbone-VPN Tool noch vtund. Dieses wird sich aber in Zukunft ändern, wobei dann vermutlich fastd eingesetzt wird (für welches noch notwenige Funktionalitäten fehlen).

* '''Internet Tunnel''': /etc/openvpn enthält ein Script, mit dem verschiede Openvpn Konfiguration von Tunnelanbietern so aufbereitet werden, das diese für Freifunk Dresden richtig arbeiten. Wie in der Firmware läuft per cron.d ein Internet-check, der in der ersten Stufe das lokale Internet testet und wenn dieses funktioniert, wird das Openvpn Internet geprüft. Ist das Openvpn Internet verfügbar, wird dieser Vserver als Internet-Gateway im Freifunknetz bekannt gegeben.

* '''DNS''': Der Vserver arbeitet als DNS Server für die Knoten, die ihn als Gateway ausgewählt haben. Der Vserver leitet allerdings die DNS Anfragen nicht über den Openvpn Tunnel, sondern geht direkt über den VServer Anbieter raus.

* '''ICVPN''': Für ICVPN wird eigentlich alles installiert, aber ich habe dieses noch nicht mit dieser Installation getestet, da es ein Extra-Service ist und nicht auf jedem VServer in einem Netz aktiv sein braucht. Es gibt ein script, welches ebenfall dafür angepasst werden muss /etc/quagga/gen-bgpd.conf. Dieses Script greift auf github (wo alle Communities ihre Daten hinterlegen) und erzeugt entsprechende eine Konfiguration. Einfach mal damit experiementieren. Hilfreich sind hier die Befehle "ip rule" und "ip route list table zebra". Alternativ gibt es noch andere bgp Daemons, die von anderen Freifunk Communities verwendet werden (bird). Damit habe ich aber noch keine Experimente gemacht. Scripte für die Generierung von Konfigurationsfiles für bird gibt es auch irgendwo im Github.

* '''Server Anbieter''': Da Server Anbieter verschieden sind, kann die Installation abbrechen. Hier sollten erfahrene Leute die Installation anpassen und mir einen Hinweis geben. Als VServer kann NICHT jeder Anbieter genutzt werden. Wichtig ist, dass '''tun/tap devices''' und alle möglichen iptables module möglich sind. IPv6 ist nicht notwendig, da das Freifunk Netz in Dresden nur IPv4 unterstütz (Platzmangel auf Routern, bmxd unterstützt dieses nicht)

== Server-Anbieter ==
Im Laufe der Zeit haben wir bei vielen Anbietern Server für den Freifunk Dresden gebucht. Einige unserer Erfahrungen mit den verschiedenen Produkten sammeln wir hier.

=== 1&1 ===
* URL: https://hosting.1und1.de/vserver-tarife

==== „Virtual Server Linux Student“ (nicht empfohlen) ====
* Anbindung: 100 Mbit/s
* Preis: 1,00€ (monatlich kündbar)
* Besonderheitem: Prozessanzahl auf 128 limitiert

Im Rahmen des Studentenangebotes [https://www.campus-code.de „Campus-Code“] bot 1&1 einen Vserver für nur 1€ monatlich an. Dieser eignet sich allerdings nur für Testzwecke oder als Backbone-Server für eine sehr kleine Anzahl an Knoten, da die Anzahl der laufenden Prozesse auf nur 128 (''numproc'') [http://www.techdudes.de/1278/campus-code-11-vserver-l/ limitiert] ist. Durch das Erreichen des Prozesslimits läuft der Server regelmäßig fehlerhaft oder ist nicht mehr erreichbar und muss über das Vserver-Control-Panel neu gestartet werden. Ein halbwegs stabiler dauerhafter Betrieb ist nur bei 15-20 Backbone-Verbindungen möglich. (Stand 10/2015)

=== Netcup ===
* URL: https://www.netcup.de/vserver

==== „Root-Server S“ ====
* Virtualisierung: KVM
* Anbindung: 100 Mbit/s
* Preis: 4,99€ (monatlich kündbar)
* Besonderheiten: Drosselung bei Überschreitung von 80 Mbit/s Bandbreite

Netcup [https://forum.netcup.de/administration-eines-server-vserver/vserver-server-kvm-server/7471-fragen-zur-traffic-bremse/ drosselt Vserver], wenn diese über einen Zeitraum von 15 Minuten eine durchschnittliche Bandbreite von über 80 Mbit/s belegen. Die Drosselung erfolgt ohne Vorwarnung auf ca. 50KB/s, wodurch der Server praktisch unbenutzbar wird. Erst auf Nachfrage erfährt man vom Support von der Drosselung, die zumindest bei uns auf Bitte wieder rückgängig gemacht wurde. Falls man diesen Server für Freifunk sinnvoll nutzen möchte, sollte man selbst sicherstellen, dass die beanspruchte Bandbreite stets unter 80 Mbit/s bleibt. (Stand 10/2015)

==== „Root-Server L“ ====
* Virtualisierung: KVM
* Anbindung: 1 Gbit/s
* Preis: 18,99€ (monatlich kündbar)
* Besonderheiten: Drosselung bei Überschreitung von 80 Mbit/s Bandbreite

Laut Netcup liegt bei den Gigabit-Servern eine durchschnittliche Bandbreite von nur 200 Mbit/s an. Wie beim [[Freifunk_Server_Handbuch#.E2.80.9ERoot-Server_S.E2.80.9C|„Root-Server S“]] gilt außerdem die selbe Regelung für die Überschreitung der 80-Mbit/s-Grenze. (Stand 10/2015)

=== ispOne business (nicht empfohlen) ===
* URL: http://www.ispone-business.de
Trotz Internetflat werden Server abgeschaltet, gedrosselt oder sind drei Tage überhaupt nicht erreichbar (Traffic < 5TB/Monat). Der Support war anfänglich okay, aber seitdem vermutlich die Serverlast und der Datenverkehr zugenommen hat, wird nicht mehr auf Supportanfragen reagiert und behauptet, dass der Server gehackt wurde. Fragen nach Begrenzungen (um diese eventuell selber zuzusichern) bleiben unbeantwortet. Monatsverträge werden vonseiten ispOne ohne Begründung gekündigt. Man erfährt dies nur durch eine "Kündigungsbestätigung".

Router einrichten

2015-11-13T21:28:18Z

Johannes: /* Zusätzliche Backbone */

== Vorbereitung ==
Wir unterstützen eine ganze Reihe verschiedener Router von verschiedenen Herstellern. Dies bedeutet allerdings nicht, dass die Firmware auch auf allen Geräten funktioniert, folgende Geräte haben wir im Einsatz und werden von uns [[Router|empfohlen]].

== Firmware herunterladen ==
Nachdem du einen Router herausgesucht hast, musst du dir die Firmware besorgen.
[[Datei:Beispiel_Typ_Model841.PNG|200px|thumb|right|]]
Der Router-Typ und die Hardware-Version stehen auf der Rückseite des Routers.
In diesem Beispiel handelt es sich um das Model '''„WR841“''' in der '''Version 8'''.2.
Hier gibt es die dazu passende Firmware: http://download.freifunk-dresden.de/firmware/latest/ar71xx/

Es gibt zwei verschiedene Firmware-Dateien. Wenn die originale Firmware noch auf dem Router ist, so muss die Datei mit '''"factory"''' im Namen verwendet werden. Diese überschreibt alle alten Daten. Ist bereits eine Dresdner Freifunk Firmware auf dem Router vorhanden, wird die Datei mit ''"sysupgrade"'' verwendet.

In unserem Beispiel mit der Original Firmware wäre das:

openwrt-ar71xx-generic-'''tl-wr841'''n-'''v8'''-squashfs-'''factory'''.bin
openwrt-ar71xx-generic-tl-wr841n-v8-squashfs-sysupgrade.bin
 

Wir wählen die Datei mit „*'''wr841n'''-'''v8'''-squashfs-'''factory'''*“ (im Falle eines TP-Link 841 Version 8) und laden sie herunter.
 
Im Folgenden gilt die Anleitung für die getesteten TP-Link Router (841, 1043, 3600, 4300), die Einrichtung einer Ubiquiti Nanostation M2 (loco) hat ein paar wenige Besonderheiten:, siehe: [[Router_einrichten_Nanostation|Nanostation Besonderheiten]].

== Firmware einspielen ==
[[Datei:Model841 Gelber Port.PNG|200px|thumb|right|]] [[Datei:TPLink841DefaulPW.PNG|200px|thumb|right|]]
Stecke dafür das Kabel in eine der gelben Buchsen, die blaue brauchst du erst später.

Jetzt kannst du den Router einfach über den Browser konfigurieren.

Dazu rufst du in deinem Browser folgende Adresse auf: http://192.168.0.1 ''(Bei anderen Geräten von TP-Link, z.B. dem Accesspoint 701 ist die IP anders, im Beispiel des 701er ist es die 192.168.0.254, die Anleitung des jeweiligen Gerätes ist dabei sehr hilfreich)
''

Auf der Rückseite steht der Username und das Passwort, in diesem Fall admin + admin.

[[Datei:841SystemtoolsFirmwareUpdate.PNG|200px|thumb|right|]]
Unter "'''System Tools'''" -> "'''Firmwareupgrade'''"

Per "'''Browse...'''" das zuvor geladene File auswählen und das "'''Upgrade'''" einspielen.

Mindestens 2 Minuten warten, der Router startet mehrfach neu.

== Autosetup ==

Sollte ein weiter Freifunkrouter mit Internet in der Nähe sein, baut sich automatisch eine Verbindung auf. Ist kein weiter Freifunkrouter in der Nähe, muss jetzt ein LAN-Kabel den blauen WAN-Port des Freifunkrouters ↔ mit dem LAN-Port des Heimrouters(DSL oder Kabel) verbinden.

Du hast jetzt die Möglichkeiten dich per

* LAN Port des Freifunkrouters, im Browser: http://192.168.1.1
** Wenn der selbe Rechner zuvor am Freifunkrouter hing, hat er wahrscheinlich noch eine 192.168.0.x Adresse. In diesem Fall muss der Rechner seine IP "vergessen" und eine neue anfordern. Dies passiert bei einem Neustart automatisch oder z.B. unter Windows mit den Kommandos:
** '''ipconfig /release''' und '''ipconfig /renew''' im Windows CLI (''Windowstaste+R''; '''cmd''')

* Oder per Freifunk-WLAN, im Browser: http://192.168.252.1
** Splash (Vorschaltseite) muss im Browser bestätigt werden

in den Freifunkrouter einzuloggen.

Zum Login verwendest du als Nutzer „'''root'''“ und das Passwort „'''admin'''“

Nach der ersten Anmeldung, wirst du zur Änderung des Passwortes aufgefordert.
Passwörter dürfen Buchstaben, Zahlen, Satzzeichen enthalten.

Bei der ersten Installation muss der Auto-Setup durchgeführt werden.

Menü: '''Allgemein → Auto-Setup'''

Damit versucht der Router sich eine Knotennummer vom Server zu holen. Wenn das erfolgreich war, startet der Router erneut und ist unter der neuen IP (10.200,x.x) im Freifunknetz erreichbar. Falls der Router kein Internet zu diesem Zeitpunkt hat, so arbeitet dieser mit einer temporären Knotennummer bis Internet erkannt wurde.

Diese IP kann im Router '''Verwaltung → Expert → WIFI''' ermittelt werden.

== Kontakt und GPS-Daten ==

Unter '''Allgemein''' → '''Kontaktinfos'''

Kontaktinformationen geben den Nutzern und anderen Freifunkern die Möglichkeit bei Problemen den Routerbetreiber zu kontaktieren.

Die GPS Koordinaten und Kontaktinformationen werden von www.freifunk-dresden.de von jedem Router regelmäßig abgefragt und zur Generierung der Netzwerktopology und Hotspot-Liste verwendet. Allerdings kann der Server nur die erreichbaren Knoten abfragen.

Die GPS Daten des eigenen Standortes kann man mit Google Maps (durch Linksklick) ermitteln: https://www.google.de/maps/@51.0686388,13.7468424,13z

== Zusätzliche Backbone ==

Bei Freifunkroutern die direkt ans Internet angeschlossen sind, ist es möglich bis zu 5 VPN Server oder Clients einzutragen. Der Router kann so mit dem Freifunk Netz verbunden werden, wenn kein anderer Freifunk-Router in Funkreichweite ist.

Die Einstellungen dazu findest du unter '''Expert''' → '''Backbone'''.

Es existiert eine Liste [[Freifunk_Netzwerk|verfügbarer VPN-Server]], die eine Spalte enthält, welche Knotennummern diese VPN-Server nutzen können.

Die Auswahl des besten VPN-Servers erfolgt automatisch.

Bei Routern ohne eigenes Internet erfolgt die Suche nach dem besten Weg ins Internet ebenfalls automatisch. Hier ist keine Eintragung notwendig.

== Schema Freifunk ==

[[Datei:Freifunk_Schema.PNG|center|]]

Geflüchtetenunterkünfte

2015-11-06T18:55:35Z

Johannes: Informationen und Kontaktmöglichkeiten von Internet4Refugees

Freifunk wird auch in zahlreichen Dresdner Unterkünften für Geflüchtete bereitgestellt. Der kostenlose Zugang zu WLAN kommt sowohl den Bewohnern der Unterkünfte als auch Mitarbeitern, Gästen, Nachbarn und Passanten zugute.

== Unterstützung ==
Es gibt viele Möglichkeiten, die Dresdner Freifunk-Initiative bei der Bereitstellung von WLAN in Geflüchtetenunterkünften zu unterstützen:

* Du bist Betreiber einer Geflüchtetenunterkunft und kannst einen Internetanschluss (oder auch nur einen Aufstellort und Strom) zur Verfügung stellen? Wir kümmern uns um den Rest wie z. B. die Hardware und erklären dir, warum du mit der Bereitstellung von Freifunk für die Bewohner kein Haftungsrisiko eingehst.
* Du wohnst oder arbeitest in der Nähe einer Unterkunft und möchtest einen Teil des Internetanschlusses für Geflüchtete zur Verfügung stellen? Dann stelle bei dir einen Freifunk-Router auf und hilf mit bei der Versorgung mit WLAN von außen.

Melde dich bei Hifsangeboten oder Fragen einfach unter '''freifunk[ät]freifunk-dresden.de'''!

== Liste der mit Freifunk versorgten Geflüchtetenunterkünfte ==
[[Datei:Schnorrstrasse 2015-09-24.JPG|miniatur|EAE Schnorrstraße]]
* [https://www.willkommen-in-loebtau.de/tag/t8/ Wohnheim „T8“ Tharandter Straße] (seit [https://www.willkommen-in-loebtau.de/2015/10/16/internetzugang-dank-freifunk-in-loebtau-und-stetzsch/ 05/2015])
* EAE Nöthnitzer Straße (seit [https://twitter.com/ddmesh/status/646692621486788608 09/2015])
* EAE Schnorrstraße (seit [https://twitter.com/ddmesh/status/647091845428834304 09/2015])
* [https://www.facebook.com/pages/Wohnheim-Lindenhof/947497858606067 Wohnheim Lindenhof] (seit [https://twitter.com/ddmesh/status/653920265076887553 10/2015])
* Wohnheim in Röhrsdorf/Dohna (seit 10/2015)
* EAE Prohlis (seit [https://twitter.com/ddmesh/status/657183362004701185 10/2015])
* Wohnheim Katharinenstraße (seit 10/2015)
* Wohnheim Buchenstraße (seit 11/2015)

== Informationen und Kontaktmöglichkeiten von Internet4Refugees ==

Öffentliche Informationen gibt es auf
* [http://it4refugees.noblogs.org/ http://it4refugees.noblogs.org/]
* [https://www.facebook.com/it4refugees/ https://www.facebook.com/it4refugees/]

Mails bitte an '''internet-for-refugees[ät]lists.c3d2.de'''

=== Koordinierung ===

Zur Kommunikation nutzen wir eine [https://lists.c3d2.de/cgi-bin/mailman/listinfo/internet-for-refugees Mailingliste] sowie den [https://www.c3d2.de/muc.html MUC (Jabber-Raum)] refugees@chat.c3d2.de.

Eine vollständige, regelmäßig gepflegte Liste mit allen uns bekannten (auch noch nicht versorgten) Unterkünften, dem aktuellen Status und Kontaktpersonen findet sich im internen Pad von Internet4Refugees.

Verifizierte, aktive Freifunker bekommen gerne den Zugang.

Bitte lasst uns untereinander wissen, woran wir gerade arbeiten. Dann müssen wir nicht die selben Probleme 2mal lösen.