Attenzione: questa è una versione preliminare; si prega di leggere le note di rilascio di TUTTE le versioni rilasciate fino ad ora

OpenSOHO

Documentazione

OpenSOHO è progettato per gestire un piccolo numero di dispositivi di rete basati su OpenWRT. Da qui il nome SOHO, da Small Office Home Office (SOHO) Networks.

Da 2 a 20 dispositivi (non esiste un limite rigido)
Nessuna multi-tenancy
Compatibile con openwisp-config e openwisp-monitoring.
Semplice da distribuire

È ispirato a OpenWISP, ma è pensato per reti troppo piccole per essere gestite con OpenWISP. Come afferma OpenWISP:

Tuttavia, OpenWISP potrebbe non essere la soluzione ideale per reti molto piccole (meno di 20 dispositivi), organizzazioni prive di competenze IT o aziende che cercano alternative open-source esclusivamente per ridurre i costi.

Le seguenti versioni sono testate:

OpenWRT 24.10.x DSA
OpenWRT 25.12.x DSA (supporto beta)

Per iniziare con OpenSOHO

Panoramica

La configurazione di OpenSOHO richiede alcuni semplici passaggi, ciascuno descritto in dettaglio nelle sezioni seguenti:

Installa OpenSOHO sul tuo server.
Installa i pacchetti OpenWisp sui tuoi dispositivi OpenWRT.
Configura OpenWisp su ciascuno dei tuoi dispositivi OpenWRT per connetterli a OpenSOHO.
Inizia a configurare in OpenSOHO!

Installa OpenSOHO

Scarica l'ultima versione di OpenSOHO (oppure usa un container Docker)

Release

Configurazione con Docker, Podman o Kubernetes
Avvia OpenSOHO

Per prima cosa, scegli un segreto condiviso che consenta ai dispositivi OpenWRT (usando openwisp-config) di registrarsi presso OpenSOHO.

Scegli una stringa casuale lunga per una sicurezza ottimale.

Deve corrispondere a ciò che configurerai in LuCI nei passaggi successivi.

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

Ora OpenSOHO mostra un URL nella riga di comando che ti permette di creare l'account amministratore. Apri semplicemente l'URL nel tuo browser.

In alternativa, crea l'account amministratore tramite la riga di comando:

./opensoho superuser upsert EMAIL PASS

Configurare (adottare) i dispositivi OpenWRT

Installare i pacchetti OpenWISP

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

Se vuoi usare il client steering 802.11v, è necessario il pacchetto wpad-mbedtls completo.

Su OpenWRT 24.10

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

Su OpenWRT 25.12+

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

Dopo aver installato wpad-mbedtls, prova prima service restart wpad; altrimenti potrebbe essere necessario un riavvio per passare al nuovo binario wpad. Se non lo fai, potresti ricevere un errore come daemon.notice netifd: radio1 (28210): WARNING (wireless_add_process): executable path /usr/sbin/wpad does not match process 1842 path (/usr/sbin/wpad (deleted)). (Si prega di notare che il client steering 802.11v è ancora un lavoro in corso)

Configura OpenWISP in LuCI:

Imposta solo Server URL e Shared secret.
- NON aggiungere una barra finale a Server URL. Un esempio di URL: http://192.168.1.1:8090
- Il segreto condiviso è il valore scelto in precedenza (OPENSOHO_SHARED_SECRET).
Facoltativamente, abbassa Update Interval a 30 secondi per aggiornamenti più rapidi. (OpenSOHO lo fa per te se non lo fai)
OpenSOHO abilita anche il monitoraggio e abbassa l'intervallo di monitoraggio a 15 secondi per aggiornamenti più rapidi dello stato della rete.

È vivamente consigliato abilitare il monitoraggio, poiché OpenSOHO deduce molte delle attuali impostazioni OpenWRT e le inserisce automaticamente per semplificare la configurazione.

Configura OpenSOHO

Attendi che i dispositivi OpenWrt si auto-registrino utilizzando il segreto condiviso.
Imposta il flag Enabled del dispositivo su true.
Imposta numradios sul valore corretto. Ad esempio, per un dispositivo 2.4 + 5GHz, questo valore sarebbe 2.
Configura un punto di accesso Wifi (SSID+KEY). Questa procedura consente a OpenSOHO di rilevare correttamente la configurazione radio al momento della registrazione del dispositivo.
Collega il punto di accesso Wifi configurato a un dispositivo per applicarne la configurazione.
Attualmente ogni rete verrà configurata automaticamente su tutte le radio (configurate tramite numradios).
Facoltativamente, i LED possono anche essere accesi o spenti (solo configurazione statica per ora).
La configurazione delle frequenze radio è ora supportata. OpenSOHO legge la configurazione radio corrente una volta e la rende disponibile nella configurazione delle radio. Possono essere necessari uno o due minuti prima che la configurazione radio compaia (i passaggi di configurazione e monitoraggio richiedono un po' di tempo per essere completati).

Pannello di controllo

OpenSOHO include un pannello di controllo di base. È accessibile tramite il pulsante nella barra laterale all'estrema sinistra, subito sotto il logo OpenSOHO.

Si prega di notare che questo non è pensato per sostituire strumenti di grafici più avanzati; è e rimarrà volutamente semplice.

Configurazione

OpenSoho è ora accessibile all'indirizzo http://ipaddress:8090/_/

Esistono diverse collezioni di configurazione:

Client

Questi sono i client connessi al Wifi. Questa tabella è di sola lettura, tranne che per l'alias. Può essere usata per dare ai dispositivi un nome leggibile. Funziona correttamente solo quando il client non randomizza il proprio indirizzo MAC.

Client connessi

Contiene l'elenco dei client attualmente connessi al tuo wifi. Per mostrare l'indirizzo IP del dispositivo, OpenSOHO deve avere accesso ai tuoi lease DHCP. Per fare ciò, è necessario che il demone di monitoraggio openwisp sia in esecuzione sul dispositivo che contiene il server DHCP. I dispositivi con IP statico non riceveranno un IP. Questa è una limitazione nota a partire dalla versione 0.12.0.

opensoho v0.15.0