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

OpenSOHO

Grazie per aver preso in considerazione il supporto al progetto!

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 massimo rigido)
• Nessun multi-tenancy
• Compatibile con openwisp-config e openwisp-monitoring.
• Semplice da distribuire

È ispirato a OpenWISP, ma mira a reti troppo piccole per essere gestite con OpenWISP. Come ha affermato OpenWisp:

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

Le seguenti versioni sono testate

• OpenWRT 24.10.x DSA (supporto legacy)
• OpenWRT 25.12.x DSA

Per iniziare con OpenSOHO

Panoramica

La configurazione di OpenSOHO richiede alcuni semplici passaggi, ciascuno dettagliato nelle sezioni seguenti:

• Installare OpenSOHO sul proprio server.
• Installare i pacchetti OpenWisp sui dispositivi OpenWRT.
• Configurare OpenWisp su ciascuno dei dispositivi OpenWRT per connettersi a OpenSOHO.
• Iniziare a configurare in OpenSOHO!

Installare OpenSOHO

• Scaricare l'ultima versione di OpenSOHO (oppure utilizzare un container docker)

  Rilasci

  Configurazione con Docker, Podman o Kubernetes

• Avviare OpenSOHO

Per prima cosa, scegliere un segreto condiviso che consenta ai dispositivi OpenWRT (tramite openwisp-config) di registrarsi su OpenSOHO.

Scegliere una stringa casuale lunga per una sicurezza ottimale.

Deve corrispondere a quanto si configura in LuCI nei passaggi successivi.

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

Ora, OpenSOHO restituisce sulla riga di comando un URL che consente di creare l'account amministratore. Basta aprire l'URL nel browser.

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

./opensoho superuser upsert EMAIL PASS

Configurazione (adozione) dei 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 si desidera utilizzare lo steering dei client 802.11v, è necessario il pacchetto completo wpad-mbedtls.

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. In caso contrario potresti ottenere 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)). (Tieni presente che il client steering 802.11v è ancora in fase di sviluppo)

Configurare OpenWISP in LuCI:

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

Si consiglia vivamente di abilitare il monitoring, poiché OpenSOHO deduce molte delle impostazioni correnti di OpenWRT e le compila per una facile configurazione.

Configurare OpenSOHO

• Attendi che i dispositivi OpenWrt si auto-registrino utilizzando il shared secret.
• Imposta il flag Enabled del dispositivo su true.
• Imposta numradios al valore corretto. Ad esempio, per un dispositivo 2.4 + 5GHz, questo valore sarebbe 2.
• Configura un access point Wifi (SSID+KEY). Questa procedura consente a OpenSOHO di rilevare correttamente la configurazione radio al momento della registrazione del dispositivo.
• Collega l'access point Wifi configurato a un dispositivo per farlo configurare.
• Attualmente ogni rete verrà configurata automaticamente su tutte le radio (configurate tramite numradios).
• Facoltativamente, è anche possibile accendere o spegnere i led (per ora solo configurazione statica).
• La configurazione delle frequenze radio è ora supportata. OpenSOHO legge la configurazione radio corrente una volta e la rende disponibile nella configurazione delle radio. Possono volerci uno o due minuti prima che la configurazione radio compaia (le fasi di configurazione e monitoring richiedono un po' di tempo per completarsi).

Dashboard

OpenSOHO include una dashboard di base. È accessibile tramite il pulsante nella barra laterale più a sinistra, subito sotto il logo OpenSOHO.

Tieni presente che questa non è intesa come sostituto di strumenti di graphing più avanzati; è e rimarrà di base per scelta.

Configurare

Ora è possibile accedere a OpenSoho tramite http://ipaddress:8090/_/

Ci sono diverse collezioni di configurazione:

Clients

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

Connected clients

Contiene l'elenco dei client attualmente connessi al tuo wifi. Per mostrare l'indirizzo IP del dispositivo, OpenSOHO necessita dell'accesso ai lease DHCP. Per farlo, è necessario avere il daemon di monitoring openwisp in esecuzione sul dispositivo che contiene il server DHCP. I dispositivi con IP statico non otterranno un IP. Questa è una limitazione nota a partire dalla 0.12.0.

Devices