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

\#angelog

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk-v1.0-%E2%80%94-08.11.2025-%E2%80%94-"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto">- **v1.0** — 08.11.2025 — Первая редакция инструкции
- **v1.1** — 08.11.2025 — Добавлен раздел «Установка на обычную Ubuntu»

---

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

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk-"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto">---

</div></div></div></div>## 1. Установка в LXC (Proxmox)

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

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk-%D0%92-%D0%B2%D0%B5%D0%B1-%D0%B8%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81%D0%B5-pro"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto">1. В веб-интерфейсе **Proxmox** → **Create CT**
2. Выберите шаблон **Ubuntu 25.04 Standard** (или ближайший доступный)
3. Укажите параметры: 
    - **Cores**: 1–2
    - **Memory**: 1024 MiB
    - **Disk**: 4 GiB
    - **Network**: DHCP или статический IP
4. Запустите контейнер и войдите в консоль

</div></div></div></div>### 1.2 Установка UniFi Controller

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

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk-bash"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto"><div dir="auto"><div data-testid="code-block"><div>bash</div><div><div><div>  
</div></div></div><div>  
</div></div></div></div></div></div></div>```
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
```

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk--1"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto"><div dir="auto"><div data-testid="code-block"><div>  
</div><div>  
</div><div>  
</div></div></div></div></div></div></div>### 1.3 Проверка доступа

Откройте в браузере: https://&lt;IP\_контейнера&gt;:8443 (примите самоподписанный сертификат)

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk--2"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto">---

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

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

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk-bash-1"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto"><div dir="auto"><div data-testid="code-block"><div>bash</div><div><div><div>  
</div></div></div><div>  
</div></div></div></div></div></div></div>```
sudo apt update && sudo apt upgrade -y
sudo apt install curl gnupg lsb-release -y
```

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk--3"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto"><div dir="auto"><div data-testid="code-block"><div>  
</div><div>  
</div><div>  
</div></div></div></div></div></div></div>### 2.2 Добавление репозитория UniFi

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk-bash-2"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto"><div dir="auto"><div data-testid="code-block"><div>bash</div><div><div><div>  
</div></div></div><div>  
</div></div></div></div></div></div></div>```
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
```

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk--4"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto"><div dir="auto"><div data-testid="code-block"><div>  
</div><div>  
</div><div>  
</div></div></div></div></div></div></div>### 2.3 Установка и запуск

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk-bash-3"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto"><div dir="auto"><div data-testid="code-block"><div>bash</div><div><div><div>  
</div></div></div><div>  
</div></div></div></div></div></div></div>```
sudo apt update
sudo apt install unifi -y
sudo systemctl enable unifi
sudo systemctl start unifi
sudo systemctl status unifi
```

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk--5"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto"><div dir="auto"><div data-testid="code-block"><div>  
</div><div>  
</div><div>  
</div></div></div></div></div></div></div>### 2.4 Доступ

https://&lt;IP\_сервера&gt;:8443

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk--6"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto">---

</div></div></div></div>## 3. Полезные команды

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk-%D0%94%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B5-%D0%9A%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D0%B0-%D0%9F%D0%B5%D1%80"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto"><div><div><div>  
</div></div><div dir="auto"><div>  
</div><table dir="auto"><thead><tr><th data-col-size="sm">Действие</th><th data-col-size="lg">Команда</th></tr></thead><tbody><tr><td data-col-size="sm">Перезапуск сервиса</td><td data-col-size="lg">sudo systemctl restart unifi</td></tr><tr><td data-col-size="sm">Логи</td><td data-col-size="lg">sudo journalctl -u unifi -f</td></tr><tr><td data-col-size="sm">Обновление контроллера</td><td data-col-size="lg">sudo apt upgrade unifi</td></tr><tr><td data-col-size="sm">Удаление</td><td data-col-size="lg">sudo apt purge unifi &amp;&amp; sudo rm -rf /var/lib/unifi</td></tr></tbody></table>

<div>  
</div></div></div>---

</div></div></div></div>## 4. Рекомендации

<div class="bubble hide-name is-out can-have-tail is-read" data-mid="282120" data-peer-id="485420996" data-timestamp="1762263211" id="bkmrk-java%3A-unifi-%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D1%83"><div class="bubble-content-wrapper"><div class="bubble-content"><div class="message spoilers-container" dir="auto">- **Java**: UniFi использует встроенную OpenJDK — ничего устанавливать не нужно
- **Порты**: 
    - 8443 — веб-интерфейс
    - 8080, 3478/UDP — для устройств
- **Резервное копирование**: /var/lib/unifi/data/backup/autobackup/
- **Обновления**: периодически sudo apt update &amp;&amp; sudo apt upgrade unifi

  
</div></div></div></div>