Skip to main content

Установка 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 Создание контейнера

  1. В веб-интерфейсе ProxmoxCreate CT
  2. Выберите шаблон Ubuntu 25.04 Standard (или ближайший доступный)
  3. Укажите параметры:
    • Cores: 1–2
    • Memory: 1024 MiB
    • Disk: 4 GiB
    • Network: DHCP или статический IP
  4. Запустите контейнер и войдите в консоль

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