Warnung: Dies ist eine frühe Version, bitte lies die Release Notes ALLER bisherigen Releases

OpenSOHO

Danke, dass du in Betracht ziehst, das Projekt zu unterstützen!

Dokumentation

OpenSOHO wurde entwickelt, um eine kleine Anzahl von OpenWRT-basierten Netzwerkgeräten zu verwalten. Daher stammt der Name SOHO von Small Office Home Office (SOHO) Networks.

• Von 2 bis 20 Geräten (es gibt keine harte Grenze)
• Keine Mandantenfähigkeit
• Kompatibel mit openwisp-config und openwisp-monitoring.
• Einfach bereitzustellen

Es ist von OpenWISP inspiriert, zielt aber auf Netzwerke ab, die zu klein sind, um mit OpenWISP verwaltet zu werden. Wie OpenWisp erwähnte:

Allerdings ist OpenWISP möglicherweise nicht die beste Wahl für sehr kleine Netzwerke (weniger als 20 Geräte), für Organisationen ohne IT-Kenntnisse oder für Unternehmen, die ausschließlich aus Kostengründen nach Open-Source-Alternativen suchen.

Die folgenden Versionen sind getestet

• OpenWRT 24.10.x DSA (Legacy-Unterstützung)
• OpenWRT 25.12.x DSA

Erste Schritte mit OpenSOHO

Überblick

Die Einrichtung von OpenSOHO erfordert einige einfache Schritte, die jeweils in den folgenden Abschnitten beschrieben werden:

• Installiere OpenSOHO auf deinem Server.
• Installiere die OpenWisp-Pakete auf deinen OpenWRT-Geräten.
• Konfiguriere OpenWisp auf jedem deiner OpenWRT-Geräte, um eine Verbindung zu OpenSOHO herzustellen.
• Beginne mit der Konfiguration in OpenSOHO!

OpenSOHO installieren

• Lade die neueste OpenSOHO-Version herunter (oder verwende einen Docker-Container)

  Releases

  Einrichtung mit Docker, Podman oder Kubernetes

• Starte OpenSOHO

Wähle zunächst ein gemeinsames Geheimnis (Shared Secret), das es den OpenWRT-Geräten (mittels openwisp-config) ermöglicht, sich bei OpenSOHO zu registrieren.

Wähle für optimale Sicherheit eine lange zufällige Zeichenkette.

Sie muss mit dem übereinstimmen, was du in den nächsten Schritten in LuCI konfigurierst.

OPENSOHO_SHARED_SECRET=randompassphrase ./opensoho serve --http 0.0.0.0:8090

Nun gibt OpenSOHO eine URL auf der Kommandozeile aus, mit der du das Admin-Konto erstellen kannst. Öffne die URL einfach in deinem Browser.

Alternativ kannst du das Admin-Konto über die Kommandozeile erstellen:

./opensoho superuser upsert EMAIL PASS

Konfigurieren (Übernehmen) der OpenWRT-Geräte

Installieren der OpenWISP-Pakete

opkg install openwisp-config openwisp-monitoring luci-app-openwisp # OpenWRT 24.10
apk add openwisp-config openwisp-monitoring luci-app-openwisp # OpenWRT 25.12+

Wenn Sie 802.11v-Client-Steering nutzen möchten, ist das vollständige wpad-mbedtls erforderlich.

Auf OpenWRT 24.10

opkg remove wpad-basic-mbedtls && \
opkg install wpad-mbedtls && \
service wpad restart

Auf OpenWRT 25.12+

apk del wpad-basic-mbedtls && \
apk add wpad-mbedtls && \
service wpad restart

Nachdem wpad-mbedtls installiert ist, versuchen Sie zuerst service restart wpad, andernfalls kann ein Neustart erforderlich sein, um auf die neue wpad-Binärdatei umzuschalten. Andernfalls erhalten Sie möglicherweise einen Fehler wie daemon.notice netifd: radio1 (28210): WARNING (wireless_add_process): executable path /usr/sbin/wpad does not match process 1842 path (/usr/sbin/wpad (deleted)). (Bitte beachten Sie, dass das 802.11v-Client-Steering noch in Arbeit ist)

