Tengo algunos productos inteligentes en casa y una de las cosas que quería hacer es leer los dispositivos WiFi conectados.
Para hacer esto, necesito que Unifi Controller funcione las 24 horas del día, los 7 días de la semana, por lo que necesitaba un dispositivo para ejecutar Unifi Controller, algo pequeño, barato y con bajos costos de funcionamiento.
Ahí es donde entra la Raspberry Pi. En este artículo, lo ayudaré a instalar el controlador Unifi en la Raspberry Pi paso a paso en 5 minutos.

tengo actualizó y probó este artículo el 18 de noviembre de 2021. La versión predeterminada de Java que está instalada en la frambuesa ya no es compatible con el controlador Unifi (^ 5.10.x).
Así que vamos a reemplazarlo con OpenJDK. E instalaremos una versión anterior de MongoDB, porque la última versión no es compatible con Unifi Controller.
También agregaremos haveged a la instalación. Esto solucionará el problema de inicio lento del controlador Unifi en la Raspberry Pi.
¿Qué necesitamos para el controlador Unifi y Raspberry Pi?
Antes de que podamos comenzar con la instalación del controlador Unifi en la Raspberry Pi, necesitamos obtener algunas piezas y descargar algún software.
Por supuesto, necesitamos comprar una Raspberry Pi. Puedes usar un modelo 2, pero si tiene que comprar uno nuevo, le recomiendo obtener un Modelo 3B o
Además, necesitará una tarjeta MicroSD, compre al menos una
Descargue el siguiente software para comenzar:
- raspbian Pi Imager (enlace de descarga directa)
- Escáner IP avanzado: para encontrar la dirección IP del PI
- Masilla – para conectarse a la Pi con SSH
Paso 1: poner en funcionamiento la Raspberry Pi
Primero, vamos a empezar por instalando Raspbian en la tarjeta MicroSD. Ahora podemos usar Raspberry Pi Imager para instalar fácilmente la versión correcta del sistema operativo Raspbian.
Vamos a instalar la versión lite de Raspberry Pi OS, esta versión viene sin un escritorio que no necesitamos.
Coloque la tarjeta MicroSD en su computadora y abra Raspberry Pi Imager:
- Hacer clic Elija el sistema operativo
- Seleccione Sistema operativo Raspberry Pi (otro)
- Elegir Raspberry Pi OS Lite (32 bits)

- Haga clic en Elija Almacenamiento
- Selecciona tu Tarjeta micro SD (verifique el tamaño y la letra de la unidad!)
- Haga clic en Escribe
- Recibirá una advertencia de que se eliminarán todos los datos, haga clic en OK y tómate un café 😉
- Espere hasta que finalice el proceso.

Activar SSH
No queremos conectar un teclado y monitor a nuestra Raspberry Pi todo lo que necesitamos para actualizar o cambiar algo.
Entonces, lo primero que hacemos es habilitar SSH para que podamos conectarnos de forma remota al PI.
Ahora, los siguientes pasos también deberían funcionar en una máquina con Windows, pero varias veces no pude abrir la tarjeta SD en el Explorador de Windows.
No desperdicio su tiempo intentando si tiene lo mismo, simplemente siga la forma alternativa de habilitar SSH a continuación.

Por lo tanto, debería poder hacer lo siguiente para habilitar SSH:
- Abre tu explorador y abierto de Tarjeta micro SD. (se llama bota).
- Agrega un nuevo archivo de texto y nombrarlo SSH
- Asegúrese eliminar .txt del nombre del archivo. Así que te queda un archivo llamado SSH.
Si tiene problemas para abrir la tarjeta SD en Windows, puede intentar usar otra computadora u omitir esta parte.
Luego deberá conectar un monitor (o TV) y un teclado al Pi y seguir el paso en Forma alternativa de habilitar SSH
Enchufe la tarjeta MicroSD en el Rasberry Pi y conecte el energía y Cable de ethernet. El PI ahora se iniciará.
Forma alternativa de habilitar SSH
Asegúrese de tener un teclado y un monitor/televisor conectados. Inicie sesión en Pi con el siguiente inicio de sesión:
Nombre de usuario: Pi
Clave: frambuesa
Escriba el siguiente comando para abrir la página de configuración:
sudo raspi-config
- Seleccione 5. Opciones de interfaz
- Desplácese hacia abajo hasta 2. SSH y presione enter para permitirle
- Cuando presione hacia abajo ESC para salir de la página de configuración.
Ahora ha habilitado SSH y puede continuar siguiendo esta guía.
Paso 2: Conexión con SSH
Puede conectarse a su Raspberry Pi usando el nombre de host predeterminado raspberrypi.local
.
A veces esto no funciona debido a la configuración de su red. En ese caso, deberá buscar la dirección IP de su Pi.
Encuentra la dirección IP – opcional
Necesitamos encontrar la dirección IP del PI. Abierto Escáner IP avanzado y haga clic en escanear.

