ИИ и автоматизация 13 мин чтения 2026-11-03

Визуальный конструктор диалоговых ботов и форм Typebot на VDS: развертывание в Docker Compose с PostgreSQL, интеграцией с сайтом, Telegram и локальными LLM

Практическое руководство по развертыванию открытого конструктора диалоговых интерфейсов и форм Typebot v3 на собственном VDS в Docker Compose. Разбираем архитектуру typebot-builder и viewer, связку с PostgreSQL 16 и MinIO, настройку Nginx с SSL, интеграцию виджета на сайт, подключение Telegram-бота и моделей OpenAI/DeepSeek с соблюдением 152-ФЗ.

Инженерная редакция SysKit Проверено инженерами SysKit.ru

1. Преимущества диалоговых форм Typebot v3 и архитектура

Классические статические формы обратной связи в интернет-магазинах и на лендингах стремительно теряют эффективность: длинные простыни полей «Имя», «Телефон», «Email», «Комментарий» вызывают отторжение у мобильных пользователей. По данным отраслевых бенчмарков лидогенерации (Unbounce, Formstack), средняя конверсия классических длинных форм не превышает 2–4%. Совсем иначе работают пошаговые диалоговые интерфейсы (Conversational Forms), где общение строится в формате живого мессенджера: вопрос за вопросом, с подсказками, кнопками быстрого выбора и ветвлением логики в зависимости от ответов клиента.

Мировым стандартом в этой сфере долгое время являлись SaaS-платформы Typeform и Landbot. Однако в 2026 году для отечественного бизнеса использование зарубежных сервисов связано с критическими барьерами: жесткие лимиты на количество диалогов (тарифы Typeform начинаются от $29/мес всего за 100 ответов и $59/мес за 1000 ответов, а Landbot — от €40 до €100+/мес), блокировка оплаты российскими банковскими картами и прямая угроза штрафов по Федеральному закону № 152-ФЗ из-за хранения персональных данных клиентов на зарубежных серверах.

Решением этой проблемы стал Typebot — популярная платформа визуального конструирования диалоговых ботов (более 10 600 звёзд на GitHub). Проект распространяется с открытым исходным кодом под лицензией Fair Source (FSL-1.1-Apache-2.0): вы можете свободно разворачивать его на собственных серверах, модифицировать и использовать для любых внутренних бизнес-процессов компании без ограничений (с ограничением лишь на перепродажу сторонним лицам в виде конкурирующего SaaS-сервиса, при этом каждый релиз автоматически переходит в полностью свободную лицензию Apache 2.0 через 2 года). Развернув Typebot на собственном VDS, вы получаете неограниченное количество ботов, шагов и ответов без ежемесячных платежей, а все конфиденциальные заявки остаются в защищенном контуре вашего сервера.

Ключевые преимущества self-hosted Typebot v3:
  • Визуальный No-Code конструктор: построение сложных сценариев диалога методом Drag-and-Drop с ветвлением (условия If/Else), переменными и регулярными выражениями.
  • Сквозная интеграция с ИИ: встроенные блоки для подключения OpenAI, DeepSeek, Claude или локальных моделей через Ollama для генерации интеллектуальных ответов на вопросы клиентов.
  • Универсальная публикация: чат-бот встраивается на любой сайт (Bitrix, WordPress, Tilda, React/Vue) в 1 строчку HTML-кода как popup-виджет, кнопка в углу или встроенный блок (embed), а также запускается как полноценный бот в Telegram.
  • Мгновенная лидогенерация: отправка контактов лидов в Telegram-группу менеджеров, вебхуки в CRM-системы (amoCRM, Битрикс24) и экспорт в таблицы.
  • 100% соблюдение 152-ФЗ: база данных заявок физически располагается в российском ЦОД без транзита через иностранные шлюзы.

Архитектура Typebot v3: разделение Builder и Viewer

В актуальной мажорной линейке Typebot v3 архитектура разделена на два независимых микросервиса, что гарантирует высокую отказоустойчивость:

  • typebot-builder (порт 3000 → 127.0.0.1:8080): тяжелый интерфейс администратора и студия редактирования на Next.js. Здесь настраиваются сценарии, анализируются воронки прохождения шагов и создаются интеграции. Доступ к билдеру закрывается авторизацией администратора.
  • typebot-viewer (порт 3000 → 127.0.0.1:8081): сверхбыстрый и оптимизированный клиентский движок, который исполняет сценарии ботов для посетителей вашего сайта. В простое он потребляет всего 120–200 МБ RAM и обрабатывает входящие сессии через асинхронные HTTP/SSE-соединения без постоянной блокировки серверных потоков.
  • typebot-db (PostgreSQL 16): реляционная база данных для хранения учетных записей, схем диалогов, пользовательских переменных и собранных ответов.
  • typebot-minio (MinIO S3): локальное S3-совместимое объектное хранилище для медиафайлов: аватарок бота, картинок в сценариях и документов, загружаемых клиентами через форму.

