Установка

Установка серверной части

СОПКА.Рой разворачивается в локальной инфраструктуре заказчика или в выделенном контуре, согласованном договором. Серверная часть поставляется как контейнерный состав: приложение, фоновые задачи, PostgreSQL, ClickHouse, серверные службы, объектное хранилище и веб-прокси. Приложение может работать в нескольких экземплярах.

1. Подготовьте сервер или виртуальную машину согласно системным требованиям.
2. Создайте и заполните .env: адрес публикации, секреты, параметры БД, хранения и политики обновлений.
3. Проверьте итоговую конфигурацию и запустите контейнерный стек.
4. Убедитесь, что веб-интерфейс открывается по полному согласованному HTTPS-адресу; /roy ниже используется как пример префикса.
5. Создайте рабочую область, пользователей и роли доступа.

cd server
docker compose config --quiet
docker compose up -d --build
docker compose ps

Публикация в сети заказчика

В типовом варианте приложение доступно через reverse proxy по HTTPS, а приложение доступно прокси во внутренней контейнерной сети. Порт Nginx на хосте по умолчанию привязан к loopback. PostgreSQL, серверные службы, ClickHouse и объектное хранилище не публикуются наружу в базовой конфигурации. Внешний доступ к системе, если он требуется, настраивается отдельно в рамках договора и политики безопасности заказчика.

Путь /roy должен передаваться на приложение без удаления префикса. Для прямого экрана, оперативных команд и обновления статусов необходимо разрешить WebSocket upgrade.

Проверка локального контура

Служебные endpoints /roy/api/health/live и /roy/api/health/ready предназначены для локальной проверки контейнера, reverse proxy и внутреннего мониторинга. Их не следует публиковать как внешний публичный API. Проверка выполняется из локальной сети или с самого сервера.

Установка агента

После запуска серверной части администратор создаёт регистрационный ключ в разделе «Установка», скачивает готовый пакет Windows-агента и запускает установку на рабочей станции. Рабочая область определяется сервером по регистрационному ключу; название рабочей области и её UUID не требуется вручную прописывать на клиенте.

Подробная процедура приведена в документе «Установка агента».

Подготовка конфигурации

Пример .env предназначен для локальной проверки. Перед рабочим запуском замените тестовые пароли и ключи, задайте COPKA_ROY_ENV=production, SECRET_KEY и канонический COPKA_ROY_PUBLIC_URL. Проверьте отдельные учётные записи PostgreSQL, CLICKHOUSE_PASSWORD, настройки серверных служб и RUSTFS_SECRET_KEY. Пользователей и рабочие области создавайте через Owner API.

Установка включает PostgreSQL, ClickHouse, серверные службы, RustFS/S3, приложение и worker. Настройте DNS, доверенный TLS-сертификат и синхронизацию времени. Адрес localhost на компьютере агента означает сам этот компьютер, а не сервер.

Первый запуск и существующая база

Для пустой установки штатные зависимости Compose выполняют настройку ролей и db-init до приложения. При ошибке миграции не запускайте web вручную в обход db-init. Существующую базу сначала резервируют и проверяют по инструкции DATABASE_MIGRATIONS_RU.md; принудительный stamp без сверки схемы недопустим. При db-init при включённых DEMO_MODE и CREATE_DEMO_USERS выполняется базовый seed-demo, пересоздавая демо-данные. Расширенный seed-demo-2 запускается только при COPKA_ROY_SEED_DEMO_V2=true. Для отключения обоих наборов задайте COPKA_ROY_CREATE_DEMO_USERS=No или COPKA_ROY_DEMO_MODE=No в .env.

Приёмка установки

1. Проверьте итоговую конфигурацию без публикации секретов: docker compose config --quiet.
2. Убедитесь в успешном завершении инициализации БД и хранилища и готовности web/worker.
3. Войдите под своей административной учётной записью, создайте или выберите рабочую область.
4. Установите один тестовый Windows-агент, проверьте heartbeat, политику, поступление события и доступ к снимку при разрешённой функции.
5. Проверьте, что другой workspace и ограниченная роль не получают лишний доступ.

Выбор мощности и числа экземпляров

Перед развёртыванием выберите профиль из «Системных требований». Бюджет функционального стенда с 1-2 экземплярами приложения отличается от бюджета 1000 агентов. Базовая конфигурация задаёт 12 экземпляров; это значение не является автоматическим подбором под CPU и RAM. Уточните число экземпляров и пулы с учётом ресурсов и последующего испытания. Полезная ёмкость объектного хранилища и резервные копии считаются дополнительно к системному диску и базам данных.

Доступность AI-чата

После входа раздел AI-чат доступен участнику с правом просмотра компьютеров. Готовность внешнего сервиса и квоты подготавливает оператор. При временной недоступности история диалогов сохраняется; установка агента не настраивает AI-сервис.

Подробнее: AI-чат: анализ безопасности.