Часовой пояс, в котором работают все контейнеры (логирование, планировщики и т.п.). Пример: Asia/Novosibirsk.

Путь к файлу локального времени хоста, монтируемому в контейнеры для синхронизации системного времени (/etc/localtime).

Внешний адрес/домен, по которому UI/Keycloak доступны пользователям (используется в webbackend для формирования ссылок авторизации).

Каталог для хранения логов сервисов внутри томов (в Nginx/UI — каталог логов веб-интерфейса). В compose жёстко задан как /app/logs или /app/log.

Каталог для хранения временных/кеш‑файлов аудио (PCM/WAV). В Nginx используется RECORD_DIR=/app/records, данные складываются в volume clerk-pcm-data.

Внутреннее имя хоста сервиса Clerk в Docker‑сети (в Nginx — clerk).

Порт HTTP‑API сервиса Clerk (REST‑эндпоинты распознавания и управления). Пробрасывается наружу как ${CLERK_PORT}:${CLERK_PORT}.

Порт HTTP/WebSocket‑backend’а UI (webbackend), через который Nginx проксирует запросы статуса и WebSocket.

Порт, на котором webbackend принимает WebSocket‑подключения (устанавливается из WEBBACKEND_PORT).

Имя контейнера Nginx, используемого как фронтенд/UI‑прокси для ASR. В webbackend проброшено как NGINX_CONTAINER_NAME=nginx.

Внешний порт для веб‑интерфейса (порт хоста, на котором доступен Nginx/UI, по умолчанию прокидывается в контейнер на 80).

URL внешнего сервиса телефонного справочника (AddressBook), используемого Clerk для поиска контактов (GraphQL API).

URL внешнего источника телефонной книги в формате vCard (файл .vcf), который Clerk может использовать как источник контактов.

Источники телефонной книги для Clerk (например, VCF, может быть комбинированный список).

Внутреннее имя хоста сервиса ASR‑сервера в Docker‑сети (asr-server).

Порт HTTP/WebSocket‑интерфейса ASR‑сервера (эндпоинты prepare_pb, compile, ws/asr_vad и др.).

Таймаут ожидания ответа от ASR‑сервиса при распознавании (например, 12s). Используется в Clerk и в коде API (context.WithTimeout).

Адрес/интерфейс на котором Vosk‑сервер слушает входящие WebSocket‑подключения (для asr-server).

Порт, на котором Vosk‑сервер принимает WebSocket‑подключения от asr-server.

Частота дискретизации аудио используемая Vosk‑сервером (Гц).

Каталог буфера Vosk: сюда выкладывается скомпилированный граф модели для последующей загрузки Vosk, а также временные файлы.

Имя хоста Vosk‑сервера в Docker‑сети к которому подключается asr-server (vosk-server).

Минимальная длительность тишины (мс) для фиксации конца речи в VAD. Рекомендуется не менять, если всё работает; при «обрыве» фраз можно увеличить на 200–300 мс.

Дополнительная «припадка» (мс) вокруг сегмента речи для более естественной обрезки. При обрезании первых/последних букв можно увеличить на 50–100 мс.

Порог чувствительности VAD (0–1), определяющий, что считать речью. При наличии речи без распознавания — уменьшить на 0.05–0.1; при распознавании шумов — увеличить на 0.1–0.2.

Частота дискретизации используемая внутри алгоритма VAD (Гц).

Целевой уровень громкости (dBFS) для нормализации сегментов перед отправкой в Vosk. При слишком тихой речи/плохих распознаваниях — увеличить на 5–10; при перегрузах — уменьшить на 5–10.

Имя хоста MongoDB в Docker‑сети (mongo).

Порт MongoDB внутри Docker‑сети (по умолчанию 27017).

Имя базы данных MongoDB используемой для хранения истории и статистики (например history-db).

Имя администратора MongoDB создаваемого при инициализации контейнера.

Путь внутри контейнера к файлу с паролем администратора MongoDB (используется секрет /run/secrets/mongo_root_password).

Пользователь MongoDB, под которым Clerk подключается к базе (берётся из MONGO_INITDB_ROOT_USERNAME).

