UniFi como Servicio

UniFi Network Server (UNS) se destaca en el mercado de administración de redes por su enfoque centralizado y su integración fluida con los dispositivos UniFi. A diferencia de otras soluciones, que suelen requerir configuraciones complejas o hardware propietario costoso, UNS ofrece una plataforma intuitiva con una gestión unificada desde una interfaz web moderna.

Entre sus principales ventajas frente a la competencia destacan su fácil implementación, actualizaciones constantes sin interrupciones y compatibilidad con múltiples métodos de autenticación. Además, ofrece una sólida integración con herramientas de análisis de tráfico y una gestión eficiente de grandes volúmenes de dispositivos sin afectar el rendimiento, lo que lo convierte en una solución escalable. También cuenta con un foro muy activo para soporte y comunidad. Sin embargo, su mayor ventaja es el Hotspot, una opción líder en el sector gracias a su facilidad de uso.

Instalación Tradicional

Entrando en materia, la instalación de UNS es relativamente sencilla. Para windows, basta con descargar el instalador del sitio web oficial y con un doble clic comenzará la instalación y cada vez que inicie el equipo, debemos iniciar el programa, aunque también podemos crear una tarea en el programador de tareas de Windows para que se ejecute en cada inicio. Pero hay otra solución, más automatizada y que abordaremos hoy.

Instalación como servicio

Para linux, Glenn solucionó este problema con el script unifi-easy-update, que automatiza este proceso, pero para Windows no pudimos encontrar ninguno, así que nos dimos a la tarea de hacerlo.

Antes que nada debemos aclarar que este script se debe ejecutar solamente en Windows 10/11. Dicho esto, al hacer doble clic en el script, verifica que se ejecute con privilegios de administrador y aparecerá el siguiente menú.

Menú de instalación de UNS

Hay varias opciones. Si elige la primera opción 1 (instalación), el script verificará lo siguiente:

• Si está curl presente en su sistema Windows. Es importante resaltar que a partir de Windows 10 (build 17063 o superior) y Windows 11, curl ya viene integrado al SO. Puede verificarlo en el path C:\Windows\System32\curl.exe.
• Si existe Java previamente instalado, aborta, por tanto, debe desinstalar Java.
• Si existe la carpeta %UserProfile%\Ubiquiti UniFi\, aborta, por tanto, debe desinstalar Unifi y eliminar la carpeta en cuestión.

Una vez superado estos controles, saldrá un segundo menú, en el cual elegirá la versión de UNS que quiera instalar.

Elija la versión de UNS a instalar (1 o 2)

Nota: Hay administradores que prefieren la versión más reciente (9x), en cambio otros, más conservadores, se inclinan por usar una versión ya probada en entornos de producción (8x), por tanto, el script pone a disposición ambas versiones.

Y finalmente el script procederá con la instalación silenciosa de UNS con su dependencia  JRE x64 LTS Eclipse Temurin y abrirá los puertos en el firewall. Al terminar la instalación deberá reiniciar para aplicar cambios.

Después de reiniciar, ya no necesita abrir la app de Unifi, porque inicia con su sistema como un servicio. Y para acceder al software de administración, abra su navegador e ingrese a la URL: https://localhost:8443.

Para desinstalarlo, no lo haga por el Panel de Control. Solo ejecute el script nuevamente y elija la opción 2 y al terminar reinicie su PC.

La tercera opción es para hacer una copia de seguridad de la configuración de Unifi, la cual enviará la carpeta %HOMEDRIVE%\uns. Tenga en cuenta que debe tener activado el autobackup en la configuración de Unifi y debe existir al menos un backup automático generado para que pueda realizar la acción.

La cuarta opción es para agregar la dirección IPv4 del PC donde se encuentra instalado Unifi (deberá elegirla manualmente y reiniciar el PC al terminar). Ejemplo https://192.168.1.1:8443.

Importante

- No elimine la carpeta %HOMEDRIVE%\uns, ya que los instaladores los usa el script para la desinstalación de UNS y sus componentes y en esta carpeta se almacenan los backups.

- El instalador ejecuta algunos comandos de PowerShell, por tanto, en Windows 11 24h2 o superior, si al ejecutar el script de instalación o desinstalación aparece un error similar a:

CategoryInfo : SecurityError: (:) [], PSSecurityException 
FullyQualifiedErrorId : UnauthorizedAccess

Deberá desactivar temporalmente la restricción de ejecución de scripts. Para ello, abra Windows PowerShell con privilegios administrativos y ejecute:

:: Para desactivar:
Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
:: Para restablecer:
Set-ExecutionPolicy Restricted -Scope CurrentUser -Force

Puede descargar el script en nuestro repositorio Vault, o directamente AQUÍ.

Esperamos que les sea útil esta herramienta de instalación.