Warnung: Dies ist eine frühe Version. Bitte lesen Sie die Versionshinweise ALLER bisherigen Versionen.

OpenSOHO

Dokumentation

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

• Von 2 bis 20 Geräten (es gibt keine harte Grenze)
• Keine Multi-Tenancy
• 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ähnt:

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

Die folgenden Versionen werden getestet:

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

Erste Schritte mit OpenSOHO

Übersicht

Das Einrichten von OpenSOHO erfordert einige einfache Schritte, die in den folgenden Abschnitten detailliert beschrieben werden:

• Installieren Sie OpenSOHO auf Ihrem Server.
• Installieren Sie die OpenWisp-Pakete auf Ihren OpenWRT-Geräten.
• Konfigurieren Sie OpenWisp auf jedem Ihrer OpenWRT-Geräte, um eine Verbindung zu OpenSOHO herzustellen.
• Beginnen Sie mit der Konfiguration in OpenSOHO!

Install OpenSOHO

• Laden Sie die neueste OpenSOHO-Version herunter (oder verwenden Sie einen Docker-Container)

  Versionen

  Einrichtung mit Docker, Podman oder Kubernetes

• Starten Sie OpenSOHO

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

Wählen Sie eine lange, zufällige Zeichenfolge für optimale Sicherheit.

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

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

Nun gibt OpenSOHO eine URL in der Befehlszeile aus, mit der Sie das Administratorkonto erstellen können. Öffnen Sie einfach die URL in Ihrem Browser.

Alternativ können Sie das Administratorkonto über die Befehlszeile erstellen:

./opensoho superuser upsert EMAIL PASS

Konfigurieren (Adoptieren) 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 verwenden möchten, ist das vollständige wpad-mbedtls erforderlich.

Unter OpenWRT 24.10

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

Unter OpenWRT 25.12+

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

Nach der Installation von wpad-mbedtls versuchen Sie zunächst service restart wpad, da sonst ein Neustart erforderlich sein kann, um zur neuen wpad-Binärdatei zu wechseln. 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 802.11v Client-Steering noch in Arbeit ist.)

Konfigurieren von OpenWISP in LuCI:

• Setzen Sie nur die Server-URL und das Shared Secret.
  • Fügen Sie KEINEN Schrägstrich an die Server-URL an. Beispiel-URL: http://192.168.1.1:8090
  • Das Shared Secret ist der zuvor gewählte Wert (OPENSOHO_SHARED_SECRET).
• Optional können Sie das Update-Intervall auf 30 Sekunden senken, um schnellere Updates zu erhalten. (OpenSOHO erledigt dies für Sie, wenn Sie es nicht tun.)
• OpenSOHO aktiviert auch die Überwachung und senkt das Überwachungsintervall auf 15 Sekunden für schnellere Aktualisierungen des Netzwerkstatus.

Es wird dringend empfohlen, die Überwachung zu aktivieren, da OpenSOHO viele der aktuellen OpenWRT-Einstellungen ableitet und zur einfachen Konfiguration ausfüllt.

Konfigurieren von OpenSOHO

• 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 wahr.
• Setzen Sie numradios auf den korrekten Wert. Bei einem 2,4+5-GHz-Gerät wäre dieser Wert beispielsweise 2.
• Richten Sie einen WLAN-Zugangspunkt (SSID+KEY) ein. Dieses Verfahren ermöglicht es OpenSOHO, die Funkkonfiguration bei der Geräteregistrierung korrekt zu erkennen.
• Hängen Sie den konfigurierten WLAN-Zugangspunkt an ein Gerät an, um es zu konfigurieren.
• Derzeit wird jedes Netzwerk automatisch auf allen Funkgeräten konfiguriert (konfiguriert mittels numradios).
• Optional können LEDs ein- oder ausgeschaltet werden (derzeit nur statische Konfiguration).
• Das Konfigurieren von Funkfrequenzen wird jetzt unterstützt. OpenSOHO liest die aktuelle Funkkonfiguration einmal aus und stellt sie unter der Radios-Konfiguration zur Verfügung. Es kann ein bis zwei Minuten dauern, bis die Funkkonfiguration erscheint (die Konfigurations- und Überwachungsschritte benötigen etwas Zeit).

Dashboard

OpenSOHO wird mit einem einfachen Dashboard geliefert. Es ist über den Button in der linken Seitenleiste direkt unter dem OpenSOHO-Logo erreichbar.

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

Konfiguration

OpenSoho kann nun über http://ipaddress:8090/_/ aufgerufen werden.

Es gibt mehrere Konfigurationssammlungen:

Clients

Dies sind die mit WLAN verbundenen Clients. Diese Tabelle ist schreibgeschützt, mit Ausnahme des Alias. Er kann verwendet werden, um Geräten einen 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 WLAN verbunden sind. Um die IP-Adresse des Geräts anzuzeigen, benötigt OpenSOHO Zugriff auf Ihre DHCP-Leases. Dazu muss der openwisp-monitoring-Daemon 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 ab Version 0.12.0.

Geräte