Instale el controlador Unifi en Raspberry Pi en 5 minutos [Step-By-Step]

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.

Controlador Unifi en Raspberry Pi

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:

  1. Hacer clic Elija el sistema operativo
  2. Seleccione Sistema operativo Raspberry Pi (otro)
  3. Elegir Raspberry Pi OS Lite (32 bits)
Instalar el sistema operativo Raspberry Pi
  1. Haga clic en Elija Almacenamiento
  2. Selecciona tu Tarjeta micro SD (verifique el tamaño y la letra de la unidad!)
  3. Haga clic en Escribe
  4. Recibirá una advertencia de que se eliminarán todos los datos, haga clic en OK y tómate un café 😉
  5. Espere hasta que finalice el proceso.
instalar raspbian

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.

Agregue un nuevo archivo de texto ssh a la tarjeta SD

Por lo tanto, debería poder hacer lo siguiente para habilitar SSH:

  1. Abre tu explorador y abierto de Tarjeta micro SD. (se llama bota).
  2. Agrega un nuevo archivo de texto y nombrarlo SSH
  3. 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.

Escáner de ip avanzado para encontrar raspberry pi

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

Conexión a la raspberry pi con masilla

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

Advertencia de seguridad SSH

Deberá iniciar sesión, las credenciales predeterminadas son:

Nombre de usuario: Pi
Clave: frambuesa

controlador ssh a unifi raspberry pi

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:

  1. 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.
  2. 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
  1. Seleccione 4. Opciones de rendimiento
  2. Memoria GPU P2
  3. Cambiar 64 a 16 MB
  4. 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
Controlador Unifi Raspberry Pi

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

Revisión, comparación y puntos de referencia de UniFi 6 Lite y LR

Revisión, comparación y puntos de referencia de UniFi 6 Lite y LR

Ubiquiti hace excelentes puntos de acceso con su línea Unifi. En mi opinión, tienen la mejor relación calidad-precio, por lo ...
Leer Más
Power over Ethernet - ¿Qué es y cómo funciona?

Power over Ethernet – ¿Qué es y cómo funciona?

Power over Ethernet (POE), un término que se ve cada vez más en los productos de red, pero ¿qué es? ...
Leer Más
Cloudflare Warp: haga que su Internet móvil sea más seguro y rápido

Cloudflare Warp: haga que su Internet móvil sea más seguro y rápido

Cloudflare, la empresa detrás del servidor DNS 1.1.1.1, ha lanzado una nueva aplicación, WARP. Cloudflare Warp es una aplicación gratuita ...
Leer Más
Cómo migrar el controlador Unifi

Cómo migrar el controlador Unifi

A veces, necesita migrar su controlador Unifi a un nuevo servidor, porque el actual se está volviendo demasiado lento o ...
Leer Más
Cómo configurar el enrutador (paso a paso)

Cómo configurar el enrutador (paso a paso)

Instalar y configurar un enrutador a veces puede ser un poco desafiante. ¿Cómo se conectan los cables, cómo se configura ...
Leer Más
Controlador UniFi alojado: ¿cuáles son sus opciones?

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

Las Consolas UniFi, como UDM Pro, son excelentes dispositivos para una red doméstica o redes de pequeñas y medianas empresas ...
Leer Más

Deja un comentario