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

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

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

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

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

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

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

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

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

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

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

Порт Сервис Описание
8045 INFRAX Рабочее место IT-специалистов (администраторы, техподдержка)
8040 IDENTYX Система управления пользователями (IAM)
8048 NODYX Портал для всех сотрудников и автоматизация процессов (BPM)
8049 GRAPHYX Аналитика и интерактивные дашборды (BI)

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

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

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 v2+:

⚠️ Важно для 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

Предварительные требования

Для выполнения установки необходимы утилиты curl и sudo. В минимальных серверных установках они могут отсутствовать. Установите их при необходимости:

# Ubuntu / Debian / Astra Linux
apt-get update && apt-get install -y curl sudo

# CentOS / RHEL / Rocky Linux / AlmaLinux
yum install -y curl sudo

# CentOS 8+ / RHEL 8+ / Rocky Linux / AlmaLinux (dnf)
dnf install -y curl sudo
ℹ️ Примечание

Если вы работаете не под root — запросите установку этих пакетов у администратора сервера. Если вы уже под root, sudo можно не устанавливать — просто выполните команду установки без sudo.

Автоматическая установка

Для автоматической установки на 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) — рабочее место IT-специалистов (администраторы, техподдержка): управление инфраструктурой, мониторинг, helpdesk и удалённые подключения
  • IDENTYX (порт 8040) — система управления пользователями, правами доступа и аутентификацией (IAM)
  • NODYX (порт 8048) — сервисный портал для всех сотрудников компании и автоматизация бизнес-процессов (BPM)
  • GRAPHYX (порт 8049) — аналитика и интерактивные дашборды (BI)

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

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

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

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

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

ℹ️ Приложения платформы

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

Сервис Пример URL (localhost) Назначение
INFRAX https://localhost:8045 Рабочее место IT-специалистов — мониторинг, helpdesk, удалённые подключения
IDENTYX https://localhost:8040 Управление пользователями, правами доступа и аутентификацией (IAM)
NODYX https://localhost:8048 Портал для всех сотрудников и автоматизация бизнес-процессов (BPM)
GRAPHYX https://localhost:8049 Аналитика и интерактивные дашборды (BI)
💻 INFRAX Client — Desktop приложение

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

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

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

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

  • INFRAX: https://localhost:8045 (для IT-специалистов)
  • IDENTYX: https://localhost:8040 (управление пользователями)
  • NODYX: https://localhost:8048 (портал для сотрудников)
  • GRAPHYX: https://localhost:8049 (аналитика)

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

  • INFRAX: https://192.168.1.10:8045
  • IDENTYX: https://192.168.1.10:8040
  • NODYX: https://192.168.1.10:8048
  • GRAPHYX: https://192.168.1.10:8049

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

  • INFRAX: https://infrax.mydomain.com
  • IDENTYX: https://auth.mydomain.com
  • NODYX: https://nodyx.mydomain.com
  • GRAPHYX: https://graphyx.mydomain.com

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

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

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

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

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

  1. Сначала откройте INFRAX (рабочее место IT-специалистов) по настроенному 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)

Рабочее место IT-специалистов — администраторов и техподдержки:

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

👥 IDENTYX (порт 8040)

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

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

⚙️ NODYX (порт 8048)

Портал для всех сотрудников компании и автоматизация процессов (BPM):

  • Конструктор бизнес-процессов
  • Формы и справочники
  • Пользовательские задачи
  • Дашборды и уведомления

📊 GRAPHYX (порт 8049)

Аналитика и интерактивные дашборды (BI):

  • Визуализация данных платформы
  • Отчёты и метрики
  • Дашборды по всем модулям
  • Экспорт и выгрузки

🌐 Шлюзы удалённого доступа

Удалённые подключения и запись сессий обслуживают два контейнера:

  • web-gateway — браузерные RDP/SSH/VNC и консольные сессии (Apache Guacamole), запись веб-сессий
  • native-gateway — нативные RDP/SSH/Winbox через локальный клиент, серверная запись нативных сессий

🤖 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 поддерживает установку и обновление в закрытых сетях без доступа к интернету. Офлайн-пакет содержит все файлы приложения и Docker-образы — это полный дистрибутив, готовый к развертыванию.

Подготовка офлайн-пакета

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

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

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

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

Первоначальная установка в замкнутой среде

Используйте этот вариант, если на целевой системе INFRAX ещё не установлен.

  1. Убедитесь, что на целевой системе установлены Docker и Docker Compose
  2. Скопируйте архив .tar.gz из папки ./updates/ на целевую систему (это единственный файл, который нужно перенести)
  3. Создайте папку для приложения и распакуйте архив: 
    mkdir -p /opt/infrax
tar -xzf <версия>.tar.gz -C /opt/infrax
  4. Перейдите в папку и запустите меню управления: 
    cd /opt/infrax
bash infrax.sh
  5. Выберите пункт "1. ▶️ Запустить/Перезапустить приложение"

Система автоматически обнаружит Docker-образы в папке ./images/, загрузит их и запустит все сервисы.

✅ Данные для первого входа

Логин: admin   Пароль: admin

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

Используйте этот вариант, если INFRAX уже установлен и вы хотите обновить его до новой версии.

  1. Убедитесь, что на целевой системе установлен Git (необходим для процесса обновления)
  2. Подготовьте новый пакет на системе с интернетом (пункт 8 меню)
  3. Скопируйте архив .tar.gz в папку ./updates/ на целевой системе (рядом с infrax.sh)
  4. Запустите меню управления: 
    bash infrax.sh
  5. Выберите пункт "5. 🔄 Обновить приложение"
  6. Выберите "2. Офлайн обновление (из архива)"
  7. Выберите нужную версию из списка доступных пакетов
ℹ️ Автоматическое определение режима

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

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

Ошибка "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 и 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 web-gateway

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

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

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

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

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

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

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

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

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

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

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

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