Конфигурация¶
Synth настраивается через переменные окружения, config.yaml и runtime-настройки
в интерфейсе. Один и тот же инстанс можно запустить локально, в Docker или на
сервере — от режима развёртывания зависят только значения по умолчанию.
Актуальность
Документ описывает Synth 0.13.10. Набор полей и переменных может
расширяться; если сомневаетесь — сверяйтесь с актуальным config.yaml
и разделами настроек в интерфейсе.
Приоритет источников¶
Значение настройки берётся из первого источника, где оно задано:
- CLI-флаги — высший приоритет:
--port,--api-key,--data-dir,--home. - Переменные окружения
SYNTH_*читаются поверх конфигурационного файла. config.yamlнаходится каскадным поиском и объединяется со значениями по умолчанию (они зависят от режима:user,dev,docker,server).
Переменные окружения¶
| Переменная | Назначение | По умолчанию |
|---|---|---|
SYNTH_API_KEY |
Ключ доступа к API (на backend даёт роль ADMIN). Если не задан, synth serve генерирует ключ в {dataDir}/secrets/api-key |
— |
SYNTH_DATA_DIR |
Каталог данных: сессии, проекты, провайдеры, модели | по режиму: ~/.local/share/synth, ./data, /var/synth/data |
SYNTH_WORKSPACES_ROOT |
Корень каталогов workspace проектов | {dataDir}/workspaces |
SYNTH_DEFAULT_WORKSPACE |
Рабочий каталог по умолчанию | {dataDir}/workspaces/default |
SYNTH_WORKSPACE_OUTSIDE_ROOT |
Политика workspace вне корня: confirm или deny |
по режиму: standalone — confirm, managed — deny |
SYNTH_CONFIG |
Путь к config.yaml (приоритетнее каскадного поиска) |
каскадный поиск |
SYNTH_HOME |
Базовый home-каталог локального инстанса | — |
SYNTH_HOST |
Адрес прослушивания HTTP-серверов | 0.0.0.0 (backend), 127.0.0.1 (serve) |
SYNTH_PORT |
Порт backend | 5000 |
SYNTH_CORE_PORT |
Порт core и synth serve |
4300 |
SYNTH_RUNNER_PORT |
Порт раннера | 5200 |
SYNTH_AUTH_DEBUG |
Режим отладки аутентификации с тестовыми пользователями | false |
SYNTH_DEFAULT_LANGUAGE |
Язык интерфейса backend (ru / en) |
ru |
SYNTH_DEPLOY_MODE |
Режим развёртывания: user, docker, server, dev |
автодетект |
SYNTH_LOG_DIR |
Каталог логов сервисов | существующий каталог логов |
SYNTH_BACKEND_URL |
URL backend для раннера | http://localhost:5000 |
| Переменная | Назначение | По умолчанию |
|---|---|---|
VITE_BACKEND_URL |
URL backend (прокси Vite) | http://localhost:5000 |
VITE_PORT |
Порт dev-сервера Vite | 5002 |
VITE_ALLOWED_HOSTS |
Разрешённые хосты (true — все) |
true |
| Переменная | Назначение |
|---|---|
SYNTH_PROVIDER_<NAME>_URL |
URL провайдера |
SYNTH_PROVIDER_<NAME>_API_KEY |
API-ключ провайдера |
SYNTH_PROVIDER_<NAME>_MODEL |
Модель по умолчанию |
SYNTH_PROVIDER_<NAME>_TYPE |
Тип: openai, anthropic, ollama |
<NAME> — имя провайдера в верхнем регистре. Ключи провайдеров храните в
секретах и передавайте через окружение, а не в репозитории.
config.yaml¶
Каскадный поиск файла конфигурации (от высшего приоритета к низшему):
--configилиSYNTH_CONFIG;<home>/config.yaml, если задан--home/SYNTH_HOME;./synth.config.yamlв текущем каталоге;./config.yamlв текущем каталоге;~/.config/synth/config.yaml;/etc/synth/config.yaml.
Найденный файл объединяется со значениями по умолчанию, затем применяются CLI-переопределения. Ключевые секции с типовыми значениями:
server:
host: "0.0.0.0"
port: 5000
corsOrigin: "http://localhost:5002"
storage:
dataDir: "/var/synth/data" # каталог данных вне репозитория
backend: "file" # file | memory | postgres
degradedMode: "fallback-file" # fallback-file | halt
postgres: {} # dsn/host/port/database/user/schema/sslmode/poolMax
workspacesRoot: "" # пусто → {dataDir}/workspaces
defaultWorkspace: "" # пусто → {dataDir}/workspaces/default
workspaceOutsideRoot: "" # confirm | deny; пусто → по режиму
execution: # топология исполнения команд агента
mode: "inline" # inline (в процессе) | remote (исполнители)
remote:
url: [] # адреса исполнителей; пусто при remote → отказ старта
timeoutMs: 30000
concurrency: 0 # 0 → число ядер CPU
failMode: "fail" # fail | inline-fallback
tokenSecret: "" # путь к файлу токена, не значение
attachments: # вложения сообщений
enabled: true
maxBytesPerFile: 26214400 # 25 МиБ
maxFilesPerMessage: 10
maxBytesPerSession: 1073741824 # 1 ГиБ
maxBytesPerMessage: 20971520 # 20 МиБ — бюджет вложений инструментов на ход
gcDays: 30 # 0 — не удалять осиротевшие объекты
modalityModels: {} # вспомогательные модели по семействам
authority: # слой полномочий
enabled: false
shadow: true # true — только журнал, false — принуждение
background: # фоновые саб-агенты и процессы
enabled: true
maxSubagentsPerSession: 2
maxProcessesPerSession: 5
maxRunsPerSession: 10
retentionDays: 7
auth:
debugMode: false # тестовые пользователи, только для разработки
sessionMaxAgeMinutes: 1440
# oidc: { enabled: false, issuer: "", clientId: "", clientSecret: "", redirectUri: "" }
llm:
defaultProvider: "" # назначается администратором
defaultModel: ""
maxRetries: 3
timeout: 60
core:
port: 4300
apiKey: "" # пусто → synth serve генерирует ключ в {dataDir}/secrets/api-key
tools:
policy: "auto" # consistency | available | auto (встроенные инструменты)
mcp:
policy: "auto" # consistency | available | auto (MCP-инструменты)
permission:
rules: {} # allow/deny/ask для инструментов
askTimeoutMs: 30000
security:
protectedPaths:
enabled: true
secretKey: "" # пусто → файл {dataDir}/secrets/master.key
events: # внешние события: приём и маршрутизация
enabled: true # мастер-выключатель приёма событий
defaultMode: bound # bound | ephemeral
ephemeralTtl: "24h" # время жизни временной сессии
journalRetentionDays: 30 # срок хранения журнала решений
allowedSources: [] # пусто → все источники
unknownAgentTemplate: drop # drop | default-agent
keyRateLimitPerMinute: 0 # 0 → без лимита для ключей привязок
decisionRouting: false
autoBind: false
autoBindAgentTemplate: ""
webhooks: # исходящие webhooks (выключено по умолчанию)
enabled: false
maxAttempts: 5
timeoutMs: 10000
allowPrivateTargets: false # false → только https и публичные адреса
deliveryRetentionDays: 30
scheduler: # расписания (cron)
enabled: true
tickSec: 60
catchUp: skip # skip | once
jobRetentionDays: 30
decision: # decision-модели
enabled: false # мастер-выключатель decision-слоя
provider: "" # имя decision-провайдера
model: "" # модель (например, компактная decision-модель)
confidenceThreshold: 0.6 # ниже порога — fallback/эскалация
escalationProvider: "" # пусто → без эскалации
escalationModel: ""
remote: # гибридный режим: локальный core + удалённый backend
enabled: false
backendUrl: ""
auth:
type: device # device | api_key
apiKey: ""
issuer: ""
clientId: "synth"
llm: "server" # server | local
worlds: { local: true, remote: true }
timeoutMs: 15000
updates: # каналы и проверка обновлений
check: false # автопроверка в фоне выключена по умолчанию
channel: "auto" # auto | stable | beta
intervalHours: 24 # TTL успешной проверки, часов
stableRegistry: "https://registry.npmjs.org"
betaRegistry: "https://git.itphx.ru/api/packages/itphx/npm/"
Храните config.yaml с правами 600 и не коммитьте в репозиторий.
Хранилище (storage)¶
Состояние инстанса — сессии, проекты, настройки, провайдеры, скиллы — лежит в одном из трёх хранилищ. Тип выбирается при запуске и меняется только переносом данных, а не настройкой в интерфейсе.
Файловое, в памяти и PostgreSQL¶
| Поле | Назначение | По умолчанию |
|---|---|---|
storage.backend |
Тип хранилища: file, memory или postgres |
file |
storage.dataDir |
Корень данных: сессии, проекты, провайдеры, модели, агенты, секреты | каталог по режиму развёртывания |
| Значение | Что это | Когда подходит |
|---|---|---|
file |
JSON-файлы в каталоге данных, запись атомарная | один инстанс, локальная работа, небольшой стенд |
memory |
Данные только в памяти процесса | тесты и демонстрации: после перезапуска всё теряется |
postgres |
Состояние в PostgreSQL | несколько реплик сервера на общей базе |
Env — SYNTH_STORAGE_BACKEND. Неизвестное значение (например, опечатка
postgress) — ошибка конфигурации: сервис не стартует, тихого отката к файлам
нет.
Параметры PostgreSQL¶
Секция используется только при storage.backend: postgres.
| Поле | Env | Назначение |
|---|---|---|
dsn |
SYNTH_POSTGRES_DSN |
Строка подключения; если задана — приоритетнее остальных полей |
host |
SYNTH_POSTGRES_HOST |
Хост сервера БД |
port |
SYNTH_POSTGRES_PORT |
Порт |
database |
SYNTH_POSTGRES_DATABASE |
Имя базы |
user |
SYNTH_POSTGRES_USER |
Пользователь |
schema |
SYNTH_POSTGRES_SCHEMA |
Схема БД для таблиц Synth |
sslmode |
SYNTH_POSTGRES_SSLMODE |
Режим TLS: disable, require, verify-full |
ssl |
SYNTH_POSTGRES_SSL |
Устаревший флаг TLS; применяется, только если sslmode не задан |
poolMax |
SYNTH_POSTGRES_POOL_MAX |
Размер пула соединений |
Пароль в конфиге не хранится: только переменная SYNTH_POSTGRES_PASSWORD
или файл {dataDir}/secrets/postgres-password. В Kubernetes удобнее Secret,
передаваемый в окружение. Если используете dsn, не включайте пароль в строку
подключения — оставьте его в переменной или файле.
TLS настраивается в двух местах: режим соединения — sslmode, сертификаты и
доверенные центры — общий раздел доверия TLS (security.tls). Параметры TLS
в строке подключения (sslmode=, sslrootcert=, sslcert=, sslkey=)
запрещены: сервис откажется стартовать, чтобы политика доверия не была
задана дважды.
storage:
backend: "postgres"
postgres:
host: "postgres.internal"
port: 5432
database: "synth"
user: "synth"
schema: "public"
sslmode: "verify-full" # disable | require | verify-full
poolMax: 10
Что остаётся на диске¶
В базе живут структурированные данные, а бинарные объекты — всегда файлы: вложения сообщений, артефакты прогонов пайплайнов, содержимое скиллов, логи фоновых процессов. В базе хранятся только ссылки на них, а учёт ссылок не даёт удалить объект, который ещё используется.
- Каталог объектов —
{dataDir}/blobs. При нескольких репликах он должен лежать на общем томе с доступом на чтение и запись (ReadWriteMany). - Осиротевшие вложения удаляются сборщиком мусора по сроку
attachments.gcDays(по умолчанию 30 дней). synth backupснимает каталог данных, но не базу. Полный бэкап — дамп базы плюс архив тома с бинарными объектами.
Деградированный режим¶
Если база недоступна, поведение задаёт storage.degradedMode:
| Значение | Что происходит |
|---|---|
fallback-file (по умолчанию) |
Инстанс поднимается на каталоге storage.fallbackDir строго на чтение |
halt |
Старт останавливается с понятной ошибкой |
В деградированном режиме чтение и диагностика работают, изменения отвечают
отказом, а доступ есть только у администратора; /health показывает
degraded. Автоматического возврата к базе нет — только перезапуск после
восстановления соединения. Данные фоллбека в базу вручную не копируются: после
перезапуска инстанс вернётся к базе, и ручная копия создаст расхождение.
Для PostgreSQL рекомендуется halt: стенд с базой обычно возвращается
перезапуском, а «тихий» файловый режим только запутает.
Env — SYNTH_DEGRADED_MODE и SYNTH_STORAGE_FALLBACK_DIR.
Перенос и миграции¶
| Команда | Что делает |
|---|---|
synth migrate |
Применяет и выравнивает схему БД; повторный прогон ничего не меняет |
synth storage migrate --to postgres |
Переносит данные файлового инстанса в базу |
synth storage migrate --to file --target-data-dir <путь> |
Переносит данные из базы в файловый каталог |
synth doctor |
Проверяет соединение с базой и версию схемы |
Порядок переноса: резервная копия (дамп базы и архив тома с бинарными
объектами), затем перенос, затем проверка synth doctor на новом хранилище.
Если схема в базе новее, чем понимает установленная версия Synth, сервис
откажется стартовать — сначала обновите Synth.
Рабочий каталог¶
storage.dataDir— корень данных: сессии, проекты, провайдеры, модели, агенты, контекст, секреты. Пусто — каталог по умолчанию для режима развёртывания.storage.workspacesRoot— корень каталогов проектов. Managed-проекты создают workspace внутри него (автоимя из названия проекта с суффиксом), абсолютный путь внутри корня нормализуется в относительный.storage.defaultWorkspace— рабочий каталог сессий без проекта. Меняется без перезапуска:PUT /api/v2/settings/workspace.storage.workspaceOutsideRoot— что делать с абсолютным workspace внеworkspacesRoot:confirm— запросить подтверждение,deny— запретить. В managed-режиме политика жёсткоdenyи доступна только для чтения.
Секреты at-rest¶
Мастер-ключ security.secretKey шифрует секреты в хранилище (например,
SSH-ключи агентов) алгоритмом AES-256-GCM.
- Приоритет: переменная
SYNTH_SECRET_KEY→security.secretKeyв конфиге → файл{dataDir}/secrets/master.key. - Формат: base64 ровно на 32 байта либо 64 hex-символа. Иначе сервис сообщает об ошибке и не обрезает ключ молча.
- Fallback-файл: если ключ не задан, core создаёт
{dataDir}/secrets/master.keyпри первом запуске (каталог0700, файл0600). - Ротация:
synth secrets rotate(--data-dir,--old-key,--new-key,--dry-run,--yes) перешифровывает существующие секреты. Без--yesи без--dry-runкоманда отказывается работать. Если эффективный ключ задан через окружение или конфиг, обновите его и там — файл при старте игнорируется. Перед ротацией сделайте бэкап данных и остановите сервис.
Исполнение команд (execution)¶
Где выполняются команды агента: в процессе сервера (inline) или в отдельных
контейнерах-исполнителях (remote). Это параметр запуска — смена режима
требует перезапуска, настройки в интерфейсе для него нет.
| Поле | Env | Назначение | По умолчанию |
|---|---|---|---|
execution.mode |
SYNTH_EXECUTION_MODE |
inline — команды в процессе сервера; remote — в исполнителях |
inline |
execution.remote.url |
SYNTH_EXECUTION_REMOTE_URL |
Адреса исполнителей через запятую | [] |
execution.remote.timeoutMs |
SYNTH_EXECUTION_TIMEOUT_MS |
Таймаут одного вызова | 30000 |
execution.remote.concurrency |
SYNTH_EXECUTION_CONCURRENCY |
Лимит одновременных вызовов на сервере | число ядер CPU |
execution.remote.failMode |
SYNTH_EXECUTION_FAIL_MODE |
fail — отказ при недоступном исполнителе; inline-fallback — выполнить на сервере |
fail |
execution.remote.tokenSecret |
SYNTH_EXECUTION_TOKEN |
Путь к файлу с токеном доверия, не значение | — |
При remote сервер не стартует, если не заданы адреса исполнителей, не
установлен пакет исполнителя или не читается файл токена. Токен в конфиге и в
переменных окружения не хранится: указывается только путь, а значение лежит в
файле или в Secret.
inline-fallback — осознанный обход изоляции: при недоступном исполнителе
команда выполнится в процессе сервера. В управляемом контуре его не включают.
execution:
mode: "remote"
remote:
url: ["http://synth-executor:5100"]
timeoutMs: 30000
concurrency: 4
failMode: "fail" # inline-fallback — только явно
tokenSecret: "/etc/synth/executor/token"
Профили и пулы¶
Одного адреса исполнителя достаточно для простой установки, но для командной работы нужны несколько окружений: обычное, лёгкое для чтения, с браузером или с GPU. Они описываются профилями: имя, адрес, таймаут, параллельность, режим отказа, образ, сетевой класс, ресурсы. Профиль сессии выбирается по цепочке «сессия → агент → проект → профиль по умолчанию», а ограничения проекта и агента задают потолок допустимых профилей.
Пул решает, кто делит окружение: instance — один общий пул на инстанс,
project и session — отдельный пул на проект или сессию. Браузерный пул
всегда проектный, поэтому cookies не перетекают между проектами.
Новые поля секции (без отдельной таблицы):
pooling— область пула:instance,projectилиsession(SYNTH_EXECUTION_POOLING);profiles— каталог профилей: имя → параметры вызова и метаданные (image,network,resources,mcpServersи размещение); в конфигурационном файле задаёт профили поставки;defaultProfile— профиль по умолчанию, точка отката инстанса (SYNTH_EXECUTION_DEFAULT_PROFILE);fallback— что делать, если профиль непригоден:instance(общий пул) илиfail(не стартовать);browserProfiles— отдельный каталог профилей браузера; браузерные имена не попадают в каталог профилей команд;networkиresources— у профиля: сетевой класс (none,restricted,full) и запросы/пределы ресурсов, включая GPU.
Каталог профилей дополнительно правится в разделе Настройки → Исполнение:
профили из поставки можно отключить, свои — добавить или переопределить.
Секция execution — параметр запуска, поэтому изменения каталога и режима
пулов применяются после перезапуска; интерфейс показывает, что сохранено и
что работает сейчас.
Подробнее — Исполнение: профили и пулы.
Как это выглядит в контейнерах — в разделах Docker и Kubernetes / Helm.
Вложения (attachments)¶
Изображения, PDF, аудио и видео в сообщении: что разрешено, сколько весит и как долго хранится. Вложения включены по умолчанию.
| Поле | Назначение | По умолчанию |
|---|---|---|
enabled |
Мастер-выключатель вложений | true |
modalities |
Разрешённые семейства: image, pdf, audio, video |
все включены |
maxBytesPerFile |
Размер одного файла, байт | 25 МиБ |
maxFilesPerMessage |
Файлов в одном сообщении | 10 |
maxBytesPerSession |
Суммарный объём вложений сессии, байт | 1 ГиБ |
maxBytesPerMessage |
Бюджет вложений инструментов на ход, байт | 20 МиБ |
allowedMimePrefixes |
Белый список типов | image/, audio/, video/, application/pdf, text/ |
workspaceFallback |
Сохранять недоставленные вложения в рабочий каталог | true |
gcDays |
Срок хранения осиротевших вложений, дни (0 — не удалять) |
30 |
modalityModels |
Вспомогательная модель на семейство: {provider, model} |
{} |
attachments:
enabled: true
maxBytesPerFile: 26214400 # 25 МиБ
maxFilesPerMessage: 10
maxBytesPerSession: 1073741824 # 1 ГиБ
maxBytesPerMessage: 20971520 # 20 МиБ — только конфиг
gcDays: 30
modalityModels: {} # вспомогательные модели по семействам
Большая часть значений меняется в интерфейсе без перезапуска — в разделе
«Мультимодальный ввод». Исключение — maxBytesPerMessage: бюджет вложений
инструментов задаётся только в конфиге. Поле, значение которого задано через
env, в интерфейсе заблокировано.
Подробнее — Вложения и мультимодальность.
Внешние события, расписания и decision-модели¶
События (events)¶
Приём внешних событий и их маршрутизация. Часть полей переопределяется в runtime
через GET/PUT/DELETE /api/v2/settings/events (без перезапуска).
| Поле | Назначение | По умолчанию |
|---|---|---|
enabled |
Мастер-выключатель приёма событий (false → POST /api/v2/events отвечает 503) |
true |
defaultMode |
Поведение события без маршрута: bound (отбросить) или ephemeral (временная сессия) |
bound |
ephemeralTtl |
Время жизни временной сессии (30s/15m/24h/7d) |
24h |
journalRetentionDays |
Срок хранения журнала решений | 30 |
allowedSources |
Разрешённые источники (пусто — все) | [] |
unknownAgentTemplate |
Неизвестный шаблон агента: drop или default-agent |
drop |
keyRateLimitPerMinute |
Лимит запросов для ключей привязок (0 — без лимита) | 0 |
decisionRouting |
Подключать decision-маршрутизацию событий | false |
autoBind / autoBindAgentTemplate |
Авто-привязка чата/треда и агент для неё | false / "" |
identityMap |
Ручное сопоставление внешних идентификаторов с пользователями | {} |
Подробнее — События и автоматизация.
Исходящие webhooks (webhooks)¶
Подписки на события Synth и HTTP-доставка подписчикам. По умолчанию выключены:
пока enabled не включён, создание подписок и тестовая доставка отвечают 503.
| Поле | Назначение | По умолчанию |
|---|---|---|
enabled |
Мастер-выключатель доставки | false |
maxAttempts |
Число попыток доставки (1–10, backoff с джиттером) | 5 |
timeoutMs |
Таймаут одного HTTP-запроса | 10000 |
allowPrivateTargets |
Разрешить http и приватные адреса (только для разработки) |
false |
deliveryRetentionDays |
Срок хранения журнала доставок | 30 |
Подробнее — Публичный API и интеграции.
Планировщик расписаний (scheduler)¶
Cron/interval-планировщик, публикующий события source: cron.
| Поле | Назначение | По умолчанию |
|---|---|---|
enabled |
Мастер-выключатель сервиса (при false тикер не стартует, CRUD и ручной запуск доступны) |
true |
tickSec |
Период тика, секунды | 60 |
catchUp |
Пропущенное срабатывание: skip или once |
skip |
jobRetentionDays |
Срок хранения истории заданий | 30 |
Подробнее — Расписания.
Decision-модели (decision)¶
Компактная decision-модель для микро-классификации, быстрых ответов и
маршрутизации. Переопределяется в runtime через
GET/PUT/DELETE /api/v2/settings/decision (без перезапуска).
| Поле | Назначение | По умолчанию |
|---|---|---|
enabled |
Мастер-выключатель decision-слоя | false |
provider |
Имя decision-провайдера | "" |
model |
Модель decision-слоя | "" |
confidenceThreshold |
Порог уверенности: ниже — fallback/эскалация | 0.6 |
escalationProvider / escalationModel |
Вторая пара «провайдер/модель»: тир эскалации primary → escalation (пусто — без эскалации) |
"" |
Подробнее — Маршрутизация.
Полномочия (authority)¶
Слой полномочий поверх прав инструментов: право — это грант «действие × цель» с эффектом «Разрешить», «Спросить» или «Запретить». Слой только сужает решения прав; расширить их он не может.
| Поле | Env | Назначение | По умолчанию |
|---|---|---|---|
authority.enabled |
SYNTH_AUTHORITY_ENABLED |
Включить слой полномочий | false |
authority.shadow |
SYNTH_AUTHORITY_SHADOW |
true — решение считается и пишется в журнал, но не применяется; false — принуждение |
true |
Настраивается только конфигом: runtime-настроек у слоя нет. Политика читается снимком при старте, поэтому изменения в поставке полномочий видны только после перезапуска. Раздел «Полномочия» в интерфейсе — только для чтения.
Подробнее — Полномочия.
Фоновая работа (background)¶
Фоновые саб-агенты и шелл-процессы: реестр во вкладке «Процессы» правой панели, лимиты на сессию и срок хранения записей.
| Поле | Назначение | По умолчанию |
|---|---|---|
enabled |
Мастер-выключатель фоновой работы | true |
maxSubagentsPerSession |
Одновременно идущих фоновых саб-агентов на сессию | 2 |
maxProcessesPerSession |
Одновременно идущих фоновых процессов на сессию | 5 |
maxRunsPerSession |
Записей реестра на сессию | 10 |
logMaxBytes |
Предел размера лога процесса, байт (0 — без предела) |
10 МиБ |
retentionDays |
Срок хранения завершённых записей, дни | 7 |
Превышение лимита — отказ с понятной причиной. Идущий прогон можно перевести в фон, но вернуть его в обычный ход уже нельзя.
Подробнее — Фоновая работа.
Обновления (updates)¶
Секция updates управляет тем, как инстанс узнаёт о новых версиях: канал
обновлений, автоматическую проверку и реестры пакетов.
| Поле | Env | Назначение | По умолчанию |
|---|---|---|---|
check |
SYNTH_UPDATES_CHECK |
Автоматическая проверка обновлений в фоне | false |
channel |
SYNTH_UPDATES_CHANNEL |
Канал: auto, stable или beta |
auto |
intervalHours |
SYNTH_UPDATES_INTERVAL_HOURS |
Срок кэша успешной проверки, часов (ошибка кэшируется на 1 час) | 24 |
stableRegistry |
SYNTH_UPDATES_STABLE_REGISTRY |
Реестр стабильного канала | https://registry.npmjs.org |
betaRegistry |
SYNTH_UPDATES_BETA_REGISTRY |
Реестр бета-канала | https://git.itphx.ru/api/packages/itphx/npm/ |
updates:
check: false # автопроверка выключена по умолчанию
channel: "auto" # auto | stable | beta
intervalHours: 24
stableRegistry: "https://registry.npmjs.org"
betaRegistry: "https://git.itphx.ru/api/packages/itphx/npm/"
- Приоритет: переменные окружения
SYNTH_UPDATES_*→ runtime-настройки из интерфейса (Настройки → Панель управления → Обновления) →config.yaml→ значения по умолчанию. Если канал зафиксирован переменной окружения, интерфейс его не перекрывает. - Автопроверка по умолчанию выключена — инстанс не ходит в реестры без
явного согласия владельца. Это важно для закрытого контура и офлайн-поставки.
Явная проверка (
synth update --check) от этого флага не зависит и всегда игнорирует кэш. - Канал
autoвыводится из установленной версии: сборка с пометкой-beta.остаётся на бета-канале, обычная — на стабильном. Явное значениеstableилиbetaпереопределяет это. - Реестры. Бета-реестр читается без токена (токен нужен только для публикации). Свой реестр — для установки за прокси или в закрытом контуре.
Разделы настроек в интерфейсе: Настройки → Панель управления → Обновления. Подробнее — Обслуживание.
Гибридный режим (remote)¶
Секция remote включает подключение локального core к удалённому серверу:
интерфейс объединяет локальные и удалённые проекты, а LLM-запросы можно
централизовать на сервере.
| Поле | Назначение | По умолчанию |
|---|---|---|
enabled |
Включить гибридный режим | false |
backendUrl |
Базовый URL удалённого backend | "" |
auth.type |
Способ входа: device (OIDC device flow) или api_key |
device |
auth.apiKey |
API-ключ для auth.type: api_key |
"" |
auth.issuer |
OIDC issuer (realm Keycloak) для device flow | "" |
auth.clientId |
OIDC client_id (public client) для device flow |
"" |
llm |
Куда идут LLM-запросы: server или local |
server |
worlds |
Какие миры доступны: { local, remote } |
оба включены |
credentialsPath |
Файл credentials; пусто → ~/.config/synth/credentials.json |
"" |
timeoutMs |
Таймаут запросов к удалённому backend | 15000 |
Отдельных переменных SYNTH_REMOTE_* нет — секция задаётся в config.yaml
или CLI-флагами: synth serve --connect <url>, synth connect|disconnect,
synth project publish|fork. Подробнее — в разделе
Гибридный режим.
Что дальше¶
- Аутентификация и роли
- SSO / Keycloak
- Безопасность
- Публичный API и интеграции
- Плагины
- Полномочия — кто что может через агента.
- Исполнение: профили и пулы — где выполняются команды и как это изолировано.
- Внешние доступы — OAuth-коннекторы.
- События и автоматизация
- Вложения и мультимодальность
- Фоновая работа
- Обслуживание — сервис, обновления и перезапуск инстанса.
- Docker / Compose
- Kubernetes / Helm