2. Системные требования и подготовка VDS-сервера

Согласно замерам утилиты docker stats при непрерывной эксплуатации, базовый стек Typebot v3 в рабочем состоянии потребляет около 600–850 МБ RAM (builder ~200 МБ, viewer ~150 МБ, PostgreSQL 16 ~150–250 МБ, MinIO ~100 МБ). На сервере с 2 ГБ RAM остается более 1 ГБ нераспределенной физической памяти для дискового кэша ОС и обработки пиковых пользовательских сессий, что делает его крайне экономичным решением.

Параметр VDS Минимум (Тесты / 1–3 бота) Рекомендуется (Production / до 100 000 диалогов)
Процессор (vCPU) 1–2 ядра (от 2.4 ГГц) 2–4 ядра (от 3.0 ГГц NVMe)
Оперативная память (RAM) 2 ГБ (+ 4 ГБ Swap обязательно) 4 ГБ (+ 4 ГБ Swap)
Дисковый накопитель 25 ГБ NVMe 50–80 ГБ NVMe
Операционная система Ubuntu 24.04 / 22.04 LTS / Debian 12 Ubuntu 24.04 LTS
Сетевой интерфейс 100 Мбит/с, статический IPv4 100–300 Мбит/с, статический IPv4

Для предотвращения аварийного завершения контейнеров системным демоном Linux OOM Killer при пиковых всплесках трафика на сервере обязательно настраивается Swap-раздел объемом 4 ГБ.

Создание Swap-файла и оптимизация памяти ядра

# Проверяем текущее состояние подкачки
sudo swapon --show

# Создаем файл подкачки на 4 ГБ, если он отсутствует
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Сохраняем монтирование файла подкачки в fstab
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Оптимизируем swappiness (использовать swap только при нехватке физической RAM)
echo 'vm.swappiness=15' | sudo tee -a /etc/sysctl.d/99-sysctl.conf
sudo sysctl -p /etc/sysctl.d/99-sysctl.conf

3. Полный манифест Docker Compose для Typebot v3

Разворачивать стек Typebot v3 мы будем в изолированном каталоге /opt/typebot. Для соответствия стандартам безопасности боевых серверов все внутренние порты (PostgreSQL 5432, S3-хранилище MinIO 9000/9001, локальные порты веб-приложений 8080/8081) привязаны строго к интерфейсу локальной петли 127.0.0.1. Это исключает несанкционированный доступ извне в обход системного фаервола. Проверить закрытие портов после запуска поможет онлайн-сканер портов SysKit.

Генерация мастер-ключей и файла конфигурации .env

Создаем рабочую директорию и файл переменных окружения .env. Для шифрования учетных записей интеграций и паролей в базе данных необходим криптостойкий секрет ENCRYPTION_SECRET. Сгенерировать пароли для базы данных поможет генератор паролей SysKit.

# Создаем изолированную директорию
sudo mkdir -p /opt/typebot
cd /opt/typebot

# Генерируем 32-байтный случайный секрет шифрования
openssl rand -hex 32

# Создаем файл конфигурации .env
nano .env

Заполняем файл .env следующими параметрами (замените yourdomain.ru на ваш реальный рабочий домен):

# /opt/typebot/.env

# Мастер-ключ шифрования (сгенерируйте свой 32-байтный hex-ключ командой: openssl rand -hex 32)
ENCRYPTION_SECRET=СГЕНЕРИРУЙТЕ_СВОЙ_32_БАЙТНЫЙ_HEX_СЕКРЕТ_ЧЕРЕЗ_OPENSSL

# Публичные URL сервисов Typebot
# builder — студия редактирования для администратора
NEXTAUTH_URL=https://builder.yourdomain.ru
# viewer — клиентский движок, исполняющий сценарии для посетителей
NEXT_PUBLIC_VIEWER_URL=https://bot.yourdomain.ru

# Email администратора (для создания первого аккаунта)
ADMIN_EMAIL=admin@yourdomain.ru

