Конфигурация Orpheus
Настройки процесса передаются через ENV. Само приложение не загружает .env: это делает Compose. Флаги команды serve имеют приоритет для адресов прослушивания.
| Переменная | По умолчанию | Назначение |
|---|---|---|
DATABASE_URL | required | PostgreSQL для API, worker и миграций |
ORPHEUS_CONFIG_FILE | orpheus.toml | Путь к настройкам хранилищ авторизации и сервисов |
ORPHEUS_MIGRATIONS_DIR | migrations | Каталог миграций. Флаг --dir имеет приоритет |
PUBLIC_API_KEYS | [] | JSON-массив Bearer-ключей с одинаковым доступом |
ENV_ENCRYPTION_KEY | required | 32 байта в base64url для шифрования ENV |
HARNESS_ENV_ALLOWLIST | [] | JSON-массив дополнительных разрешённых имён ENV worker. Объединяется с ENV всех сервисов |
AGENTBOX_API_KEY | required on worker | Доступ к AgentBox. Также передайте API для регистрации шаблонов |
AGENTBOX_API_URL | unset | Явный origin API AgentBox. Используйте одинаковые настройки адреса на API и worker |
AGENTBOX_DOMAIN | agentbox-runtime.ru | Домен для https://api.<domain>, если явный API URL не задан |
AGENTBOX_DEBUG | false | Выбирает http://localhost:3000, если явный API URL не задан |
SANDBOX_PROXY_URL | https://sandbox-proxy.agentbox.ru:65181 | Прокси агента: HTTP, HTTPS, SOCKS5 или SOCKS5H. Пустое значение отключает подстановку. Совместимость с авторизацией |
MAX_CONCURRENT_SESSIONS | 50 | Занятые слоты исполнения, включая подготовку и завершение |
DEFAULT_MAX_SESSION_TOKENS | 100000000 | Бюджет токенов новой сессии |
MAX_TOOL_RESULT_BYTES | 524288 | Объём сохраняемого вывода инструмента |
MAX_HOOK_OUTPUT_BYTES | 524288 | Объём сохраняемого stdout/stderr хука |
MAX_REQUEST_BYTES | 1048576 | Предельный размер запроса API в байтах |
DATABASE_PING_TIMEOUT | 2 | Таймаут проверки БД, секунды |
CANCEL_GRACE_SECONDS | 30 | Ожидание мягкой отмены |
WORKER_POLL_SECONDS | 1 | Интервал опроса worker |
SANDBOX_PROVISION_TIMEOUT_SECONDS | 120 | Дедлайн первоначального создания и подключения песочницы, секунды. Применяется к новым попыткам |
SANDBOX_PAUSED_RETENTION_DAYS | 14 | Хранение песочниц на паузе после завершения последнего запуска, целое число 1–100 дней. Настройка worker |
SANDBOX_CLEANUP_BATCH_SIZE | 1000 | Число сессий за проход уборки worker, включая повторы. Положительное целое число |
RPC_TIMEOUT_SECONDS | 30 | Таймаут отдельного RPC агента |
ORPHEUS_HOST / ORPHEUS_PORT | 0.0.0.0 / 8000 | Адрес API |
ORPHEUS_SYSTEM_HOST / ORPHEUS_SYSTEM_PORT | 0.0.0.0 / 9100 | Проверки процесса и сервисные метрики. Доступ только из доверенной сети |
ORPHEUS_BROWSER_AUTH | api_only | api_only, anonymous или saml |
ORPHEUS_PUBLIC_URL | unset | Точный внешний origin для браузерных изменений. HTTPS обязателен для SAML |
SAML_SP_ENTITY_ID | unset | Идентификатор SP |
SAML_IDP_METADATA_FILE | unset | Путь к XML метаданных IdP |
SAML_SP_CERT_FILE | unset | Путь к сертификату SP |
SAML_SP_KEY_FILE | unset | Путь к приватному ключу SP |
BROWSER_SESSION_TTL_SECONDS | 43200 | Время браузерной сессии, 300-86400 секунд |
required означает обязательное значение, unset означает отсутствие значения. SAML-поля обязательны в режиме saml. Передайте значения переменных интеграций, например HELPDESK_TOKEN, worker. Опишите их имена в сервисе, а для имён вне каталога используйте HARNESS_ENV_ALLOWLIST.
API и worker должны использовать одинаковую конфигурацию хранилищ авторизации и сервисов, список разрешённых переменных и ключ шифрования. После изменения ENV пересоздайте контейнеры. Практическая настройка.