En los resultados, verá la Raspberry Pi, tenga en cuenta la dirección IP, en mi caso, es 192.168.1.210.
Conexión al PI con Putty
Abierto Masilla que descargaste antes. Ingresar raspberrypi.local o el Dirección IP que encontramos en el Advanced Ip Scanner y pulsamos en Abierto

Recibirá una advertencia si confiamos en el host. Lo hacemos clic sí

Deberá iniciar sesión, las credenciales predeterminadas son:
Nombre de usuario: Pi
Clave: frambuesa

Paso 3: configurar la Raspberry Pi
Antes de instalar el controlador Unifi en la Raspberry Pi, primero configuraremos la propia Raspberry Pi.
Puede copiar y pegar el comando en Putty. Simplemente copie de este artículo y haga clic derecho en Putty.
Establecer una dirección IP estática
De manera predeterminada, Pi usa DHCP para obtener una dirección IP. Esto significa que un reinicio puede hacer que obtenga una nueva dirección IP, lo que dificultará administrarlo con SSH o abrir el controlador Unifi.
Así que vamos a configurar una dirección IP estática en la interfaz de red:
- Primero, verifiquemos los detalles de la red actual. Escribe: ifconfig
En el resultado verás eth0 y en ese bloque Internet: 192.168.xx Esta es la dirección IP actual. - Para editar el archivo de configuración de la red, escriba el siguiente cmd:
sudo nano /etc/dhcpcd.conf
3. Habilite las siguientes líneas eliminando el # y establezca una dirección IP en un valor fijo
#Static IP configuration: interface eth0 static ip_address=192.168.1.210/24 #static ip6_address=fd51:42f8:caae:d92e::ff/64 static routers=192.168.1.1 static domain_name_servers=192.168.1.1 1.1.1.1 fd51:42f8:caae:d92e::1
En este caso, configuramos la dirección IP en 192.168.1.210 y la dirección del enrutador de Internet es 192.168.1.1.
También debe configurar los servidores de nombre de dominio; de forma predeterminada, ingresar la dirección del enrutador es suficiente.
Cual ip dirección debe elegir? Si no conoce el diseño de su red, mantenga las primeras 3 partes de la dirección igual y elija un valor entre 200 y 240 al final.
Cuando haya terminado, guarde y cierre el archivo presionando control + x y elige Y para salvarlo
Ahora necesitamos reiniciar la interfaz de red para aplicar la configuración. Simplemente reinicie el Pi con el cmd a continuación.
Espere un minuto y conéctese al PI con Putty en la nueva dirección IP.
sudo reboot
Cambiar la contraseña predeterminada
Solo con cada dispositivo (de red) que tenga, debe cambiar la contraseña predeterminada. Para cambiar la contraseña, primero deberá ingresar la contraseña actual y luego ingresar la nueva contraseña dos veces:
Ingrese el cmd contraseña:
[email protected]:~ $ passwd Changing password for pi. (current) UNIX password:raspberry Enter new UNIX password: Retype new UNIX password: passwd: password updated successfully
Actualizando tu Raspberry
Antes de comenzar a instalar el software en la PI, nos aseguraremos de que la Raspberry Pi esté actualizada.
Con el cmd a continuación, actualizaremos el firmware, el software y limpiaremos el software antiguo y no utilizado.
sudo apt-get update && sudo apt-get upgrade -y && sudo apt-get autoremove && sudo apt-get autoclean
Esto puede tomar uno o dos minutos.
Instalar haveged
No es realmente necesario, pero el inicio del controlador Unifi puede demorar un poco en una Raspberry Pi debido a que no hay interacción del usuario.
Ahora su Pi debería funcionar las 24 horas del día, los 7 días de la semana, por lo que no es un gran problema, pero podemos acelerarlo de todos modos.
Instale haveged para resolver el problema con el siguiente cmd:
sudo apt-get install haveged -y
Actualizar Java 8
Este paso es bastante importante con la versión más reciente de Unifi Controller.
A partir de la versión 5.10.x, la versión anterior de Java que viene con Raspbian ya no es compatible. Así que vamos a reemplazarlo con OpenJDK 8.
sudo apt-get install openjdk-8-jre-headless -y
Memoria dividida
Si ejecuta Raspberry Pi sin un monitor conectado, puede reducir de manera segura la cantidad de RAM utilizada por la GPU.
De forma predeterminada, Pi ha asignado 64 MB de RAM a la GPU.
Debido a que estamos usando CLI (Command Line Interface) para trabajar en Pi, podemos reducir esa cantidad de RAM, dejando más RAM disponible para Pi.
Abra la configuración de Raspberry Pi con el siguiente comando:
sudo raspi-config
- Seleccione 4. Opciones de rendimiento
- Memoria GPU P2
- Cambiar 64 a 16 MB
- Pegar Ingresar y use Esc para cerrar la pantalla de configuración.
Asegúrese de reiniciar el Pi para aplicar los cambios.
Paso 4: instalación del controlador Unifi Raspberry Pi
Entonces, con nuestra Raspberry Pi lista, podemos comenzar con la instalación del controlador Unifi en la Raspberry Pi.
1. Agregue el repositorio para el Unifi Controller
Todas las distribuciones de Linux vienen con una lista de fuentes, repositorio, de paquetes disponibles para instalar.
Unifi Controller no aparece en los repositorios predeterminados, por lo que debemos agregarlo primero:
echo 'deb http://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list
Arreglar la versión de MongoDB
La última versión de MongoDB no es compatible con Unifi Controller. Al instalar el controlador Unifi, probablemente obtenga el siguiente error:
Some packages could not be installed... The following packages have unmet dependencies: unifi : Depends: mongodb-server (>= 2.4.10) but it is not installable or etc.
Para evitar esto nosotros necesita cambiar el repositorio para MongoDB:
echo 'deb http://archive.raspbian.org/raspbian stretch main contrib non-free rpi' | sudo tee /etc/apt/sources.list.d/raspbian_stretch_for_mongodb.list
2. Autenticar el software
Para instalar el software Unifi Controller, necesitamos autenticar el software para que sea el software real de Ubiquiti. Esto se puede hacer con un GPG clave para que podamos autenticar el software.
sudo wget -O /etc/apt/trusted.gpg.d/unifi-repo.gpg https://dl.ubnt.com/unifi/unifi-repo.gpg
3. Instale el controlador Unifi
Ahora hemos agregado el software a nuestra lista de software disponible y tenemos la capacidad de verificar su autenticidad.
Así que descarguemos el software e instalemos el controlador Unifi en la Raspberry Pi:
sudo apt-get update; sudo apt-get install unifi -y
4. Limpiar MongoDB
La instalación puede tardar un par de minutos en completarse. Cuando termine, debemos eliminar la base de datos predeterminada que viene con la instancia de MongoDB.
Esto solo desperdiciaría recursos de nuestra Pi, así que nos deshacemos de ella:
sudo systemctl stop mongodb sudo systemctl disable mongodb
5. Terminé de instalar el controlador Unifi en el Pi
El único paso que queda es reiniciar el Pi
sudo reboot

