Установка и развертывание

Выберите способ установки для вашей операционной системы:

Windows Установщик (.exe) Linux Linux Автоустановка (curl) macOS Ручная установка Офлайн Замкнутая среда
Содержание раздела

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

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

Компонент Минимум Рекомендуется
Процессор 2 ядра 4 ядра
Оперативная память 4 GB 8 GB+
Дисковое пространство 20 GB 50 GB+ (с учетом резервных копий)
Операционная система Windows 10/11, Linux (Ubuntu 20.04+, CentOS 8+), macOS 11+
ℹ️ Важно

Фактические требования к ресурсам зависят от:

  • Интенсивности использования системы
  • Количества одновременных пользователей
  • Количества отслеживаемых узлов сети
  • Частоты мониторинга и объема собираемых метрик

Для крупных инфраструктур рекомендуется увеличивать ресурсы пропорционально нагрузке.

Сетевые порты

Следующие порты должны быть свободны на сервере:

Порт Сервис Описание
8045 INFRAX Основное приложение (веб-интерфейс)
8040 IDENTYX Система управления пользователями (IAM)
8042 INFRAX Порт для подключений через нативные клиенты

Предварительная подготовка

Перед установкой необходимо установить следующее ПО:

Git

Для клонирования репозитория и получения обновлений:

  • Windows: Git for Windows
  • macOS: встроенный или Git
  • Linux: встроенный или установка через пакетный менеджер: 
    # Ubuntu/Debian
sudo apt-get install git

# CentOS/RHEL
sudo yum install git

Docker Desktop

Включает Docker Engine 20.10+ и Docker Compose 2.0+:

⚠️ Важно для Windows

После установки Docker Desktop:

  1. Убедитесь, что Docker Desktop запущен
  2. Перезапустите командную строку или PowerShell
  3. Проверьте доступность командой: docker --version

Установка на Windows

Для пользователей Windows доступен готовый установщик, который автоматизирует весь процесс установки:

  1. Скачайте установщик: infrax-installer.exe
  2. Запустите infrax-installer.exe
  3. Следуйте инструкциям установщика
  4. Дождитесь завершения установки

Установщик автоматически:

  • Проверит наличие Docker Desktop
  • Клонирует репозиторий
  • Загрузит необходимые Docker образы
  • Запустит систему
  • Создаст ярлык на рабочем столе для управления приложением

🖥️ Управление приложением на Windows

После установки на рабочем столе появится ярлык "INFRAX", который запускает скрипт C:\Program Files\INFRAX\app\infrax.bat. Используйте этот ярлык для доступа к меню управления приложением:

  • Запуск и остановка системы
  • Создание резервных копий
  • Обновление приложения
  • Настройка параметров
💡 Примечание

Для Linux доступна установка через скрипт (см. раздел ниже). Для macOS или ручной установки следуйте инструкциям в разделе "Ручная установка".

Установка на Linux

Для автоматической установки на Linux выполните команду:

curl -fsSL https://git.audit-telecom.ru/infrax/other/-/raw/master/install.sh | sudo bash

Скрипт установит Docker, Git, склонирует репозиторий в /opt/infrax и создаст глобальную команду infrax.

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

  • Ubuntu 20.04+
  • Debian 10+
  • Astra Linux
  • CentOS 8+
  • RHEL 8+
  • Rocky Linux 8+
  • AlmaLinux 8+

Управление системой

После установки для управления системой используйте глобальную команду:

sudo infrax

Или напрямую через скрипт:

sudo /opt/infrax/infrax.sh

Ручная установка

Для Linux, macOS или ручной установки на Windows:

💡 Рекомендация для Linux

Рекомендуется устанавливать приложение в директорию /opt/infrax для соответствия стандартам FHS (Filesystem Hierarchy Standard) и удобства управления, однако приложение может быть установлено в любую директорию — все пути определяются автоматически:

sudo mkdir -p /opt
cd /opt
sudo git clone https://git.audit-telecom.ru/infrax/infrax.git infrax
cd infrax

Установка в другую директорию: Вы можете клонировать репозиторий в любую директорию, например /home/user/infrax или /var/infrax — система будет работать корректно.