OpenWISP in LuCI konfigurieren:

• Legen Sie nur die Server URL und das Shared secret fest.
  • Hängen Sie KEINEN Schrägstrich an die Server URL an. Eine Beispiel-URL: http://192.168.1.1:8090
  • Das Shared Secret ist der Wert, den Sie zuvor gewählt haben (OPENSOHO_SHARED_SECRET).
• Optional können Sie das Update Interval auf 30 Sekunden reduzieren, um schnellere Aktualisierungen zu erhalten. (OpenSOHO erledigt dies für Sie, falls nicht)
• OpenSOHO aktiviert außerdem die Überwachung und reduziert das Überwachungsintervall auf 15 Sekunden, um den Netzwerkstatus schneller zu aktualisieren.

Es wird dringend empfohlen, die Überwachung zu aktivieren, da OpenSOHO viele der aktuellen OpenWRT-Einstellungen ableitet und sie für eine einfache Konfiguration ausfüllt.

OpenSOHO konfigurieren

• Warten Sie, bis sich das/die OpenWrt-Gerät(e) mit dem Shared Secret selbst registrieren.
• Setzen Sie das Enabled-Flag des Geräts auf true.
• Setzen Sie numradios auf den korrekten Wert. Für ein 2,4 + 5-GHz-Gerät wäre dieser Wert beispielsweise 2.
• Richten Sie einen Wifi-Access-Point ein (SSID+KEY). Dieses Verfahren ermöglicht es OpenSOHO, die Funkkonfiguration bei der Geräteregistrierung korrekt zu erkennen.
• Hängen Sie den konfigurierten Wifi-Access-Point an ein Gerät an, damit es konfiguriert wird.
• Derzeit wird jedes Netzwerk automatisch auf allen Funkmodulen konfiguriert (konfiguriert über numradios).
• Optional können auch Leds ein- oder ausgeschaltet werden (vorerst nur statische Konfiguration).
• Die Konfiguration von Funkfrequenzen wird jetzt unterstützt. OpenSOHO liest die aktuelle Funkkonfiguration einmalig ein und stellt sie unter der Funkkonfiguration zur Verfügung. Es kann ein bis zwei Minuten dauern, bis die Funkkonfiguration erscheint (die Konfigurations- und Überwachungsschritte benötigen etwas Zeit).

Dashboard

OpenSOHO verfügt über ein einfaches Dashboard. Es ist über die Schaltfläche in der linken Seitenleiste direkt unter dem OpenSOHO-Logo erreichbar.

Bitte beachten Sie, dass dies nicht als Ersatz für fortgeschrittenere Grafikwerkzeuge gedacht ist; es ist und bleibt bewusst einfach gehalten.

Konfigurieren

OpenSoho ist jetzt über http://ipaddress:8090/_/ erreichbar

Es gibt mehrere Konfigurationssammlungen:

Clients

Dies sind die mit dem Wifi verbundenen Clients. Diese Tabelle ist schreibgeschützt, mit Ausnahme des Alias. Sie kann verwendet werden, um Geräten einen für Menschen lesbaren Namen zu geben. Dies funktioniert nur ordnungsgemäß, wenn der Client seine MAC-Adresse nicht randomisiert.

Verbundene Clients

Enthält die Liste der Clients, die derzeit mit Ihrem Wifi verbunden sind. Um die IP-Adresse des Geräts anzuzeigen, benötigt OpenSOHO Zugriff auf Ihre DHCP-Leases. Dazu muss der openwisp-Überwachungsdaemon auf dem Gerät laufen, das den DHCP-Server enthält. Geräte mit einer statischen IP erhalten keine IP. Dies ist eine bekannte Einschränkung in Version 0.12.0.

Geräte