UISP установка на Debian: Полное руководство для сетевых администраторов

Если ты управляешь сетью с оборудованием Ubiquiti, MikroTik или другими устройствами, то наверняка сталкивался с необходимостью централизованного управления. UISP (ранее UNMS) — это мощное решение, которое превращает твой сервер Debian в полноценный центр управления сетью. Давай разберем, как выполнить установку UISP на Debian от начала до конца.

Что такое UISP и зачем он нужен?

UISP — это платформа для управления сетевыми устройствами, которая поддерживает оборудование Ubiquiti, MikroTik и другие через SNMP. Она объединяет в себе:

• Централизованный мониторинг устройств
• Управление конфигурациями
• Автоматическое обнаружение устройств
• Систему оповещений и отчетов
• Управление клиентами и биллинг (через UCRM)

Подготовка сервера Debian к установке UISP

Перед началом установки UISP на Debian нужно подготовить систему. Представь, что это чистый сервер с Debian 11 или новее.

1. Обновление системы и установка зависимостей

# Обновляем список пакетов
sudo apt update && sudo apt upgrade -y

# Устанавливаем необходимые пакеты
sudo apt install -y curl gnupg apt-transport-https ca-certificates software-properties-common

2. Установка Docker и Docker Compose

UISP работает в контейнерах Docker, поэтому сначала установим Docker:

# Устанавливаем Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Добавляем текущего пользователя в группу docker
sudo usermod -aG docker $USER

# Устанавливаем Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

# Проверяем установку
docker --version
docker-compose --version

Установка UISP на Debian

Теперь перейдем к основной части — непосредственной установке UISP.

3. Скачивание и запуск установщика UISP

# Скачиваем установщик UISP
curl -fsSL https://uisp.ui.com/v1/install > install-uisp.sh

# Делаем скрипт исполняемым
chmod +x install-uisp.sh

# Запускаем установку
sudo ./install-uisp.sh

Во время установки скрипт задаст несколько вопросов:

• Hostname: Доменное имя или IP-адрес сервера
• HTTP/HTTPS порты: По умолчанию 80 и 443
• Let's Encrypt: Настройка SSL сертификатов
• Путь для данных: Где хранить данные UISP (рекомендуется /home/uisp)

4. Настройка сетевых параметров

Для корректной работы UISP нужно настроить сетевые параметры ядра:

# Редактируем sysctl.conf
sudo nano /etc/sysctl.conf

# Добавляем в конец файла:
net.ipv4.ip_forward=1
net.ipv6.conf.all.forwarding=1
net.core.rmem_max=134217728
net.core.wmem_max=134217728

# Применяем изменения
sudo sysctl -p

5. Настройка firewall (если используется)

# Если используешь UFW
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 22/tcp  # SSH
sudo ufw allow 2055/udp  # NetFlow
sudo ufw allow 4789/udp  # VXLAN
sudo ufw allow 6789/tcp  # Для туннелей

# Для iptables
sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 443 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 2055 -j ACCEPT

Первоначальная настройка UISP после установки

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

6. Создание администратора и настройка организации

В веб-интерфейсе нужно:

1. Создать учетную запись администратора
2. Указать название организации
3. Настроить часовой пояс и язык
4. Выбрать валюту (если планируешь использовать биллинг)

7. Добавление первого устройства

Давай добавим первое устройство в UISP:

# На устройстве Ubiquiti нужно включить обнаружение:
ssh user@device-ip

# Для AirOS:
configure
set service uisp enabled
commit
save

# Для EdgeOS:
configure
set service unms address [uisp-server-ip]
commit
save

Оптимизация и обслуживание UISP на Debian

8. Настройка автоматических бэкапов

# Создаем скрипт для бэкапа
sudo nano /usr/local/bin/uisp-backup.sh

# Содержимое скрипта:
#!/bin/bash
BACKUP_DIR="/backup/uisp"
DATE=$(date +%Y%m%d_%H%M%S)
cd /home/uisp
docker-compose exec uisp app/bin/backup.sh
cp /home/uisp/data/backup/*.tar.gz $BACKUP_DIR/uisp_backup_$DATE.tar.gz

# Удаляем старые бэкапы (старше 30 дней)
find $BACKUP_DIR -name "*.tar.gz" -mtime +30 -delete

# Делаем скрипт исполняемым и добавляем в cron
chmod +x /usr/local/bin/uisp-backup.sh
sudo crontab -e
# Добавляем строку (бэкап каждый день в 2:00):
0 2 * * * /usr/local/bin/uisp-backup.sh

9. Мониторинг ресурсов UISP

Создадим простой скрипт для мониторинга:

#!/bin/bash
echo "=== UISP Status ==="
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" | grep uisp
echo "\n=== Resource Usage ==="
docker stats --no-stream --format "table {{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}" | grep uisp
echo "\n=== Disk Usage ==="
df -h /home/uisp

Таблица сравнения методов установки

Решение распространенных проблем

Проблема: UISP не запускается после установки

# Проверяем логи
cd /home/uisp
docker-compose logs -f uisp

# Перезапускаем сервис
docker-compose down
docker-compose up -d

# Проверяем, все ли контейнеры запущены
docker-compose ps

Проблема: Устройства не обнаруживаются

Проверь:

• Открыты ли порты 2055/udp и 6789/tcp на firewall
• Доступность сервера с устройств (ping, telnet)
• Настройки обнаружения на самом устройстве

Проблема: Высокая загрузка CPU

# Смотрим, какие процессы грузят CPU
docker stats

# Ограничиваем ресурсы для контейнеров (в docker-compose.yml)
uisp:
  image: ubnt/unms:latest
  deploy:
    resources:
      limits:
        cpus: '2.0'
        memory: 4G

Часто задаваемые вопросы (FAQ)

Заключение

Установка UISP на Debian — это процесс, который под силу даже начинающему администратору. Главное — следовать инструкциям шаг за шагом и не пропускать этап подготовки системы. После установки ты получишь мощный инструмент для управления всей сетевой инфраструктурой из единого веб-интерфейса.

Помни: регулярные бэкапы и мониторинг ресурсов — залог стабильной работы UISP. Начни с малого — добавь несколько тестовых устройств, освои интерфейс, а затем постепенно переноси всю инфраструктуру.

Твоя сеть теперь под полным контролем!