Guardian Eye на Linux: Полное руководство по установке

Введение

Guardian Eye работает нативно на Linux, предоставляя те же мощные функции видеонаблюдения что и на Windows - но с преимуществами стабильности, безопасности и производительности Linux.

Это руководство охватывает все необходимое для установки Guardian Eye на популярных Linux дистрибутивах, настройки камер и запуска системы видеонаблюдения.

Почему выбрать Linux для видеонаблюдения?

• Каменная стабильность - Linux серверы могут работать месяцами/годами без перезагрузки
• Лучшая производительность - Меньшее потребление ресурсов значит больше камер на том же железе
• Бесплатный и открытый - Нет затрат на лицензирование операционной системы
• Встроенный удаленный доступ - SSH для простого управления headless сервером
• Продвинутая автоматизация - systemd сервисы, cron задачи, пользовательские скрипты
• Идеально для NAS/серверов - Работает на существующей домашней серверной инфраструктуре

Системные требования

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

Поддерживаемые дистрибутивы

• Ubuntu - 20.04 LTS, 22.04 LTS, 24.04 LTS (рекомендуется для новичков)
• Debian - 11 (Bullseye), 12 (Bookworm)
• Fedora - 38, 39, 40
• Arch Linux - Rolling release (продвинутые пользователи)
• Другие - Любой дистрибутив с поддержкой .NET 8.0 runtime

Примечание: Guardian Eye построен на .NET 8.0, который поддерживает большинство современных Linux дистрибутивов. Если вашего дистрибутива нет в списке, проверьте может ли он запускать .NET 8.0 приложения.

Методы установки

Метод 1: DEB пакет (Ubuntu/Debian)

Самый простой метод для Debian-based дистрибутивов с автоматическим разрешением зависимостей.

1. Скачайте .deb пакет:
   wget https://getguardianeye.com/downloads/linux/GuardianEye-1.0.0-linux-x64.deb
2. Установите через apt:
   sudo apt install ./GuardianEye-1.0.0-linux-x64.deb

   Это автоматически установит .NET runtime и другие зависимости.

3. Проверьте установку:
   guardianeye --version

   Должно вывести: Guardian Eye v1.0.0

4. Запустите сервис:
   sudo systemctl start guardianeye
   sudo systemctl enable guardianeye # Автозапуск при загрузке

Метод 2: Tarball (Любой дистрибутив)

Ручная установка для Fedora, Arch или других не-Debian дистрибутивов.

1. Установите .NET 8.0 Runtime:
   # Ubuntu/Debian
   sudo apt install dotnet-runtime-8.0
   
   # Fedora
   sudo dnf install dotnet-runtime-8.0
   
   # Arch
   sudo pacman -S dotnet-runtime-8.0
2. Скачайте и распакуйте tarball:
   wget https://getguardianeye.com/downloads/linux/GuardianEye-1.0.0-linux-x64.tar.gz
   sudo mkdir -p /opt/guardianeye
   sudo tar -xzf GuardianEye-1.0.0-linux-x64.tar.gz -C /opt/guardianeye
3. Установите права:
   sudo chmod +x /opt/guardianeye/GuardianEye
   sudo chown -R $USER:$USER /opt/guardianeye
4. Создайте символическую ссылку (опционально):
   sudo ln -s /opt/guardianeye/GuardianEye /usr/local/bin/guardianeye
5. Запустите Guardian Eye:
   /opt/guardianeye/GuardianEye

Настройка systemd сервиса (Автозапуск)

Настройте автоматический запуск Guardian Eye при загрузке через systemd.

1. Создайте файл сервиса:
   sudo nano /etc/systemd/system/guardianeye.service
2. Добавьте конфигурацию сервиса:
   [Unit]
   Description=Guardian Eye Surveillance System
   After=network.target
   
   [Service]
   Type=notify
   User=guardianeye
   WorkingDirectory=/opt/guardianeye
   ExecStart=/opt/guardianeye/GuardianEye
   Restart=on-failure
   RestartSec=10
   
   [Install]
   WantedBy=multi-user.target
3. Создайте выделенного пользователя (best practice безопасности):
   sudo useradd -r -s /bin/false guardianeye
   sudo chown -R guardianeye:guardianeye /opt/guardianeye
4. Включите и запустите сервис:
   sudo systemctl daemon-reload
   sudo systemctl enable guardianeye
   sudo systemctl start guardianeye
5. Проверьте статус сервиса:
   sudo systemctl status guardianeye

Доступ к Guardian Eye

Доступ через GUI (Десктопные окружения)

Если вы используете десктопный Linux дистрибутив (Ubuntu Desktop, Linux Mint и т.д.):

1. Запустите из меню приложений: Приложения → Мультимедиа → Guardian Eye
2. Или запустите из терминала: guardianeye
3. Настройте камеры из меню Настройки → Камеры

