Advertencia: esta es una versión preliminar, por favor lea las notas de la versión de TODAS las versiones hasta ahora

OpenSOHO

¡Gracias por considerar apoyar el proyecto!

Documentación

OpenSOHO está diseñado para gestionar un pequeño número de dispositivos de red basados en OpenWRT. De ahí el nombre SOHO de Small Office Home Office (SOHO) Networks.

• De 2 a 20 dispositivos (no hay un límite estricto)
• Sin multi-tenencia
• Compatible con openwisp-config y openwisp-monitoring.
• Fácil de desplegar

Está inspirado en OpenWISP, pero apunta a redes que son demasiado pequeñas para ser mantenidas con OpenWISP. Como mencionó OpenWisp:

Sin embargo, OpenWISP puede no ser la mejor opción para redes muy pequeñas (menos de 20 dispositivos), organizaciones que carecen de experiencia en TI, o empresas que buscan alternativas de código abierto únicamente con fines de ahorro de costos.

Se han probado las siguientes versiones

• OpenWRT 24.10.x DSA (soporte heredado)
• OpenWRT 25.12.x DSA

Primeros pasos con OpenSOHO

Descripción general

Configurar OpenSOHO requiere unos pocos pasos simples, cada uno detallado en las secciones a continuación:

• Instalar OpenSOHO en su servidor.
• Instalar los paquetes de OpenWisp en sus dispositivos OpenWRT.
• Configurar OpenWisp en cada uno de sus dispositivos OpenWRT para conectarse a OpenSOHO.
• ¡Comenzar a configurar en OpenSOHO!

Instalar OpenSOHO

• Descargue la última versión de OpenSOHO (o use un contenedor docker)

  Versiones

  Configuración con Docker, Podman o Kubernetes

• Iniciar OpenSOHO

Primero, elija un secreto compartido que permita a los dispositivos OpenWRT (usando openwisp-config) registrarse con OpenSOHO.

Elija una cadena aleatoria larga para una seguridad óptima.

Debe coincidir con lo que configure en LuCI en los siguientes pasos.

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

Ahora, OpenSOHO muestra una URL en la línea de comandos que te permite crear la cuenta de administrador. Simplemente abre la URL en tu navegador.

Alternativamente, crea la cuenta de administrador mediante la línea de comandos:

./opensoho superuser upsert EMAIL PASS

Configuración (adopción) de los dispositivos OpenWRT

Instalar los paquetes de 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 quieres usar el direccionamiento de clientes 802.11v, es necesario el paquete completo wpad-mbedtls.

En OpenWRT 24.10

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

En OpenWRT 25.12+

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

Después de instalar wpad-mbedtls, intente primero service restart wpad; de lo contrario, es posible que se requiera un reinicio para cambiar al nuevo binario de wpad. Si no, puede obtener un error como daemon.notice netifd: radio1 (28210): WARNING (wireless_add_process): executable path /usr/sbin/wpad does not match process 1842 path (/usr/sbin/wpad (deleted)). (Tenga en cuenta que el direccionamiento de clientes 802.11v aún está en desarrollo)

Configurar OpenWISP en LuCI:

• Establezca únicamente la Server URL y el Shared secret.
  • NO añada una barra al final de la Server URL. Un ejemplo de URL: http://192.168.1.1:8090
  • El secreto compartido es el valor que eligió previamente (OPENSOHO_SHARED_SECRET).
• Opcionalmente, reduzca el Update Interval a 30 segundos para actualizaciones más rápidas. (OpenSOHO hace esto por usted si no lo hace)
• OpenSOHO también habilita la monitorización y reduce el intervalo de monitorización a 15 segundos para actualizaciones más rápidas del estado de la red.

Se recomienda encarecidamente habilitar la monitorización, ya que OpenSOHO deduce gran parte de la configuración actual de OpenWRT y la rellena para facilitar la configuración.

Configurar OpenSOHO

• Espere a que el/los dispositivo(s) OpenWrt se autorregistren usando el secreto compartido.
• Establezca el indicador Enabled del dispositivo en true.
• Establezca numradios en el valor correcto. Por ejemplo, para un dispositivo de 2.4 + 5GHz, este valor sería 2.
• Configure un punto de acceso Wifi (SSID+KEY). Este procedimiento permite a OpenSOHO detectar correctamente la configuración de radio al registrar el dispositivo.
• Adjunte el punto de acceso Wifi configurado a un dispositivo para que se configure.
• Actualmente cada red se configurará automáticamente en todas las radios (configuradas usando numradios).
• Opcionalmente, también se pueden encender o apagar los leds (solo configuración estática por ahora).
• Ahora se admite la configuración de frecuencias de radio. OpenSOHO lee la configuración actual de radio una vez y la pone a disposición en la configuración de radios. Puede tardar uno o dos minutos antes de que aparezca la configuración de radio (los pasos de configuración y monitorización necesitan algo de tiempo para completarse).

Panel de control

OpenSOHO incluye un panel de control básico. Es accesible mediante el botón en la barra lateral más a la izquierda, justo debajo del logotipo de OpenSOHO.

Tenga en cuenta que esto no está pensado como un reemplazo de herramientas de gráficos más avanzadas; es y se mantendrá básico a propósito.

Configurar

Ahora se puede acceder a OpenSoho mediante http://ipaddress:8090/_/

Hay varias colecciones de configuración:

Clientes

Estos son los clientes conectados a Wifi. Esta tabla es de solo lectura, excepto por el alias. Se puede usar para dar a los dispositivos un nombre legible por humanos. Esto solo funciona correctamente cuando el cliente no aleatoriza su dirección mac.

Clientes conectados

Contiene la lista de clientes que están conectados actualmente a su wifi. Para mostrar la dirección IP del dispositivo, OpenSOHO necesita acceso a sus concesiones DHCP. Para ello, debe tener el demonio de monitorización de openwisp ejecutándose en el dispositivo que contiene el servidor DHCP. Los dispositivos con IP estática no obtendrán una IP. Esta es una limitación conocida a partir de la 0.12.0.

Dispositivos