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

Содержание раздела

Системные требования
Предварительная подготовка
Установка для Windows
Ручная установка
Первый запуск
Архитектура системы
Меню управления
Работа в замкнутой среде
Устранение неисправностей

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

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

Компонент	Минимум	Рекомендуется
Процессор	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`	Video Gateway	Видео шлюз для записи сессий

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

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

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 for Windows
macOS: Docker Desktop for Mac
Linux: Docker Engine + Docker Compose

⚠️ Важно для Windows

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

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

Простая установка для Windows

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

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

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

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

💡 Примечание

Если вы предпочитаете ручную установку или используете Linux/macOS, следуйте инструкциям в разделе "Ручная установка" ниже.

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

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

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

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

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

Linux / macOS / Git Bash:

bash infrax.sh

Windows (Command Prompt или PowerShell):

infrax.bat

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

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

✅ Готово!

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

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

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

После успешного запуска откройте в браузере:

Сервис	URL	Назначение
Infrax	https://localhost:8045	Основное рабочее приложение
Identyx	https://localhost:8040	Управление пользователями и правами

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

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

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

⚠️ Безопасность

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

Войдите в Identyx (https://localhost:8040)
Откройте профиль администратора
Установите новый надежный пароль

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

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

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

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

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

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

🖥️ Infrax (порт 8045)

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

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

👥 Identyx (порт 8040)

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

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

🎥 Video Gateway (порт 8042)

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

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

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

Linux / macOS / Git Bash:

bash infrax.sh

Windows (Command Prompt):

infrax.bat

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

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

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

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

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

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

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

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

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

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

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

Клонируйте репозиторий:

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

Запустите меню управления:
```
bash infrax.sh
```
Выберите пункт "8. 📦 Подготовить пакет для замкнутой среды"
Дождитесь завершения подготовки пакета

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

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

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

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

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

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

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

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

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

ℹ️ Автоматическое определение режима

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

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

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

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

Решение:

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

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

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