К содержимому

Конфигурация Orpheus ​

Настройки процесса передаются через ENV. Само приложение не загружает .env: это делает Compose. Флаги команды serve имеют приоритет для адресов прослушивания.

ПеременнаяПо умолчаниюНазначение
DATABASE_URLrequiredPostgreSQL для API, worker и миграций
ORPHEUS_CONFIG_FILEorpheus.tomlПуть к настройкам хранилищ авторизации и сервисов
ORPHEUS_MIGRATIONS_DIRmigrationsКаталог миграций. Флаг --dir имеет приоритет
PUBLIC_API_KEYS[]JSON-массив Bearer-ключей с одинаковым доступом
ENV_ENCRYPTION_KEYrequired32 байта в base64url для шифрования ENV
HARNESS_ENV_ALLOWLIST[]JSON-массив дополнительных разрешённых имён ENV worker. Объединяется с ENV всех сервисов
AGENTBOX_API_KEYrequired on workerДоступ к AgentBox. Также передайте API для регистрации шаблонов
AGENTBOX_API_URLunsetЯвный origin API AgentBox. Используйте одинаковые настройки адреса на API и worker
AGENTBOX_DOMAINagentbox-runtime.ruДомен для https://api.<domain>, если явный API URL не задан
AGENTBOX_DEBUGfalseВыбирает http://localhost:3000, если явный API URL не задан
SANDBOX_PROXY_URLhttps://sandbox-proxy.agentbox.ru:65181Прокси агента: HTTP, HTTPS, SOCKS5 или SOCKS5H. Пустое значение отключает подстановку. Совместимость с авторизацией
MAX_CONCURRENT_SESSIONS50Занятые слоты исполнения, включая подготовку и завершение
DEFAULT_MAX_SESSION_TOKENS100000000Бюджет токенов новой сессии
MAX_TOOL_RESULT_BYTES524288Объём сохраняемого вывода инструмента
MAX_HOOK_OUTPUT_BYTES524288Объём сохраняемого stdout/stderr хука
MAX_REQUEST_BYTES1048576Предельный размер запроса API в байтах
DATABASE_PING_TIMEOUT2Таймаут проверки БД, секунды
CANCEL_GRACE_SECONDS30Ожидание мягкой отмены
WORKER_POLL_SECONDS1Интервал опроса worker
SANDBOX_PROVISION_TIMEOUT_SECONDS120Дедлайн первоначального создания и подключения песочницы, секунды. Применяется к новым попыткам
SANDBOX_PAUSED_RETENTION_DAYS14Хранение песочниц на паузе после завершения последнего запуска, целое число 1–100 дней. Настройка worker
SANDBOX_CLEANUP_BATCH_SIZE1000Число сессий за проход уборки worker, включая повторы. Положительное целое число
RPC_TIMEOUT_SECONDS30Таймаут отдельного RPC агента
ORPHEUS_HOST / ORPHEUS_PORT0.0.0.0 / 8000Адрес API
ORPHEUS_SYSTEM_HOST / ORPHEUS_SYSTEM_PORT0.0.0.0 / 9100Проверки процесса и сервисные метрики. Доступ только из доверенной сети
ORPHEUS_BROWSER_AUTHapi_onlyapi_only, anonymous или saml
ORPHEUS_PUBLIC_URLunsetТочный внешний origin для браузерных изменений. HTTPS обязателен для SAML
SAML_SP_ENTITY_IDunsetИдентификатор SP
SAML_IDP_METADATA_FILEunsetПуть к XML метаданных IdP
SAML_SP_CERT_FILEunsetПуть к сертификату SP
SAML_SP_KEY_FILEunsetПуть к приватному ключу SP
BROWSER_SESSION_TTL_SECONDS43200Время браузерной сессии, 300-86400 секунд

required означает обязательное значение, unset означает отсутствие значения. SAML-поля обязательны в режиме saml. Передайте значения переменных интеграций, например HELPDESK_TOKEN, worker. Опишите их имена в сервисе, а для имён вне каталога используйте HARNESS_ENV_ALLOWLIST.

API и worker должны использовать одинаковую конфигурацию хранилищ авторизации и сервисов, список разрешённых переменных и ключ шифрования. После изменения ENV пересоздайте контейнеры. Практическая настройка.