UniFi — How to Install and Update via APT on Debian or Ubuntu

This article provides the steps to update the UniFi Network Controller on a Debian or Ubuntu system via APT (Advanced Package Tool). If you run into issues following the process described in this article, please take a look at the scripts provided in this Community post that includes UniFi Network Controller software installation on Ubuntu 18.04 and 16.04 and Debian 8/9.

Table of Contents

Introduction

In order to update the UniFi Network Controller via APT, it is necessary to create source files or edit lines in an existing sources.list file with Linux text editors: vi or nano. That is the most common method for package updates and installs for these operating systems. The repo structure should be permanent, but if there are any changes they will be pointed out in the UniFi Network Controller software version release posts, found in the Community.

Follow the instructions below to stay with the current stable release, regardless of changes in versions. When there is a new stable release, there will be a post on the Community announcing it.

UniFi Network Controller APT Steps

1. Install required packages before you begin with the following command:

2. Use the following command to add a new source list:

3. Add the GPG Keys. To add the GPG Keys use one of the two methods described below (Method A is recommended). When using the commands below, it is assumed you have sudo and wget installed, more information about sudo can be found here, and wget here.

(Method A) Install the following trusted key into /etc/apt/trusted.gpg.d

(Method B) Using apt-key.

4. Install and upgrade the UniFi Network Controller.

This should restrict Ubuntu from automatically installing Java 11. If you wish to undo this later, replace «hold» with «unhold».

5. This step may not be required, depending on the Linux distro you have. If your distro does not come with MongoDB, and it’s not available in their repo, then please see the MongoDB installation guide. You can find the latest installation guide for Ubuntu here, and Debian here. We recommend at least MongoDB 2.6.10. Some users have changed the backend to use MongoDB 3 successfully too.

6. The UniFi Network Controller should now be accessible at the computer’s configured local or public IP address, by typing that IP address in a browser’s navigation bar (Chrome is recommended). If it is not launching, use the following command: sudo service unifi start .

Other helpful commands are:

• To stop the UniFi service: sudo service unifi stop
• To restart the UniFi service: sudo service unifi restart
• To see the status of UniFi service: sudo service unifi status

We strongly recommend staying with the stable release, but for those users who wish to do otherwise, click here to expand and see possible suite names, as well as code names in the table within.

«Testing» refers to the next generation release, it’s not released to the general public yet. «Stable» refers to the current stable release, that is the one supported by Ubiquiti and described in this article. «Old Stable» is the previous stable release, once it has been displaced by the new, current stable release.

unifi3, unifi4, unifi-5.3, unifi-5.4, unifi-5.5, unifi-5.6, unifi-5.7, unifi-5.8, unifi-5.9

*testing is empty at the moment

Log Files Location

Log files will be essential for any troubleshooting you might perform. Find them here:

User Notes & Tips

These notes have been added thanks to user collaboration.