Шаг 1: Клонирование репозитория

Linux (рекомендуется в /opt/infrax):

sudo git clone https://git.audit-telecom.ru/infrax/infrax.git /opt/infrax/
cd /opt/infrax

macOS / Windows:

git clone https://git.audit-telecom.ru/infrax/infrax.git
cd infrax

Шаг 2: Запуск системы

Linux (если установлено в /opt/infrax):

sudo /opt/infrax/infrax.sh

Linux (другая директория) / macOS / Git Bash:

bash infrax.sh

Windows (при установке через инсталлятор):

  • Запустите ярлык "INFRAX" на рабочем столе
  • Или вручную запустите: C:\Program Files\INFRAX\app\infrax.bat

Windows (ручная установка):

infrax.bat

Шаг 3: Ожидание развертывания

Первый запуск может занять 1-2 минуты, так как система загружает Docker образы и инициализирует базы данных.

✅ Готово!

После завершения развертывания все сервисы будут доступны.

Первый запуск

Настройка URL приложений

⚙️ Критически важно: Обязательная настройка при первом запуске

При первом запуске система обязательно потребует настроить URL-адреса для двух компонентов платформы! Без этой настройки приложение не запустится.

INFRAX состоит из двух взаимосвязанных приложений:

  • INFRAX (порт 8045) — основное рабочее приложение для управления инфраструктурой, мониторинга, helpdesk и удаленных подключений
  • IDENTYX (порт 8040) — система управления пользователями, правами доступа и аутентификацией (IAM)

Вам будут доступны три варианта настройки:

  1. Использовать localhost (по умолчанию) — для локального использования на одном компьютере
    • INFRAX: https://localhost:8045 (основное приложение)
    • IDENTYX: https://localhost:8040 (управление пользователями)
  2. Ввести IP-адрес сервера — для доступа из локальной сети (например, 192.168.1.10)
    • INFRAX: https://192.168.1.10:8045
    • IDENTYX: https://192.168.1.10:8040
  3. Указать кастомные URL — для работы через reverse proxy при публикации в продакшн
    • INFRAX: https://infrax.yourdomain.com
    • IDENTYX: https://auth.yourdomain.com

Важно: Приложения будут доступны ТОЛЬКО по указанным URL. URL можно изменить в любое время через пункт меню "7. ⚙️ Настроить URL приложений", но потребуется перезапуск приложения.

Доступ к системе

После настройки URL и успешного запуска откройте в браузере настроенные вами адреса приложений:

ℹ️ Два компонента платформы

Платформа INFRAX состоит из двух взаимосвязанных приложений. Для полноценной работы необходим доступ к обоим:

Сервис Пример URL (localhost) Назначение
INFRAX https://localhost:8045 Основное рабочее приложение — мониторинг, helpdesk, удаленные подключения
IDENTYX https://localhost:8040 Управление пользователями, правами доступа и аутентификацией (IAM)
💻 INFRAX Client — Desktop приложение

Предпочитаете отдельное приложение вместо браузера? Скачайте INFRAX Client — кросс-платформенное desktop приложение для Windows, macOS и Linux.

Узнать больше о INFRAX Client →

🌐 Примеры настройки URL для разных сценариев

Для локального использования:

  • INFRAX: https://localhost:8045 (основное приложение)
  • IDENTYX: https://localhost:8040 (управление пользователями)

Для корпоративной сети (прямой доступ по IP):

  • INFRAX: https://192.168.1.10:8045
  • IDENTYX: https://192.168.1.10:8040

Для публичного доступа (через reverse proxy):

  • INFRAX: https://infrax.mydomain.com
  • IDENTYX: https://auth.mydomain.com

📖 См. Публикация в продакшн — готовые конфигурации для Nginx, Traefik, Caddy, HAProxy и Apache

Данные для входа

🔑 Учетные данные по умолчанию

  • Логин: admin
  • Пароль: admin
⚠️ Безопасность