# Отключаем регистрацию новых пользователей после создания аккаунта администратора
DISABLE_SIGNUP=false

# Параметры базы данных PostgreSQL (сгенерируйте надежный пароль)
POSTGRES_DB=typebot
POSTGRES_USER=typebot_user
POSTGRES_PASSWORD=СГЕНЕРИРУЙТЕ_НАДЕЖНЫЙ_ПАРОЛЬ_БД
DATABASE_URL=postgresql://typebot_user:СГЕНЕРИРУЙТЕ_НАДЕЖНЫЙ_ПАРОЛЬ_БД@typebot-db:5432/typebot

# Настройки объектного S3-хранилища MinIO для файлов и картинок
# Внутри docker-сети контейнеры обращаются к MinIO по имени сервиса typebot-minio
S3_ACCESS_KEY=minio_typebot_admin
S3_SECRET_KEY=СГЕНЕРИРУЙТЕ_НАДЕЖНЫЙ_ПАРОЛЬ_MINIO
S3_BUCKET=typebot
S3_ENDPOINT=typebot-minio
S3_PORT=9000
S3_SSL=false

Манифест docker-compose.yml

Создаем файл /opt/typebot/docker-compose.yml. Все сервисы снабжены жесткими лимитами оперативной памяти (mem_limit) и процессорного времени (cpus) для защиты от OOM:

# /opt/typebot/docker-compose.yml
services:
  # Реляционная база данных для схем ботов и ответов
  typebot-db:
    image: postgres:16-alpine
    container_name: typebot_db
    restart: always
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      TZ: UTC
    volumes:
      - typebot_pg_data:/var/lib/postgresql/data
    ports:
      - "127.0.0.1:5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 5
    mem_limit: 768m
    cpus: 1.0
    networks:
      - typebot_net

  # Локальное S3-хранилище медиафайлов и аватаров
  typebot-minio:
    image: minio/minio:RELEASE.2024-11-07T00-52-20Z
    container_name: typebot_minio
    restart: always
    entrypoint: sh
    command: -c 'mkdir -p /data/typebot && minio server --address ":9000" --console-address ":9001" /data'
    environment:
      MINIO_ROOT_USER: ${S3_ACCESS_KEY}
      MINIO_ROOT_PASSWORD: ${S3_SECRET_KEY}
    volumes:
      - typebot_minio_data:/data
    ports:
      - "127.0.0.1:9000:9000"
      - "127.0.0.1:9001:9001"
    healthcheck:
      test: ["CMD-SHELL", "curl -f http://127.0.0.1:9000/minio/health/live || exit 1"]
      interval: 5s
      timeout: 5s
      retries: 5
    mem_limit: 512m
    cpus: 0.5
    networks:
      - typebot_net

  # Визуальная студия-конструктор Typebot Builder
  typebot-builder:
    image: baptistearno/typebot-builder:3.19.1
    container_name: typebot_builder
    restart: always
    extra_hosts:
      - "host.docker.internal:host-gateway"
    env_file:
      - .env
    depends_on:
      typebot-db:
        condition: service_healthy
      typebot-minio:
        condition: service_healthy
    ports:
      - "127.0.0.1:8080:3000"
    mem_limit: 1024m
    cpus: 1.0
    networks:
      - typebot_net

  # Высокопроизводительный движок исполнения диалогов Typebot Viewer
  typebot-viewer:
    image: baptistearno/typebot-viewer:3.19.1
    container_name: typebot_viewer
    restart: always
    extra_hosts:
      - "host.docker.internal:host-gateway"
    env_file:
      - .env
    depends_on:
      typebot-db:
        condition: service_healthy
      typebot-minio:
        condition: service_healthy
    ports:
      - "127.0.0.1:8081:3000"
    mem_limit: 768m
    cpus: 1.0
    networks:
      - typebot_net

volumes:
  typebot_pg_data:
    driver: local
  typebot_minio_data:
    driver: local

networks:
  typebot_net:
    driver: bridge

Запускаем контейнеры в фоновом режиме:

cd /opt/typebot
docker compose up -d

# Проверяем успешный запуск всех 4 контейнеров
docker compose ps

4. Настройка Nginx, Let's Encrypt SSL и проксирование

Для полноценной работы платформы Typebot требуются два поддомена: builder.yourdomain.ru (панель управления сценариями) и bot.yourdomain.ru (клиентский движок отображения). Маршрутизацию запросов и выпуск бесплатных SSL-сертификатов Let's Encrypt обеспечит хостовый веб-сервер Nginx. Если вам требуется сгенерировать конфигурацию под другие службы, воспользуйтесь интерактивным конфигуратором Nginx от SysKit.

