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

# <img src="https://raw.githubusercontent.com/rubenbe/opensoho/HEAD/logo.svg" alt="OpenSOHO logo" width="40" /> OpenSOHO

Grazie per aver preso in considerazione il supporto al progetto!

[Documentazione](https://opensoho.github.io/docs)

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](https://github.com/rubenbe/opensoho/releases)

[Configurazione con Docker, Podman o Kubernetes](https://opensoho.github.io/docs/containers/)

* 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.

```sh
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:
```sh
./opensoho superuser upsert EMAIL PASS
```

## Configurazione (adozione) dei dispositivi OpenWRT

### Installare i pacchetti OpenWISP

```sh
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
```sh
opkg remove wpad-basic-mbedtls && \
opkg install wpad-mbedtls && \
service wpad restart
```

Su OpenWRT 25.12+
```sh
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

Questi sono i dispositivi connessi.
* Usa enable/disable per disabilitare gli aggiornamenti di configurazione. È utile per evitare di aggiornare tutti i dispositivi contemporaneamente. Il monitoring rimane attivo.
* Health status è un campo di sola lettura. `healthy` significa che il dispositivo ha comunicato nell'ultimo minuto. In caso contrario, lo stato di salute diventa `unhealthy` e potrebbe esserci qualcosa di sbagliato nel dispositivo o nella sua connessione.
* Leds consente di scegliere le configurazioni dei led
* Numradios consente di impostare il numero di radio sul dispositivo. Questo non viene inviato inizialmente da OpenWisp, quindi deve essere impostato dall'utente.
* Wifis consente di selezionare gli SSID da applicare su questo dispositivo.

### Prenotazioni DHCP

Crea una prenotazione con un hostname, un indirizzo MAC, un indirizzo IPv4 e uno o
più server DHCP. OpenSOHO aggiunge la stessa sezione denominata `config host` a
`/etc/config/dhcp` su ogni server selezionato. Deseleziona il server DHCP per
disabilitare la prenotazione senza eliminarla. Nomi, indirizzi MAC e indirizzi IP
sono univoci all'interno dell'elenco delle prenotazioni.

### Led

* Configurazione di base dei LED (più che altro un POC al momento)

### Radio

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

### Wifi

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

## Monitoraggio

### Monitoraggio del dispositivo

Verifica se lo stato di salute del dispositivo è `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)](https://opensoho.github.io/docs/home-assistant/)
Questa API REST è progettata per l'uso con Home Assistant, ma può anche essere integrata con altri strumenti.

## Risoluzione dei problemi

### Registrare nuovamente un dispositivo

Quando si modifica l'`Server URL` di OpenWISP in LuCI, sembra che il dispositivo non si registri correttamente con il nuovo controller.
Per risolvere il problema:
```sh
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 Wi-Fi non viene abilitato automaticamente.
Soluzione alternativa: fare clic sul pulsante di abilitazione in LuCI.

# Sviluppatori

* Installare le dipendenze

```sh
go mod tidy
```

* Avvia OpenSOHO

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

Esecuzione degli unit test:
```sh
go test -cover -v -coverprofile=coverage.out
go tool cover -html=coverage.out
```

## Ambito

### Funzionalità

Alcune funzionalità di OpenWISP sono (attualmente) considerate fuori ambito per OpenSOHO
* Aggiornamenti del firmware: OpenWRT non necessita di aggiornamenti frequenti; utilizzare manualmente la funzionalità Attended sysupgrade su ciascun dispositivo.
* Multi-tenancy
* Template: OpenWISP dispone di un meccanismo di template potente e versatile, sostituito da un sottoinsieme di funzionalità più opinionato per offrire un'esperienza di configurazione più semplice.

### Sviluppo
L'obiettivo è sfruttare pocketbase al massimo. Piccole modifiche possono essere apportate poiché il back-end di pocketbase attualmente manca di un sistema di plug-in. Ma non è l'obiettivo creare un fork di pocketbase, così che il merge delle modifiche upstream rimanga semplice.

### Rilascio
```sh
GITHUB_TOKEN=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa goreleaser release
```

opensoho

Più Popolari