Saltar al contenido
CloudZH

Documentación / Red

UniFi OS Server

Ejecuta la aplicación UniFi Network para tus puntos de acceso y switches en el servidor de CloudZH.

Instalar

zh unifi install

UniFi OS Server se ejecuta sin root con Podman bajo su propio usuario. Ábrelo en https://unifi.example.com tras tu inicio de sesión, o en casa en https://<server-ip>:11443, por ejemplo https://192.168.1.200:11443.

Dirección de inform

Tus dispositivos UniFi se comunican con la dirección indicada en Inform host override. CloudZH introduce ahí por sí mismo la dirección por cable del servidor y la comprueba en cada inicio y cada 6 horas, para que los dispositivos nunca se comuniquen con una dirección de wifi o de contenedor. Muéstrala o cámbiala en el servidor:

zh unifi inform              # show
zh unifi inform <server-ip>   # a fixed address instead
zh unifi inform auto         # back to automatic

Migrar desde otro controlador

Un dispositivo solo obedece a un controlador. Mantén exactamente uno activo.

  1. Crea una copia de seguridad en el controlador antiguo (Network → Settings → System → Backups) y restáurala en la app Network de CloudZH.
  2. Comprueba la dirección de inform con zh unifi inform.
  3. Dirige cada dispositivo al nuevo controlador por SSH. <device-ip> es la dirección del punto de acceso o del switch, <server-ip> la del servidor:
    ssh admin@<device-ip>
    set-inform http://<server-ip>:8080/inform
    La sesión SSH se corta mientras el dispositivo se aprovisiona. Es normal.
  4. Compruébalo con info en el dispositivo: Connected (http://<server-ip>:8080/inform). Después detén el controlador antiguo.
Conecta el servidor por cable

Si el servidor llega a tu red a través del punto de acceso que gestiona, una actualización de firmware o un ajuste erróneo lo deja aislado de sí mismo. Desactiva las actualizaciones automáticas de dispositivos mientras el servidor esté en wifi.

UniFi OS Server es compatible con la aplicación Network. Protect, Access y Talk necesitan una consola UniFi.