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.

Dispositivi

Questi sono i dispositivi connessi.

• Usa enable/disable per disabilitare gli aggiornamenti di configurazione. Questo è utile per evitare di aggiornare tutti i dispositivi contemporaneamente. Il monitoraggio rimane attivo.
• Lo stato di salute è un campo di sola lettura. healthy significa che il dispositivo ha comunicato nell'ultimo minuto. Se non lo ha fatto, lo stato di salute diventa unhealthy e potrebbe esserci un problema con il dispositivo o la sua connessione.
• Leds consente di scegliere le configurazioni dei LED
• Numradios consente di impostare il numero di radio sul dispositivo. Questo valore non viene inizialmente inviato da OpenWisp, quindi deve essere impostato dall'utente.
• Wifis consente di selezionare gli SSID da applicare su questo dispositivo.

Leds

• Configurazione LED di base (più che altro una POC al momento)

Radio

• Consente di impostare la frequenza di ciascuna radio.
• La banda non dovrebbe essere modificata, poiché consente a OpenSOHO di verificare la configurazione delle frequenze. Ciò è necessario a causa delle limitazioni di PocketBase.

Wifi

• Consente di configurare vari SSID. La selezione delle modalità di crittografia è attualmente limitata. WEP e Open non sono supportati per scelta progettuale.

Monitoraggio

Monitoraggio dei dispositivi

Verifica che lo stato di salute del dispositivo sia healthy.

Client connessi

Questa vista mostra tutti i client wifi ancora connessi negli ultimi 30 secondi.

Integrazione con Home Assistant

Il monitoraggio di OpenSOHO può essere integrato con Home Assistant. (Maggiori informazioni) Questa API REST è progettata per l'uso con Home Assistant, ma può essere integrata anche con altri strumenti.

Risoluzione dei problemi

Ri-registrare un dispositivo

Se dopo aver cambiato il Server URL di OpenWISP in LuCI il dispositivo non sembra registrarsi correttamente con il nuovo controller. Per risolvere:

uci delete openwisp.http.uuid
uci delete openwisp.http.key
/etc/init.d/openwisp-config restart

Il primo SSID non viene abilitato

Sembra esserci un problema in OpenWRT per cui il primo SSID configurato su un dispositivo Wifi non viene abilitato automaticamente. Soluzione alternativa: fai clic sul pulsante di abilitazione in LuCI.

Sviluppatori

• Installa le dipendenze

go mod tidy

• Avvia OpenSOHO

Il segreto condiviso viene usato da openwisp-config per la registrazione. Scegli una stringa casuale lunga per una sicurezza ottimale.

Per eseguire i test unitari:

go test -cover -v -coverprofile=coverage.out
go tool cover -html=coverage.out

Ambito

Funzionalità

Alcune funzionalità di OpenWISP sono (attualmente) considerate fuori dall'ambito di OpenSOHO

• Aggiornamenti del firmware: OpenWRT non necessita di aggiornamenti frequenti; usa manualmente la funzione Attended sysupgrade su ciascun dispositivo.
• Multi-tenancy
• Template: OpenWISP dispone di un potente e versatile meccanismo di template; questo viene sostituito da un sottoinsieme di funzionalità più prescrittivo per offrire un'esperienza di configurazione più semplice.

Sviluppo

L'obiettivo è sfruttare pocketbase al massimo. È possibile apportare piccole modifiche poiché il back-end di pocketbase attualmente non dispone di un sistema di plugin. Ma l'obiettivo non è creare un fork di pocketbase, quindi l'unione delle modifiche upstream rimane semplice.

Rilascio

GITHUB_TOKEN=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa goreleaser release