Attention, ceci est une version préliminaire, veuillez lire les notes de version de TOUTES les versions jusqu'à présent

OpenSOHO

Merci d'envisager de soutenir le projet !

Documentation

OpenSOHO est conçu pour gérer un petit nombre d'équipements réseau basés sur OpenWRT. D'où le nom SOHO pour Small Office Home Office (réseaux SOHO).

De 2 à 20 équipements (il n'y a pas de limite stricte)
Pas de multi-tenant
Compatible avec openwisp-config et openwisp-monitoring.
Simple à déployer

Il s'inspire d'OpenWISP, mais vise les réseaux trop petits pour être maintenus avec OpenWISP. Comme l'a mentionné OpenWisp :

Cependant, OpenWISP peut ne pas être la solution la plus adaptée pour les très petits réseaux (moins de 20 équipements), les organisations manquant d'expertise informatique, ou les entreprises cherchant des alternatives open-source uniquement pour des raisons d'économie.

Les versions suivantes sont testées

OpenWRT 24.10.x DSA (support hérité)
OpenWRT 25.12.x DSA

Démarrage avec OpenSOHO

Aperçu

La configuration d'OpenSOHO nécessite quelques étapes simples, chacune détaillée dans les sections ci-dessous :

Installez OpenSOHO sur votre serveur.
Installez les paquets OpenWisp sur vos équipements OpenWRT.
Configurez OpenWisp sur chacun de vos équipements OpenWRT pour se connecter à OpenSOHO.
Commencez la configuration dans OpenSOHO !

Installer OpenSOHO

Téléchargez la dernière version d'OpenSOHO (ou utilisez un conteneur docker)

Versions

Installation avec Docker, Podman ou Kubernetes
Démarrez OpenSOHO

Tout d'abord, choisissez un secret partagé qui permet aux équipements OpenWRT (utilisant openwisp-config) de s'enregistrer auprès d'OpenSOHO.

Choisissez une longue chaîne aléatoire pour une sécurité optimale.

Elle doit correspondre à ce que vous configurez dans LuCI lors des étapes suivantes.

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

Maintenant, OpenSOHO affiche une URL sur la ligne de commande qui vous permet de créer le compte administrateur. Ouvrez simplement l'URL dans votre navigateur.

Vous pouvez également créer le compte administrateur via la ligne de commande :

./opensoho superuser upsert EMAIL PASS

Configuration (adoption) des appareils OpenWRT

Installer les paquets 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+

Si vous souhaitez utiliser le pilotage des clients 802.11v, le paquet complet wpad-mbedtls est nécessaire.

Sur OpenWRT 24.10

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

Sur OpenWRT 25.12+

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

Après l'installation de wpad-mbedtls, essayez d'abord service restart wpad, sinon un redémarrage peut être nécessaire pour basculer vers le nouveau binaire wpad. Dans le cas contraire, vous pouvez obtenir une erreur du type daemon.notice netifd: radio1 (28210): WARNING (wireless_add_process): executable path /usr/sbin/wpad does not match process 1842 path (/usr/sbin/wpad (deleted)). (Veuillez noter que le pilotage des clients 802.11v est encore en cours de développement)

Configurer OpenWISP dans LuCI :

Définissez uniquement l'Server URL et le Shared secret.
- N'ajoutez PAS de barre oblique à la fin de l'Server URL. Exemple d'URL : http://192.168.1.1:8090
- Le shared secret est la valeur que vous avez choisie précédemment (OPENSOHO_SHARED_SECRET).
Vous pouvez éventuellement réduire l'Update Interval à 30 secondes pour des mises à jour plus rapides. (OpenSOHO le fait pour vous si vous ne le faites pas)
OpenSOHO active également la supervision et réduit l'intervalle de supervision à 15 secondes pour des mises à jour plus rapides de l'état du réseau.

Il est fortement recommandé d'activer la supervision, car OpenSOHO déduit un grand nombre des paramètres OpenWRT actuels et les renseigne pour faciliter la configuration.

Configurer OpenSOHO

Attendez que le(s) périphérique(s) OpenWrt s'auto-enregistrent à l'aide du shared secret.
Définissez l'indicateur Enabled du périphérique sur true.
Définissez numradios à la valeur correcte. Par exemple, pour un périphérique 2,4 + 5 GHz, cette valeur serait 2.
Configurez un point d'accès Wifi (SSID+KEY). Cette procédure permet à OpenSOHO de détecter correctement la configuration radio lors de l'enregistrement du périphérique.
Rattachez le point d'accès Wifi configuré à un périphérique pour qu'il soit configuré.
Actuellement, chaque réseau sera automatiquement configuré sur toutes les radios (configurées à l'aide de numradios).
Les leds peuvent également être activées ou désactivées (uniquement en configuration statique pour l'instant).
La configuration des fréquences radio est désormais prise en charge. OpenSOHO lit la configuration radio actuelle une fois et la rend disponible dans la configuration des radios. Cela peut prendre une minute ou deux avant que la configuration radio n'apparaisse (les étapes de configuration et de supervision nécessitent un certain temps pour se terminer).

Tableau de bord

OpenSOHO est livré avec un tableau de bord basique. Il est accessible via le bouton dans la barre latérale la plus à gauche, juste sous le logo OpenSOHO.

Veuillez noter que ceci n'est pas destiné à remplacer des outils de graphiques plus avancés ; il est et restera volontairement basique.

Configurer

OpenSoho est désormais accessible via http://ipaddress:8090/_/

Il existe plusieurs collections de configuration :

Clients

Il s'agit des clients connectés au Wifi. Cette table est en lecture seule, à l'exception de l'alias. Elle peut être utilisée pour donner aux périphériques un nom lisible par l'humain. Cela ne fonctionne correctement que lorsque le client ne randomise pas son adresse mac.

Clients connectés

Contient la liste des clients actuellement connectés à votre wifi. Afin d'afficher l'adresse IP du périphérique, OpenSOHO a besoin d'accéder à vos baux DHCP. Pour ce faire, vous devez avoir le démon de supervision openwisp en cours d'exécution sur le périphérique qui contient le serveur DHCP. Les périphériques avec une IP statique n'obtiendront pas d'IP. Il s'agit d'une limitation connue à partir de la version 0.12.0.

opensoho v0.15.2