Обязательно смените пароль администратора после первого входа!

  1. Сначала откройте INFRAX (основное приложение) по настроенному URL, например https://localhost:8045
  2. Затем войдите в IDENTYX (управление пользователями) по настроенному URL, например https://localhost:8040
  3. В IDENTYX откройте профиль администратора
  4. Установите новый надежный пароль

Примечание: Вход в INFRAX автоматически перенаправит вас на IDENTYX для аутентификации, если вы еще не авторизованы.

Самоподписанный сертификат

По умолчанию система использует самоподписанный SSL сертификат. При первом входе браузер покажет предупреждение о безопасности:

  1. В Chrome/Edge: нажмите "Дополнительно" → "Перейти на сайт"
  2. В Firefox: нажмите "Дополнительно" → "Принять риск и продолжить"

Для продакшн-среды рекомендуется настроить собственный SSL сертификат.

Архитектура системы

Платформа INFRAX состоит из трех основных компонентов:

🖥️ INFRAX (порты 8045, 8042)

Основное рабочее приложение для:

  • Управления IT-инфраструктурой
  • Мониторинга узлов сети
  • Удаленных подключений к серверам/рабочим станциям/сетевому оборудованию
  • Работы с тикетами Helpdesk
  • Управления задачами и автоматизацией

👥 IDENTYX (порт 8040)

Система управления идентификацией и доступом (IAM):

  • Администрирование пользователей
  • Управление правами доступа
  • Управление проектами
  • Роли и политики безопасности

🎥 Video Gateway

Видео шлюз для записи сессий:

  • Запись удаленных RDP/SSH/VNC сессий
  • Хранение видеозаписей подключений
  • Аудит действий пользователей

Примечание: работает внутри контейнера INFRAX, не требует отдельного порта

🤖 INFRAX AI

Система искусственного интеллекта:

  • Интеллектуальный анализ данных
  • Автоматизация рутинных задач
  • Умные рекомендации и подсказки

Меню управления

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

Windows:

  • Запустите ярлык "INFRAX" на рабочем столе (создается автоматически при установке)
  • Или вручную запустите: C:\Program Files\INFRAX\app\infrax.bat

Linux (установлено через скрипт в /opt/infrax):

sudo infrax

Linux (ручная установка в /opt/infrax):

sudo /opt/infrax/infrax.sh

Linux (другая директория) / macOS / Git Bash:

bash infrax.sh

Доступные функции

=================================
    🚀 INFRAX УПРАВЛЕНИЕ
=================================

1. 🟢 Запустить приложение
2. 🔴 Остановить приложение  
3. 💾 Сделать резервную копию
4. ⏪ Восстановить из резервной копии
5. 🔄 Обновить приложение
6. 🔀 Переключить канал обновлений (стабильный/бета)
7. ⚙️ Настроить URL приложений
8. 📦 Подготовить пакет для замкнутой среды
9. 🧨 Удалить ВСЕ данные (требует полной остановки)
10. 🔓 Восстановить доступ администратора
0. ❌ Выйти

Описание функций

Функция Описание
Запустить приложение Запускает все Docker контейнеры системы
Остановить приложение Останавливает все Docker контейнеры без удаления данных
Резервная копия Создает резервную копию всей директории приложения. Архив сохраняется в ./backups/ в формате .tar.gz с меткой даты и времени
Восстановление Восстанавливает данные из выбранной резервной копии (.tar.gz). Перед восстановлением автоматически предлагается создать защитную копию текущего состояния
Обновление Обновляет систему до последней версии (онлайн или офлайн)
Канал обновлений Переключение между стабильным (master) и бета (beta) каналом
Настройка URL Изменение портов и адресов для доступа к сервисам
Подготовка пакета Создание офлайн-пакета для установки в замкнутой среде
Удалить данные Полное удаление всех данных приложения (баз данных, конфигурации, логов)
Восстановить доступ администратора Сброс пароля администратора и восстановление доступа к системе (требует запущенного приложения)

Каналы обновлений

Канал Ветка Описание
Стабильный master Проверенные версии для рабочих систем
Бета beta Новые функции, возможны ошибки, для тестирования

Работа в замкнутой среде

Для установки и обновления INFRAX в закрытых сетях без доступа к интернету:

