Установка Unifi controller Ubuntu

#angelog 

 

 

 

 

 

 v1.0 — 08.11.2025 — Первая редакция инструкции 

 v1.1 — 08.11.2025 — Добавлен раздел «Установка на обычную Ubuntu» 

 

 

 

 

 

 Инструкция: Установка UniFi Network Controller в LXC-контейнере Proxmox и на обычной Ubuntu 

 

 

 

 

 

 

 

 1. Установка в LXC (Proxmox) 

 1.1 Создание контейнера 

 

 

 

 

 

 В веб-интерфейсе Proxmox → Create CT 

 Выберите шаблон Ubuntu 25.04 Standard (или ближайший доступный) 

 Укажите параметры:

 

 Cores : 1–2 

 Memory : 1024 MiB 

 Disk : 4 GiB 

 Network : DHCP или статический IP 

 

 

 Запустите контейнер и войдите в консоль 

 

 

 

 

 

 1.2 Установка UniFi Controller 

 Выполните одной строкой или по шагам: 

 

 

 

 

 

 

 bash 

 

 

 

 

 

 

 

 

 

 

 

 

 sudo apt update && sudo apt upgrade -y && \

sudo apt install curl gnupg lsb-release -y && \

sudo mkdir -p /etc/apt/keyrings && \

curl -fsSL https://dl.ui.com/unifi/unifi-repo.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/unifi-repo.gpg && \

echo "deb [signed-by=/etc/apt/keyrings/unifi-repo.gpg] https://dl.ui.com/unifi/debian stable ubiquiti" | sudo tee /etc/apt/sources.list.d/unifi.list && \

sudo apt update && \

sudo apt install unifi -y && \

sudo systemctl enable unifi && \

sudo systemctl start unifi && \

sudo systemctl status unifi 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 1.3 Проверка доступа 

 Откройте в браузере: https://<IP_контейнера>:8443 (примите самоподписанный сертификат) 

 

 

 

 

 

 

 

 2. Установка на обычную Ubuntu (сервер/десктоп) 

 2.1 Подготовка системы 

 

 

 

 

 

 

 bash 

 

 

 

 

 

 

 

 

 

 

 

 

 sudo apt update && sudo apt upgrade -y

sudo apt install curl gnupg lsb-release -y 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 2.2 Добавление репозитория UniFi 

 

 

 

 

 

 

 bash 

 

 

 

 

 

 

 

 

 

 

 

 

 sudo mkdir -p /etc/apt/keyrings

curl -fsSL https://dl.ui.com/unifi/unifi-repo.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/unifi-repo.gpg

echo "deb [signed-by=/etc/apt/keyrings/unifi-repo.gpg] https://dl.ui.com/unifi/debian stable ubiquiti" | sudo tee /etc/apt/sources.list.d/unifi.list 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 2.3 Установка и запуск 

 

 

 

 

 

 

 bash 

 

 

 

 

 

 

 

 

 

 

 

 

 sudo apt update

sudo apt install unifi -y

sudo systemctl enable unifi

sudo systemctl start unifi

sudo systemctl status unifi 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 2.4 Доступ 

 https://<IP_сервера>:8443 

 

 

 

 

 

 

 

 3. Полезные команды 

 

 

 

 

 

 

 

 

 

 

 

 

 

 Действие 

 Команда 

 

 

 

 

 Перезапуск сервиса 

 sudo systemctl restart unifi 

 

 

 Логи 

 sudo journalctl -u unifi -f 

 

 

 Обновление контроллера 

 sudo apt upgrade unifi 

 

 

 Удаление 

 sudo apt purge unifi && sudo rm -rf /var/lib/unifi 

 

 

 

 

 

 

 

 

 

 

 4. Рекомендации 

 

 

 

 

 

 Java : UniFi использует встроенную OpenJDK — ничего устанавливать не нужно 

 Порты :

 

 8443 — веб-интерфейс 

 8080, 3478/UDP — для устройств 

 

 

 Резервное копирование : /var/lib/unifi/data/backup/autobackup/ 

 Обновления : периодически sudo apt update && sudo apt upgrade unifi