Установка Nginx и Certbot

sudo apt-get update
sudo apt-get install -y nginx certbot python3-certbot-nginx

Конфигурация виртуальных хостов Nginx

Создаем конфигурационный файл /etc/nginx/sites-available/typebot.conf:

# 1. Визуальный конструктор (Builder)
server {
    listen 80;
    server_name builder.yourdomain.ru;
    client_max_body_size 30M;
    server_tokens off;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;

        # Проброс заголовков для WebSocket
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

# 2. Клиентский движок диалогов (Viewer)
server {
    listen 80;
    server_name bot.yourdomain.ru;
    client_max_body_size 25M;
    server_tokens off;

    location / {
        proxy_pass http://127.0.0.1:8081;
        proxy_http_version 1.1;

        # Поддержка Server-Sent Events (SSE) для стриминга ответов LLM без буферизации
        proxy_buffering off;
        proxy_cache off;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Активируем конфигурацию и выпускаем SSL-сертификаты с автоматическим редиректом на HTTPS:

# Создаем символическую ссылку
sudo ln -sf /etc/nginx/sites-available/typebot.conf /etc/nginx/sites-enabled/

# Проверяем синтаксис Nginx
sudo nginx -t

# Перезагружаем конфигурацию
sudo systemctl reload nginx

# Выпускаем SSL-сертификаты Let's Encrypt для обоих поддоменов
sudo certbot --nginx -d builder.yourdomain.ru -d bot.yourdomain.ru --redirect --non-interactive --agree-tos -m admin@yourdomain.ru

Проверить корректность настройки HTTPS и валидность цепочки сертификатов можно через онлайн-чекер SSL от SysKit.

5. Практическая интеграция: виджет на сайт, Telegram и LLM

После завершения установки откройте в браузере https://builder.yourdomain.ru и зарегистрируйте учетную запись администратора с адресом, указанным в ADMIN_EMAIL. В панели управления перейдите в созданный проект и соберите сценарий диалога с помощью визуальных блоков: «Текст», «Ввод имени», «Ввод телефона», «Выбор услуги», «Условие (If/Else)».

Безопасность регистрации: После создания первого аккаунта администратора откройте файл /opt/typebot/.env, установите директиву DISABLE_SIGNUP=true и выполните docker compose up -d. Это заблокирует открытую регистрацию сторонних лиц в вашей студии.

Способ 1: Встраивание виджета на сайт (Tilda, WordPress, Bitrix)

Чтобы добавить плавающую кнопку чата в правый нижний угол сайта или отобразить квиз прямо в теле страницы, вставьте следующий сниппет перед закрывающим тегом </body>:

<!-- Виджет Typebot в углу экрана -->
<script type="module">
  import Typebot from 'https://cdn.jsdelivr.net/npm/@typebot.io/js@0/dist/web.js'

  Typebot.initBubble({
    typebot: "lead-generation-quiz",
    apiHost: "https://bot.yourdomain.ru",
    theme: {
      button: {
        backgroundColor: "#2563eb",
        iconColor: "#ffffff"
      },
      chatWindow: {
        maxHeight: "650px",
        maxWidth: "420px"
      }
    }
  });
</script>

Способ 2: Запуск чат-бота в Telegram

Typebot поддерживает бесшовный запуск любых сценариев прямо в Telegram:

  1. Создайте нового бота через официального отца ботов @BotFather в Telegram и сохраните полученный API-токен вида 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ.
  2. В редакторе Typebot перейдите во вкладку Share → Telegram.
  3. Вставьте токен бота и нажмите Publish. Typebot автоматически зарегистрирует вебхук на адрес https://bot.yourdomain.ru, и бот мгновенно начнет отвечать пользователям в Telegram.

Способ 3: Интеграция с моделями ИИ (OpenAI, DeepSeek, Ollama)

Чтобы бот не просто опрашивал клиента по скрипту, но и отвечал на свободные вопросы об услугах компании:

  • Добавьте в цепочку блок OpenAI / LLM.
  • В поле Base URL можно указать как официальный шлюз OpenAI, так и адрес локального демона http://host.docker.internal:11434/v1 с запущенной моделью Ollama (благодаря директиве extra_hosts: ["host.docker.internal:host-gateway"] в compose-манифесте контейнеры на Linux без проблем обращаются к службам хоста).
  • В блоке System Prompt передайте контекст компании: «Ты — виртуальный консультант интернет-магазина. Отвечай кратко, доброжелательно. Если клиент готов сделать заказ, запроси его номер телефона».

Рекомендуемые VDS-провайдеры

Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с

Выбор редакции
⚡

Timeweb Cloud — Скоростные NVMe VDS

Идеально для микросервисного стека Typebot: высокая частота ядер до 3.3 ГГц для мгновенной генерации веб-интерфейсов и быстрого отклика viewer-движка.

Конфигурация
2 vCPU 3.3 ГГц • 4 ГБ RAM • 50 ГБ NVMe • Трафик без лимита
Премиум Tier III
🔷

Selectel — Корпоративная инфраструктура Tier III

Максимальная надежность с размещением в ЦОД уровня Tier III в РФ. Идеально для безопасного сбора персональных данных клиентов и соблюдения 152-ФЗ.

Конфигурация
2 vCPU • 4 ГБ RAM • 60 ГБ NVMe • Канал 100 Мбит/с
Быстрый старт
🟠

Beget — Простота и стабильность

Удобное управление, автоматические ежедневные бэкапы всего сервера и поминутная тарификация для быстрого запуска квизов и ботов.

Конфигурация
2 vCPU • 4 ГБ RAM • 50 ГБ NVMe • Выделенный IPv4

6. Резервное копирование PostgreSQL и вложений с алертами в Telegram

В базе данных Typebot накапливаются самые ценные активы бизнеса: схемы воронок продаж, логи переписок и прямые контактные данные клиентов (номера телефонов, адреса, детали заказов). Потеря базы из-за сбоя диска или неосторожных действий администратора приведет к остановке приема лидов со всех сайтов. Настроим ежедневное резервное копирование с отправкой уведомлений в Telegram.

Скрипт автоматического бэкапа

Создаем скрипт /opt/typebot/backup_typebot.sh. Скрипт безопасно экспортирует базу данных PostgreSQL и архив директории MinIO, удаляет копии старше 7 дней и отправляет статус операции через Telegram Bot API с флагом --data-urlencode:

#!/usr/bin/env bash
# /opt/typebot/backup_typebot.sh
set -euo pipefail

# Пути и параметры
BACKUP_DIR="/opt/typebot/backups"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
RETENTION_DAYS=7

# Настройки Telegram-оповещений (замените на свои значения)
TG_BOT_TOKEN="123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ"
TG_CHAT_ID="987654321"

send_telegram() {
    local text="$1"
    if [ -n "$TG_BOT_TOKEN" ] && [ -n "$TG_CHAT_ID" ]; then
        curl -s -X POST "https://api.telegram.org/bot${TG_BOT_TOKEN}/sendMessage" \
            -d "chat_id=${TG_CHAT_ID}" \
            --data-urlencode "text=${text}" \
            -d "parse_mode=HTML" > /dev/null || true
    fi
}

mkdir -p "$BACKUP_DIR"
cd /opt/typebot

# 1. Снятие дампа базы данных PostgreSQL 16
PG_DUMP_FILE="${BACKUP_DIR}/typebot_db_${TIMESTAMP}.sql.gz"
if docker exec typebot_db pg_dump -U typebot_user typebot | gzip > "$PG_DUMP_FILE"; then
    DB_SIZE=$(du -h "$PG_DUMP_FILE" | cut -f1)
else
    send_telegram "❌ [Typebot VDS] Ошибка снятия дампа PostgreSQL!"
    exit 1
fi

# 2. Архивирование директории медиафайлов MinIO
MEDIA_DUMP_FILE="${BACKUP_DIR}/typebot_media_${TIMESTAMP}.tar.gz"
tar -czf "$MEDIA_DUMP_FILE" -C /var/lib/docker/volumes/typebot_typebot_minio_data/_data . 2>/dev/null || true
MEDIA_SIZE=$(du -h "$MEDIA_DUMP_FILE" | cut -f1)

# 3. Ротация старых копий
find "$BACKUP_DIR" -type f -name "typebot_*.gz" -mtime +"$RETENTION_DAYS" -delete

# 4. Успешный отчет в Telegram
MESSAGE="✅ Резервное копирование Typebot успешно!
📅 Дата: ${TIMESTAMP}
💾 База данных: ${DB_SIZE}
📁 Медиавложения: ${MEDIA_SIZE}
⏳ Ротация: старше ${RETENTION_DAYS} дн. удалены"

send_telegram "$MESSAGE"

Выдаем права на исполнение только суперпользователю и добавляем задачу в планировщик cron:

# Ограничиваем доступ к скрипту (только root)
sudo chmod 700 /opt/typebot/backup_typebot.sh

# Настраиваем ежедневный автоматический запуск в 03:00 ночи
(crontab -l 2>/dev/null; echo "0 3 * * * /opt/typebot/backup_typebot.sh >> /var/log/typebot_backup.log 2>&1") | crontab -

7. Безопасность, защита от спама и соответствие 152-ФЗ

Публичные диалоговые формы и квизы неизбежно становятся мишенью для автоматизированных спам-ботов, парсеров и флуд-атак. Кроме того, сбор контактов граждан РФ накладывает строгие требования регуляторов.

Рекомендации SysKit по безопасности и защите данных:
  • Соблюдение 152-ФЗ: арендуйте VDS у провайдеров с дата-центрами на территории РФ (Timeweb Cloud, Selectel, Beget). Обязательно добавьте в сценарий перед кнопкой отправки контактных данных блок с галочкой «Я согласен на обработку персональных данных» и ссылкой на политику конфиденциальности компании.
  • Защита от спам-ботов (Cloudflare Turnstile / reCAPTCHA): Typebot v3 поддерживает блоки умной капчи. Добавьте блок Captcha в начало сценария, чтобы отсекать спам-ботов до создания сессии в базе данных.
  • Ограничение частоты запросов в Nginx (Rate Limiting): добавьте в конфигурационный файл Nginx зону limit_req_zone $binary_remote_addr zone=viewer_limit:10m rate=15r/s; для поддомена bot.yourdomain.ru, чтобы защитить сервер от DoS-атак.
  • Шифрование секретов: переменная ENCRYPTION_SECRET шифрует API-ключи Telegram и сторонних сервисов алгоритмом AES непосредственно в таблицах PostgreSQL.

Инструменты SysKit по теме статьи

Бесплатные утилиты для проверки и диагностики вашего сервера

Вопросы и ответы (FAQ)

Популярные вопросы вебмастеров и сисадминов по данной теме

Можно ли использовать Typebot на одном домене без двух поддоменов (builder и viewer)?
Технически возможно настроить маршрутизацию через Nginx по путям, однако разработчики Typebot строго рекомендуют использовать два раздельных поддомена (например, builder.yourdomain.ru и bot.yourdomain.ru). Это обусловлено строгой изоляцией сессий аутентификации NextAuth, безопасностью cookies авторизации и корректными политиками CORS при встраивании виджетов на внешние сайты.
Каково реальное потребление ресурсов Typebot и сколько диалогов он выдерживает на 2 ГБ RAM?
В режиме ожидания и стандартной работы весь микросервисный стек Typebot v3 (typebot-builder, typebot-viewer, PostgreSQL 16 и MinIO) суммарно потребляет около 600–850 МБ RAM. Клиентский движок Viewer работает по легковесной асинхронной модели (stateless HTTP/SSE-запросы) и не удерживает блокирующие потоки под каждого посетителя. На VDS с 2 vCPU и 2 ГБ RAM (+ 4 ГБ Swap) система комфортно обслуживает трафик до 5 000–15 000 посетителей в сутки. Узким местом при пиковых нагрузках выступает не сам Typebot, а задержки внешних LLM API или пропускная способность NVMe при интенсивной записи в базу данных.
Как отправлять собранные лиды и ответы в amoCRM или Битрикс24?
В сценарии Typebot доступен универсальный блок Webhook. В конце диалога после успешного сбора контактов добавьте блок Webhook с методом POST и передайте JSON с собранными переменными ({{name}}, {{phone}}, {{service}}) на URL входящего вебхука вашей CRM или шлюза автоматизации (Activepieces, n8n). Также лиды можно мгновенно пересылать в рабочий Telegram-чат.
Как обновить Typebot v3 на новую версию в Docker Compose?
Процесс обновления прост благодаря автоматическим миграциям базы данных Prisma. В директории /opt/typebot выполните: docker compose pull (загрузит свежие образы ветки :3 или указанный релизный тег :3.19.1), затем docker compose down и docker compose up -d. Контейнер builder самостоятельно применит миграции схем при старте. Перед обновлением всегда создавайте резервную копию скриптом backup_typebot.sh.

Читайте также в блоге SysKit

Смежные руководства и полезные технические статьи