Пароль MongoDB, под которым Clerk подключается к базе (читается из секрета mongo_root_password).

Версия (тег) Docker‑образа MongoDB (в compose использован образ 4.4.22, фактически зашит в image).

Тип авторизации в Clerk. В примере: BY_KEYCLOAK_JWT — авторизация по JWT, выданным Keycloak.

Имя хоста Keycloak в Docker‑сети (keycloak), также используется webbackend’ом как EXTERNAL_HOST при работе внутри сети.

Порт, на котором доступен веб‑интерфейс и API Keycloak. Пробрасывается наружу.

Realm в Keycloak, в котором настроен клиент и пользователи (в примере clerk).

Имя клиента (client) в Keycloak, используемого Clerk и UI для авторизации пользователей (clerk-client).

Секрет клиента Keycloak используемый для получения токенов.

Имя администратора Keycloak создаваемого при инициализации (admin).

Имя драйвера/типа БД для Keycloak (postgres).

JDBC‑URL к базе данных Postgres для Keycloak (jdbc:postgresql://keycloak-db:5432/root).

Имя пользователя базы данных Postgres для Keycloak (root).

Пароль пользователя БД Keycloak (подтягивается из секрета keycloak_db_password).

Имя базы данных в контейнере Postgres для Keycloak (root).

Имя пользователя базы данных Postgres для Keycloak (root).

Путь к файлу с паролем пользователя Postgres (секрет postgres_password).

Хост Keycloak, к которому обращается Clerk для получения токена при запросах в AddressBook (в примере localhost, если AddressBook снаружи).

Порт Keycloak для авторизации запросов Clerk -> AddressBook (совпадает с KEYCLOAK_PORT: 8085).

Идентификатор клиента Keycloak под которым Clerk получает токен для обращения к AddressBook.

Секрет этого клиента для авторизации запросов к AddressBook.

HTTP‑путь, по которому сервисы экспортируют метрики Prometheus (по умолчанию /metrics).

Уровень логирования сервисов ASR (info, debug и т.п.). Если задали значение отличное от info, debug, warn,error заполните переменные: CLERK_LOG_LEVEL,  ASR_SERVER_LOG_LEVEL,  VOSK_LOG_LEVEL в соотвествии с правилами указаными в описании этих переменных.

Путь к файлу логов внутри контейнера Clerk (/app/log/clerk.log).

Уровень логов только для vosk-server. Если пусто — берётся LOG_LEVEL, если и его нет — info. (поддерживаются: info, debug, warn,error)

Адрес реестра контейнеров, из которого будут скачиваться образы Peeper.

Версия образов Peeper (agent, provisioner, telegraf, vector), используемая в docker-compose.

IP-адрес сервера Peeper, на который будет резолвиться доменное имя PEEPER_HOST.

Доменное имя или IP-адрес сервера Peeper, к которому подключаются Peeper-клиенты.

Сетевой порт сервера Peeper (HTTPS по умолчанию).

Режим работы с Docker-сетью external: false — сети нет, true — сеть external существует.

Часовой пояс для контейнеров Peeper (формат tz database, см. список таймзон).

Путь к Docker-сокету хоста, используемому для сбора метрик и информации о контейнерах.

GID группы docker на хостовой машине. Нужен peeper-telegraf для доступа к /var/run/docker.sock без запуска с root-правами.

Имя хоста для peeper-agent.

Путь к persistent-журналам systemd (JournalD), монтируемым в Peeper Vector.

Путь к volatile-журналам systemd (JournalD), монтируемым в Peeper Vector.

Токен доступа к серверу Peeper для авторизации запросов (используется provisioner).

Токен Telegram-бота для предварительной настройки уведомлений из Peeper/Grafana.

Идентификатор Telegram-чата или группы, куда отправляются уведомления.

Лимит оперативной памяти для контейнера peeper-agent.

Лимит оперативной памяти для контейнера peeper-provisioner.

Лимит оперативной памяти для контейнера peeper-telegraf.

Лимит оперативной памяти для контейнера peeper-vector.