UISP - Руководство по установке

Обзор

В этой статье рассказывается, как установить новую копию UISP или обновить уже установленную версию на (собственном) сервере. Это руководство по установке в ОС Linux, см. следующее примечание для операционных систем Windows и macOS:

ПРИМЕЧАНИЯ И ТРЕБОВАНИЯ:

См. раздел ниже о минимальных требованиях для установки UISP. К сожалению, правильная работа, бесперебойное резервное копирование и обновление критически важных контейнеров Docker не могут быть обеспечены в системах Windows и macOS.
В настоящее время рекомендуется установить программу виртуализации, такую как VirtualBox, для запуска последней версии 64-разрядной версии Ubuntu 18.04.3 (Bionic Beaver), а затем следовать инструкциям приведенным ниже.

Минимальные требования

ВНИМАНИЕ:

Рекомендуется установить UISP на сервере с публичным IP-адресом и полным доменным именем, который напрямую подключен к главному шлюзу сети. При таком подключении UISP будет автоматически использовать действительный доверенный сертификат от Let's Encrypt, а также будут доступны расширенные функции и своевременные сообщения о сбоях.

Конечно, можно разместить сервер UISP в другом месте сети, но при этом функциональность может быть ограничена.

Поддерживаемые дистрибутивы (виртуализированные дистрибутивы LXC официально не поддерживаются, используйте KVM):
- Ubuntu 16.04.1 LTS (Xenial Xerus) 64-разрядная.
- Ubuntu 18.04 LTS (Bionic Beaver) 64-разрядная.
- Debian 9 64-битная
2 ГБ ОЗУ (минимум)
Быстрый SSD-накопитель на 16 ГБ (минимум)
64-битный (x64) процессор
Доступ к локальным портам (см. Изменение портов HTTP и HTTPS для ручной настройки)
- 80 (автоматизация сертификатов Let's Encrypt)
- 81 (страница приостановки обслуживания)
- 443 (UI, API, связь с устройствами)
Разрешенный пинг (см. Статистика задержки устройств и простоев)
Ядро с драйвером хранилища overlay2 (см. Драйверы хранилища Docker)
Установленные bash, curl, sudo (см. Предварительные требования к установке)

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

Выполните на хосте команду ниже, чтобы установить и запустить UISP (он автоматически установит Docker, если он еще не установлен). Если UISP уже установлен, он будет перезаписан, но все данные сохранятся. Используйте ключ «--update» если необходимо сохранить параметры/настройки с предыдущей версии.

Приведенная команда: curl -fsSL https://unms.com/v1/install> /tmp/unms_inst.sh && sudo bash /tmp/unms_inst.sh всегда устанавливает самую новую стабильную версию, указанную в разделе «Новые версии программного обеспечения» сообщества Ubiquiti. Для просмотра выберите «General» в левом верхнем углу, в секции тегов (Tags) «UISP». Справа под названием с указанием версии должно быть написано «Official».

В процессе установки скрипт проверит, открыты/доступны ли TCP-порт 80 и TCP-порт 443. Если порты используются, скрипт приостановится и спросит, какие порты должны использоваться UISP. То же самое относится и к настройкам избыточной памяти. Если vm.overcommit_memory не установлено значение «1», сценарий установки запрашивает разрешение на его включение. В случае, если эти прерывания нежелательны в процессе установки, их можно подавить с помощью ключа «--unattended», который позволяет сценарию установки выполнять все необходимые действия самостоятельно.

Когда процесс будет завершен, UISP будет доступен по адресу https: //. Пожалуйста, не используйте localhost для подключения к UISP.

ПРИМЕЧАНИЕ:

Сценарий установки должен использовать разрешения sudo для установки Docker. Разрешения также необходимы для создания пользователя UISP, под которым запускается приложение UISP, а также для настройки задачи cron, которая управляет обновлениями UISP.

Зарегистрировать новые устройства в UISP можно, выполнив следующие действия:

UISP - UISP ключ и процесс регистрации устройства

Если необходимо вручную управлять процессом установки, выполните следующие действия:

UISP - Дополнительные шаги по установке

Если хотите установить версию UISP, которая не является текущей стабильной версией, см .:

UISP - Руководство по установке бета-версии

Обновление установленной версии

После инсталляции UISP будет периодически проверять наличие новых обновлений и предлагать их установку. Проверьте актуальность UISP и версию, которая установлена, в разделе Settings > Maintenance. Также в этом разделе можно вручную проверить наличие обновлений.

Рекомендуется использовать метод обновления из веб-интерфейса, а не обновление вручную с помощью командной строки. Перед использованием CLI настоятельно рекомендуется создать полную резервную копию UISP.

| UISP - Начало работы →