rubenbe/opensohoPiattaforma leggera di gestione dispositivi OpenWRT per piccole reti. Configurazione centralizzata, monitoraggio e gestione WiFi per 2–20 dispositivi con distribuzione semplice e compatibilità OpenWISP.
Attenzione: questa è una versione preliminare; si prega di leggere le note di rilascio di TUTTE le versioni rilasciate fino ad ora
OpenSOHO
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.
È 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:
La configurazione di OpenSOHO richiede alcuni semplici passaggi, ciascuno descritto in dettaglio nelle sezioni seguenti:
Scarica l'ultima versione di OpenSOHO (oppure usa un container Docker)
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
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)
Server URL e Shared secret.
Server URL. Un esempio di URL: http://192.168.1.1:8090OPENSOHO_SHARED_SECRET).Update Interval a 30 secondi per aggiornamenti più rapidi. (OpenSOHO lo fa per te se non lo fai)È vivamente consigliato abilitare il monitoraggio, poiché OpenSOHO deduce molte delle attuali impostazioni OpenWRT e le inserisce automaticamente per semplificare la configurazione.
Enabled del dispositivo su true.numradios sul valore corretto. Ad esempio, per un dispositivo 2.4 + 5GHz, questo valore sarebbe 2.numradios).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.
OpenSoho è ora accessibile all'indirizzo http://ipaddress:8090/_/
Esistono diverse collezioni di configurazione:
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.
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.
Questi sono i dispositivi connessi.
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.Verifica che lo stato di salute del dispositivo sia healthy.
Questa vista mostra tutti i client wifi ancora connessi negli ultimi 30 secondi.
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.
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
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.
go mod tidy
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
Alcune funzionalità di OpenWISP sono (attualmente) considerate fuori dall'ambito di OpenSOHO
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.
GITHUB_TOKEN=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa goreleaser release