Перейти к содержанию

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

Synth настраивается через переменные окружения, config.yaml и runtime-настройки в интерфейсе. Один и тот же инстанс можно запустить локально, в Docker или на сервере — от режима развёртывания зависят только значения по умолчанию.

Актуальность

Документ описывает Synth 0.13.10. Набор полей и переменных может расширяться; если сомневаетесь — сверяйтесь с актуальным config.yaml и разделами настроек в интерфейсе.

Приоритет источников

Значение настройки берётся из первого источника, где оно задано:

CLI-флаги  >  переменные окружения SYNTH_*  >  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

Каскадный поиск файла конфигурации (от высшего приоритета к низшему):

  1. --config или SYNTH_CONFIG;
  2. <home>/config.yaml, если задан --home / SYNTH_HOME;
  3. ./synth.config.yaml в текущем каталоге;
  4. ./config.yaml в текущем каталоге;
  5. ~/.config/synth/config.yaml;
  6. /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) — ошибка конфигурации: сервис не стартует, тихого отката к файлам нет.

storage:
  backend: "file"            # file | memory | postgres
  dataDir: "/var/synth/data"

Параметры 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-настроек у слоя нет. Политика читается снимком при старте, поэтому изменения в поставке полномочий видны только после перезапуска. Раздел «Полномочия» в интерфейсе — только для чтения.

authority:
  enabled: true
  shadow: true      # сначала «только журнал», затем принуждение

Подробнее — Полномочия.

Фоновая работа (background)

Фоновые саб-агенты и шелл-процессы: реестр во вкладке «Процессы» правой панели, лимиты на сессию и срок хранения записей.

Поле Назначение По умолчанию
enabled Мастер-выключатель фоновой работы true
maxSubagentsPerSession Одновременно идущих фоновых саб-агентов на сессию 2
maxProcessesPerSession Одновременно идущих фоновых процессов на сессию 5
maxRunsPerSession Записей реестра на сессию 10
logMaxBytes Предел размера лога процесса, байт (0 — без предела) 10 МиБ
retentionDays Срок хранения завершённых записей, дни 7

Превышение лимита — отказ с понятной причиной. Идущий прогон можно перевести в фон, но вернуть его в обычный ход уже нельзя.

background:
  enabled: true
  maxSubagentsPerSession: 2
  maxProcessesPerSession: 5
  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. Подробнее — в разделе Гибридный режим.

Что дальше