Первоначальная установка

На системе с интернетом:

  1. Клонируйте репозиторий: 
    git clone https://git.audit-telecom.ru/infrax/infrax.git
cd infrax
  2. Запустите меню управления: 
    bash infrax.sh
  3. Выберите пункт "8. 📦 Подготовить пакет для замкнутой среды"
  4. Дождитесь завершения подготовки пакета

Система автоматически:

  • Скачает все Docker образы
  • Создаст архив с приложением и образами
  • Поместит готовый пакет в папку ./updates/

Перенос на целевую систему:

  1. Скопируйте всю папку проекта infrax/ (включая ./updates/) на целевой сервер
  2. Убедитесь, что на целевой системе установлены Docker и Git

На целевой системе:

  1. Перейдите в папку проекта: 
    cd infrax
  2. Запустите меню управления: 
    bash infrax.sh
  3. Выберите пункт "5. 🔄 Обновить приложение"
  4. При наличии архивов в ./updates/ система предложит выбрать версию для установки
  5. Подтвердите установку из офлайн-пакета

Обновление в замкнутой среде

Процесс аналогичен первоначальной установке:

  1. На системе с интернетом подготовьте новый пакет (пункт 8 меню)
  2. Перенесите архив из ./updates/ на целевую систему в папку ./updates/
  3. Запустите обновление (пункт 5 меню)
  4. Выберите нужную версию из списка доступных офлайн-пакетов
ℹ️ Автоматическое определение режима

Система автоматически определяет наличие офлайн-пакетов и предлагает выбор между онлайн и офлайн обновлением.

Устранение неисправностей

Ошибка "Bash не найден" (Windows)

❌ Bash не найден!
Установите Git for Windows: https://git-scm.com/download/win

Решение:

  1. Установите Git for Windows, который включает bash
  2. Перезапустите командную строку
  3. Повторите запуск infrax.bat

Ошибка "Docker не найден"

❌ Docker не найден в PATH!

Решение:

  1. Установите Docker Desktop
  2. Убедитесь, что Docker Desktop запущен
  3. Перезапустите командную строку
  4. Проверьте установку: docker --version

Порты заняты

Если при запуске возникает ошибка о занятых портах:

  1. Убедитесь, что порты 8040, 8042, 8045 свободны
  2. Проверьте занятые порты: 
    # Windows
netstat -ano | findstr "8045"

# Linux/macOS
sudo lsof -i :8045
  3. Остановите конфликтующие приложения или измените порты через меню управления (пункт 7)

Docker контейнеры не запускаются

Проверьте статус Docker:

docker ps -a

Просмотр логов контейнеров:

docker compose logs infrax
docker compose logs identyx
docker compose logs video-gateway

Перезапуск системы:

  1. Остановите приложение (пункт 2 меню)
  2. Подождите полной остановки всех контейнеров
  3. Запустите приложение заново (пункт 1 меню)

Проблемы с доступом через браузер

Если система не открывается в браузере:

  1. Проверьте, что все контейнеры запущены: 
    docker ps
  2. Убедитесь, что используете https:// (не http://)
  3. Попробуйте очистить кэш браузера и cookies
  4. Попробуйте другой браузер
  5. Проверьте, что файрвол не блокирует порты 8040, 8042, 8045

Недостаточно ресурсов Docker

Если система работает медленно или контейнеры падают:

  1. Откройте настройки Docker Desktop
  2. Перейдите в Resources
  3. Увеличьте выделенные ресурсы:
    • CPU: минимум 2 ядра, рекомендуется 4
    • Memory: минимум 4GB, рекомендуется 8GB
    • Disk: минимум 20GB
  4. Нажмите Apply & Restart
💬 Нужна помощь?

Если проблема не решена:

  • Изучите официальную документацию
  • Обратитесь в поддержку через официальный сайт
  • Проверьте логи контейнеров для деталей ошибки
🚀 Следующий шаг: Публикация в продакшн

После успешной установки и тестирования системы вы можете опубликовать INFRAX в продакшн с доменными именами и SSL сертификатами.

📖 Читать далее: Публикация в продакшн