Terminando
Después del reinicio, puede iniciar sesión en Raspberry Pi con su navegador. Vaya a la dirección IP que configuró anteriormente (por ejemplo, https://192.168.1.210:8443)
Se mostrará la página del asistente de configuración que le permitirá crear un nuevo sitio o restaurar una copia de seguridad.
Consulte esta publicación para obtener algunos consejos sobre cómo optimizar su controlador o cómo agregar los puntos de acceso.
Asegúrese de hacer una copia de seguridad de su controlador Unifi correctamente.
Las actualizaciones pueden bloquear su controlador o incluso Pi, por lo que la mejor solución es hacer una copia de seguridad de su controlador en el almacenamiento en la nube, como Dropbox.
Puedes leer este artículo sobre cómo configurarlo (solo toma otros 5 minutos 😉)
También te puede gustar este artículo donde te guiaré a través de la instalación de Home Assistant en tu Raspberry Pi usando Docker.
Mantener actualizado el controlador Unifi
Es importante mantener actualizados sus productos de red. El nuevo firmware contiene correcciones de seguridad importantes, corrige errores en el software y puede mejorar el rendimiento de un dispositivo.
Consulte esta publicación sobre cómo actualizar el controlador Unifi y suscríbase al boletín. ¡Te enviaré un correo electrónico cuando haya una nueva versión disponible!
Errores comunes
Durante la instalación, es posible que reciba un error. Ocurre a veces con los sistemas basados en Linux.
Puede consultar los comentarios a continuación para ver los problemas con los que otros se han encontrado. Uno de los problemas que tuve durante la instalación fue este:
unexpected end of file or stream abort-upgrade: please reinstall previous version
Una de las primeras cosas que puede intentar es limpiar la lista descargada de APT.
De esta manera los archivos se descargarán nuevamente, resolviendo cualquier problema con archivos corruptos durante la descarga:
sudo apt-get clean
404 error no encontrado
Si ha instalado el controlador Unifi, obtiene un error 404 después de haber restaurado el Pi, entonces hay un problema con los servicios Unifi.
Puede verificar el estado de todos los servicios en su Raspberry Pi con el siguiente comando:
sudo service --status-all
Todos los servicios que se están ejecutando se enumeran con un + delante de ellos.
El servicio Unifi puede estar apagado, o incluso puede aparecer como en ejecución, pero claramente funciona mal.
Podemos solucionar esto fácilmente (re)iniciando los servicios:
service unifi start
Es posible que deba ingresar su contraseña nuevamente, pero después de eso, el controlador Unifi debería estar ejecutándose.
Probablemente también te gusten los siguientes artículos:
Otros artículos relacionados

Cómo hacer que la iluminación de su paisaje exterior sea inteligente
Leer Más

UniFi Teleport – Cómo configurar y usar la VPN con un clic
Leer Más

Restablecer Unifi Switch: la forma correcta
Leer Más

Agregar cámara de video UniFi a Synology Surveillance Station
Leer Más

Controlador UniFi alojado: ¿cuáles son sus opciones?
Leer Más

Guía de configuración y revisión de UniFi Viewport
Leer Más