• This Community post shares some scripts for UniFi Controller software installation on Ubuntu 18.04 and 16.04 and Debian 8/9.
• If you are installing in a VM or a headless server, you may encounter entropy issues. This could be anything from slow service start/restart to complete service failure. The fix is to install haveged . This is an external link for a tutorial on the subject.
• Since UniFi Controller version 5.6.x the UniFi service does not run as root. This means that you cannot bind to privileged ports ( apt-get update will result in an error.
  • To fix this run the command the following way: apt-get update —allow-releaseinfo-change
  • If you receive an error stating the command is not understood in combination with the other options, users have reported that issuing the following two commands has fixed it: issue apt clean and hit enter, followed by apt-get update and enter.
• The UniFi Controller, when installed on Debian and Ubuntu, will not have a GUI since it’s being run as a Service. Please use the service command for starting, stopping and restarting the UniFi Controller.
• If you see the following error on your DNS server, a user reports solving this by forcing the system to use 8.8.8.8 as DNS server, not his ISP.
• At the moment Ubiquiti does not support arm64, hence it is not available via the repo. A download and manual installation will be necessary for this.
• In the Add the GPG Keys, method B:Source: External Link. For users behind restrictive firewalls the following command will allow them to import the GPG key:

  UniFi — Как с помощью APT установить или обновить UniFi в Debian/Ubuntu

  В данной статье приведен список файлов с исходными кодами, которые необходимо создать, а также строки, файла sources.list, которые можно использовать для установки и обновления UniFi на системе с Debian или Ubuntu с помощью APT. Описанный метод является стандартным методом установки и обновления пакетов в этих ОС. Предполагается, что содержание размещенных в нашем хранилище файлов статей меняться не будет, однако если изменения все-таки будут внесены, об этом будет сообщено в распространяемых электронными способами сообщениях. Это касается и данной статьи.

  Как с помощью APT установить или обновить контроллер UniFi

  Добавьте файл /etc/apt/sources.list.d/100-ubnt.list (или отредактируйте файл /etc/apt/sources.list). Параметр ‘stable’ в исходном коде является плавающим. Если требуется оставить какую-либо ветку свободной, укажите ее в строке исходного кода (например, для UniFi v5 в исходном коде используйте ‘unifi5’ и т. д.).

  Добавьте ключи GPG:

  # для Ubiquiti sudo apt-key adv —keyserver keyserver.ubuntu.com —recv C0A52C50 # или по HTTP, используя hkp://keyserver.ubuntu.com:80

  Обновление, установка или модификация контроллера:

  # восстановление последней информации пакета sudo apt-get update # установка/обновление контроллера unifi sudo apt-get install unifi

  (Опция) Данный шаг может и не потребоваться (зависит от использованного дистрибутива Linux). Если в дистрибутиве отсутствует MongoDB и в хранилище файлов, откуда был взят дистрибутив, этот компонент недоступен, см. руководство по установке MongoDB. Самую новую версию руководства по установке Ubuntu см. ЗДЕСЬ , а Debian ЗДЕСЬ . Mongo 3 может работать ненадежно с функцией резервного копирования UniFi, не забудьте об этом, когда будете обновлять Mongo. В настоящее время предпочтительнее использовать Mongo 2.

  Прямого доступа к хранилищу файлов (а также к спискам его файлов) не предоставляется. Если Вы попытаетесь напрямую открыть папку, то будет выдано сообщение 403 о том, что доступ запрещен.

  Установка UniFi v4.7.6 Controller на Ubuntu Server 14.04 LTS

  Программный контроллер управления точками доступа UniFi может быть развёрнут как под управлением OC Microsoft Windows так и под управлением OC Linux. В этой заметке будет рассмотрен пример установки UniFi v4.7.6 Controller на свежеустановленную ОС Ubuntu Server 14.04 LTS 64-bit. Актуальная на данный момент версия контроллера 4.7.6 является hotfix release, поэтому замечания об установке в среде Linux можно будет найти в предудущем релизе — UniFi Updates Blog — UniFi 4.7.5 is released .

  Для начала добавим на нашем Ubuntu-сервере 2 дополнительных apt-репозитория в source list:

  Затем добавим PGP ключи для доверия пакетам (первый для unifi, второй для mongodb):

  Если наш сервер подключен к Интернет через прокси, то возможно получение ошибки таймаута соединения с сервером ключей. В таком случае для начала проверим есть ли в конфиге APT информация о прокси:

  Должна присутсвовать запись типа:

  Но этой настройки может оказаться недостаточно. Создадим переменные окружения для текущего пользователя, в которые запишем параметры прокси:

  Проверим создались ли переменные:

  Повторим попытку добавления ключей с использованием переменных окружения текущего пользователя (в команду sudo добавляем ключик -E):

  Теперь «со спокойной душой» обновляем APT и устанавливаем контроллер с зависимостями:

  будет предложено установить ряд дополнительных пакетов, соглашаемся:

  После установки перезагружаем сервер и убеждаемся в том, что веб-интерфейс контроллера доступен нам через URL вида https://ip:8443

  

  Как видим, нам доступен мастер первоначальной настройки UniFi Controller, поэтому задача установки может считаться выполненной.

  Unifi wifi controller ubuntu windows

  Точки доступа

  Контроллеры для точек доступа

  Wi-Fi антенны

  Материнские платы

  Радиокарты

  Беспроводные USB адаптеры

  Усилитель сигнала Wi-Fi (репитер)

  Блоки питания, РОЕ, инжекторы

  Грозозащита

  Кабель UTP, FTP, коннекторы

  Патч-корды

  Сетевые компоненты и инструмент

  Корпуса

  Крепежная фурнитура

  Переходники и кабели USB, HDMI, DVI, SATA, 3RCA

  Пигтейлы

  Сетевые фильтры

  SFP, SFP+ — модули/патч-корды/DAC-кабель

  Медиаконвертеры

  Силовой кабель

  KVM переключатели

  Неуправляемые коммутаторы

  Управляемые коммутаторы

  IP телефоны

  VoIP шлюзы

  IP-ATC

  Аксессуары для VoIP-оборудования

  IP-камеры

  Регистраторы

  Аксессуары для видеонаблюдения

  Видеодомофоны

  Аналоговые видеокамеры

  Контроллеры для умного дома

  Датчики

  MikroTik

  Ubiquiti Networks

  Edimax

  Ajax Systems

  Оборудование от производителя Keenetic

  LigoWave

  Rf elements

  Yealink

  HPE Aruba Networks

  Alfa Network

  EnGenius

  TP-Link

  Infomir

  ITElite

  Edge-Core

  Info-Sys

  GAOKE

  Escene

  TG-NET

  Сетевые карты и адаптеры

  Принт-серверы

  Сетевые накопители (NAS, DAS)

  USB-концентраторы

  Универсальные внешние аккумуляторы

  Очень хорошо для офисной или небольшой корпоративной сети,

  но мало для провайдера.

  На тесте было три UniFi AP, под сервер использовался:

  • Intel(R) Pentium(R) 4 CPU 3.06GHz HT, RAM 2Ggb, HDD 160 Ggb.
  • OS: Ubuntu Studio 10.10 x86 (рекомендую не ставить х64, так как есть проблемы с установкой).

  Инструкция по установке:

  1. Устанавливаем из пакетов mongoDB и dhcp3-server, так как он нужен для сервера управления. Настроить dhcp3-server очень просто. Выкладываю свой конфиг:

  subnet 192.168.1.0 netmask 255.255.255.0 <

  # Прописываем диапазон выдаваемых адресов от и до:

  range 192.168.1.10 192.168.1.30;

  # И шлюз по умолчанию:

  option routers 192.168.1.1;

  # Привязываем точки доступа каждую к своему адресу:

  hardware ethernet 00:27:22:1e:11:11;

  hardware ethernet 00:27:22:1e:11:12;

  hardware ethernet 00:27:22:1e:11:13;

  Следующий файл конфигурации:

  # Прописываем интерфейс, который смотрит у нас на точки доступа:

  # service dhcp3-server start (должен написать [OK])

  Dhcp3-server запущен, можно приступать к установке UniFi controller.

  2. Правим /etc/apt/sources.list . Добавляем репозиторий:

  deb https://www.ubnt.com/downloads/unifi/distros/deb/maverick maverick ubiquiti

  3. Добавляем в терминале через sudo GPG key:

  sudo apt-key adv —keyserver keyserver.ubuntu.com —recv C0A52C50

  4. Устанавливаем пакет UniFi:

  apt-get install unifi

  После установки, рекомендую выключить репозиторий, так как могут возникнуть проблемы с установкой пакетов. Если ошибок не выскочило, то система установлена и уже даже работает.

  5. После установки заходим на https://localhost:8080/, либо на https://IP-адрес:8080/, подтверждаем сертификат, и входим в систему через Ubiquiti UniFi Wizard. Думаю, для Вас не составит труда разобраться, что и как.

  Необходимо ещё настроить интерфейс, в который включен AP:

  # ping 192.168.1.20, точка должна ответить.

  6. Подключаем, если ещё не подключили, в систему UniFi AP. Если они не были включены, или были, но визард контроллера их не нашёл, необходимо зажать на 5 секунд кнопку сброса. После определения, система прошивает AP в прошивку версии контроллера, поэтому не нужно бояться, что точка около 5 мин не идентифицируется, и ГЛАВНОЕ не выключайте её.

  Настройка утсройства:

  Заходим в систему Settings → Wireless Network → Create.

  Прописываем SSID, например Office, выставляем шифрование и ключ. Режим гостевой не включал за ненадобностью.

  А теперь очень важный момент — настройка Vlan. После установки Vlan, например 111, на сетевом интерфейсе его необходимо тоже добавить. По умолчанию пакет не установлен в системе, так что выберите пакет vlan в менеджере пакетов либо из командной строки:

  После успешной установки:

  Про добавление в автозагрузку настройки Vlan-ов читайте в google или на форумах.

  Создаём вторую сеть, так же как и первую:

  заходим в систему Settings → Wireless Network → Create;

  прописываем SSID, например Buhgalteriya, выставляем шифрование и ключ.

  Теперь мы имеем 2 SSID, 2 Vlan. Добавить можно ещё 2, по своему усмотрению.

  Произведём необходимые настройки DHCP для автоматического подключения абонентов. Даём офисным работникам ключ сети для SSID Office и бухгалтерии ключ сети, также в настройках контроллера можно выставить приоритет для каждой подсети. Предположим, что бухгалтеру важнее поработать с Банк-Клиентом, чем офисному работнику покачать фильмы, поэтому отдаём приоритет в HIGH в настройках UniFi контроллера, там где мы прописывали SSID и Vlan.

  Проверено и работает, абонент который подключен к SSID Office, не увидит никаким образом пользователя из бухгалтерии и наоборот, так как у каждого свой Vlan на уровне контроллера.

  В конце хотелось бы добавить преимущества Ubiquiti UniFi:

  эргономичность и привлекательный дизайн;

  поддержка Multi-SSID (наконец-то дождались).

  Контроллеру необходимо где-то быть установленным (тут достаточно и БУ компьютера). Если в офисе есть сервер, то использовать можно его, но всё ПО написано на JAVA, что не есть лёгким в обработке.

  Для провайдеров эти устройства подойдут разве что для покрытия помещения, но в прошивке AP, которая будет работать без контроллера и его функционала.

  Вывод. Если в дальнейшем в настройках контроллера появится возможность группировать AP по зонам с добавлением на группы Vlan-ов, а также появятся модели AP уличного типа, то Ubiquiti Networks выйдет на рынок с решением для покрытия городских сетей, что при нынешних ценах на оборудование других брендов будет очень выгодно небольшим провайдерам, имеющим лицензию на частоту 2,4 Ггц.

  И маленькое пожелание: хотелось бы увидеть аппаратное решение контроллера данного производителя и расширение функционала.

  Валерий Бурец специально для ASP24.

  Оцените статью
  Вам также может понравиться

  

  Windows или Linux: Что лучше выбрать?

  Есть много причин выбирать между Windows и Linux, но

  

  Файл владелец изменить linux

  Команда Chown в Linux Chown Command in Linux (File

  

  Установка шлюза по умолчанию linux

  Настройка сети вручную Содержание Краткое описание

  

  Чем разбить диск для linux

  ИТ База знаний Курс по Asterisk Полезно — Узнать IP —
  • Правообладателям
  • Политика конфиденциальности
  • Контакты