Доступ через веб-интерфейс (Headless серверы)

Для серверов без GUI, Guardian Eye предоставляет веб-интерфейс:

1. Guardian Eye запускает веб-сервер на http://localhost:5000 по умолчанию
2. Доступ с другого компьютера: http://server-ip:5000
3. Настройте firewall для разрешения порта 5000:
   sudo ufw allow 5000/tcp # UFW (Ubuntu)
   sudo firewall-cmd --add-port=5000/tcp --permanent # firewalld (Fedora)
4. Для production настройте reverse proxy (nginx) с HTTPS

Настройка камер на Linux

Обнаружение USB вебкамер

Guardian Eye использует V4L2 (Video4Linux2) для USB вебкамер.

1. Список доступных вебкамер:
   v4l2-ctl --list-devices
2. Проверьте права устройства:
   ls -l /dev/video*

   Добавьте пользователя в группу video:

   sudo usermod -aG video $USER
   # Выйдите и войдите обратно для применения изменений
3. В Guardian Eye: Настройки → Камеры → Добавить камеру → USB вебкамера → Выберите /dev/video0

Настройка IP камер (RTSP)

Так же как на Windows - Guardian Eye использует стандартный RTSP протокол.

Совет по сети: Убедитесь что ваш Linux сервер и камеры в одной сети/VLAN. Проверьте связь: ping 192.168.1.100

Настройка хранилища

Выделенный диск для записей

Best practice: используйте отдельный HDD/SSD для записей.

1. Смонтируйте диск постоянно:
   sudo mkdir -p /mnt/surveillance
   sudo blkid # Найдите UUID вашего диска
   sudo nano /etc/fstab
   
   # Добавьте строку (замените UUID на UUID вашего диска):
   UUID=YOUR-UUID-HERE /mnt/surveillance ext4 defaults 0 2
   
   sudo mount -a
2. Установите права:
   sudo chown -R guardianeye:guardianeye /mnt/surveillance
   sudo chmod 755 /mnt/surveillance
3. Настройте в Guardian Eye: Настройки → Запись → Путь вывода → /mnt/surveillance/recordings

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

❌ Проблема: "GuardianEye: команда не найдена"

Решения:

• Убедитесь что PATH включает директорию установки: echo $PATH
• Создайте symlink: sudo ln -s /opt/guardianeye/GuardianEye /usr/local/bin/guardianeye
• Запустите напрямую: /opt/guardianeye/GuardianEye

❌ Проблема: USB вебкамера не обнаружена

Решения:

• Проверьте распознается ли устройство: lsusb и v4l2-ctl --list-devices
• Установите v4l-utils: sudo apt install v4l-utils
• Добавьте пользователя в группу video: sudo usermod -aG video $USER (требуется logout/login)
• Проверьте права: ls -l /dev/video0 (должно показать crw-rw----+ 1 root video)

❌ Проблема: Высокое потребление ЦП/памяти

Решения:

• Снизьте разрешение/FPS камеры в настройках
• Используйте аппаратное ускорение H.264 если доступно
• Мониторьте ресурсы: htop или systemctl status guardianeye
• Отключите зоны обнаружения движения если не нужны

Советы по оптимизации производительности

1. Используйте SSD для ОС и базы данных

Устанавливайте Guardian Eye на SSD для быстрого запуска и операций с базой данных. Используйте HDD только для записей.

2. Настройте swappiness (Серверы с ограниченной RAM)

3. Отключите GUI на серверах

Экономьте ресурсы запуская headless:

Лучшие практики безопасности

• Запуск от не-root пользователя - Всегда используйте выделенного пользователя guardianeye
• Конфигурация firewall - Разрешайте порт 5000 только с доверенных IP
• Используйте reverse proxy с HTTPS - Настройте nginx с Let's Encrypt SSL для удаленного доступа
• Изолируйте камеры в VLAN - Предотвратите доступ камер к интернету или основной сети
• Регулярные обновления - Держите Guardian Eye и системные пакеты обновленными
• Защитите хранилище записей - Шифруйте диск записей при работе с чувствительными материалами

Заключение

Guardian Eye на Linux предоставляет мощное, гибкое и экономичное решение для видеонаблюдения. Будь то домашний сервер, NAS или выделенная система безопасности, стабильность и производительность Linux делают его отличным выбором для 24/7 записи.

Краткая памятка:

1. Установите через .deb пакет (Ubuntu/Debian) или tarball (другие дистрибутивы)
2. Настройте systemd сервис для автозапуска
3. Настройте USB вебкамеры через V4L2 или RTSP IP камеры
4. Используйте выделенный диск для записей с правильными правами
5. Доступ через GUI (десктоп) или веб-интерфейс (headless серверы)
6. Оптимизируйте производительность: аппаратное ускорение, низкий FPS, swappiness
7. Обезопасьте: не-root пользователь, firewall, HTTPS reverse proxy