Обновлено: 21.03.2026 в 08:19:36

Обновление и установка самостоятельно размещенных серверов UniFi Network (Linux)

В этой статье описаны шаги по установке и обновлению самостоятельно размещенного сервера UniFi Network до текущего стабильного релиза в системе Debian или Ubuntu с помощью APT (Advanced Package Tool). Если у вас возникнут проблемы при выполнении описанного процесса, ознакомьтесь со скриптами, предоставленными здесь, для установки и обновления приложения UniFi Network.

Требования

Для обновления сервера UniFi Network через APT необходимо создать исходные файлы или отредактировать строки в существующем файле sources.list с помощью текстовых редакторов Linux: vi или nano. Структура репозитория должна быть постоянной, но если будут какие-либо изменения, они будут указаны в сообщениях о выпуске версий программного обеспечения UniFi Network, которые можно найти в разделе Release Сообщества.

Перед обновлением сервера UniFi Network убедитесь, что вы создали резервную копию базы данных UniFi Network. Также необходимо убедиться, что пользователь имеет права sudo. Для получения дополнительной информации о добавлении пользователя в список sudo см. эту статью Debian.

Скрипты для Ubuntu или Debian

См. это сообщение в Сообществе.

Шаги по установке UniFi Network через APT

Установите необходимые пакеты, прежде чем начать, с помощью следующей команды:
```
sudo apt-get update && sudo apt-get install ca-certificates apt-transport-https
```
Используйте следующую команду, чтобы добавить новый список источников:
```
echo 'deb [ arch=amd64,arm64 ] https://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list
```
Добавьте GPG-ключи.
1. Способ A (рекомендуемый): Установите следующий доверенный ключ в /etc/apt/trusted.gpg.d:
```
sudo wget -O /etc/apt/trusted.gpg.d/unifi-repo.gpg https://dl.ui.com/unifi/unifi-repo.gpg
```
2. Способ B: Использование apt-key:
```
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 06E85760C0A52C50
```
Установите правильную версию MongoDB.
1. Новая установка UniFi: Выполните следующую команду:
```
echo "deb [trusted=yes] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/3.6 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
sudo apt-get update
```
  Примечание: В зависимости от вашего дистрибутива Linux этот шаг может не потребоваться. Если MongoDB не включена в ваш дистрибутив и недоступна в его репозитории, обратитесь к руководству по установке MongoDB (Ubuntu | Debian).
2. Существующая установка (UniFi Network v7.5 или новее): Пропустите этот шаг.
3. Существующая установка (UniFi Network v7.4 или ранее): Обратитесь к справочной статье MongoDB за инструкциями по обновлению MongoDB до версии 3.6 или новее.
Установите и обновите приложение UniFi Network с помощью следующей команды:
```
sudo apt-get update && sudo apt-get install unifi -y
```
Приложение UniFi Network теперь должно быть доступно по настроенному локальному или публичному IP-адресу компьютера, введя этот IP-адрес в строке навигации браузера (рекомендуется Chrome). Если оно не запускается, используйте следующую команду:
sudo service unifi start

При использовании приведенных выше команд предполагается, что у вас установлены sudo и wget. Дополнительную информацию о sudo можно найти здесь, а о wget здесь.

Другие полезные команды

Чтобы остановить службу UniFi: sudo service unifi stop
Чтобы перезапустить службу UniFi: sudo service unifi restart
Чтобы увидеть статус службы UniFi: sudo service unifi status

Нажмите здесь, чтобы увидеть возможные имена и кодовые названия релизов.

Примечание: Мы настоятельно рекомендуем придерживаться стабильного релиза.

"Testing" относится к релизу следующего поколения, который еще не выпущен для широкой публики. "Stable" относится к текущему стабильному релизу, который поддерживается Ubiquiti и описан в этой статье. "Old Stable" — это предыдущий стабильный релиз, который был заменен новым стабильным релизом.

Имя релиза	Кодовое название	Архивированные кодовые названия
oldstable	unifi-5.10	Эти кодовые названия были архивированы и больше не поддерживаются
stable	unifi-5.11
testing	*	unifi3, unifi4, unifi-5.3, unifi-5.4, unifi-5.5, unifi-5.6, unifi-5.7, unifi-5.8, unifi-5.9

* testing в настоящее время пуст

Расположение файлов журналов

Файлы журналов необходимы для устранения неполадок. Найдите их здесь:

/usr/lib/unifi/logs/server.log
/usr/lib/unifi/logs/mongod.log

Если ваше приложение работает в системе на основе Unix/Linux, то для доступа к этим файлам журналов потребуются права суперпользователя (sudo).

Примечания и советы

Эти примечания были добавлены благодаря сотрудничеству пользователей. Нажмите, чтобы развернуть.

Это сообщение в Сообществе содержит скрипты для установки и обновления приложения UniFi Network для любой последней версии Ubuntu или Debian.
Если вы устанавливаете в виртуальной машине или на сервере без графического интерфейса, вы можете столкнуться с проблемами энтропии. Это может быть что угодно: от медленного запуска/перезапуска службы до полного отказа службы. Решение — установить haveged. Это внешняя ссылка на руководство по этой теме.
Начиная с версии UniFi Network 5.6.x служба UniFi не работает от имени root. Это означает, что вы не можете привязываться к привилегированным портам (<1024). Приложение не запустится, если вы попытаетесь использовать эти порты.
Следующее влияет на версии APT 1.5 и новее (Ubuntu 17.10 и Debian Sid или новее). В недавней версии man-страницы apt-secure указано: «Начиная с версии 1.5 изменения в информации, содержащейся в файле Release о репозитории, должны быть подтверждены, прежде чем APT продолжит применять обновления из этого репозитория», что означает, что при выполнении обновления с одной основной версии на другую (например, с 5.5.x до 5.6.x) команда apt-get update завершится ошибкой.
- Чтобы исправить это, выполните команду следующим образом: apt-get update --allow-releaseinfo-change
- Если вы получите ошибку о том, что команда не понимается в сочетании с другими опциями, пользователи сообщают, что выполнение следующих двух команд исправляет ситуацию: выполните apt clean и нажмите Enter, затем apt-get update и Enter.
Приложение UniFi Network при установке на Debian и Ubuntu не будет иметь графического интерфейса, поскольку оно работает как служба. Пожалуйста, используйте команду service для запуска, остановки и перезапуска приложения UniFi Network.
Если вы видите следующую ошибку на своем DNS-сервере, пользователь сообщает, что решил эту проблему, заставив систему использовать 8.8.8.8 в качестве DNS-сервера, а не своего провайдера.
В настоящее время Ubiquiti не поддерживает arm64, поэтому он недоступен через репозиторий. Для этого потребуется загрузка и ручная установка.
В разделе Добавление GPG-ключей, способ B: Источник: внешняя ссылка. Для пользователей за строгими брандмауэрами следующая команда позволит им импортировать GPG-ключ:

apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 06E85760C0A52C50
Из-за зависимости от Java 8 при использовании UniFi Network 5.7.X могут потребоваться дополнительные шаги. Подробности см. в этом сообщении в Сообществе.
Команда apt-get называется apt в Ubuntu старше 16.04.

Была ли эта статья полезной?