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

Визуальный конструктор ИИ-агентов Flowise на VDS: развертывание в Docker Compose с PostgreSQL, цепочками LangChain, RAG и подключением к Telegram

Инженерное руководство по развертыванию визуального конструктора ИИ-агентов Flowise v3.1 на VDS в Docker Compose: подключение PostgreSQL 16, мастер-шифрование API-ключей, обратный прокси Nginx с SSE, построение RAG-цепочек LangChain и интеграция с Telegram.

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

Создание прикладных систем на базе больших языковых моделей (LLM) долгое время требовало глубокого погружения в код фреймворков LangChain и LlamaIndex на Python или TypeScript. Для интернет-магазинов, сервисных компаний и агентств это означало долгие недели разработки, найм дорогостоящих ML-инженеров и риски поломки скриптов при каждом обновлении API. Настоящим прорывом в low-code разработке стал Flowise — флагманский визуальный конструктор ИИ-агентов, RAG-цепочек и мультиагентных систем с открытым исходным кодом.

В интерфейсе Flowise сложные логические цепочки — от подключения векторных баз данных и парсинга документов до интеграции калькуляторов, поиска в интернете и SQL-запросов к CRM — собираются перетаскиванием блоков (drag-and-drop). В этой инструкции инженеры редакции SysKit детально разберут установку актуального стабильного релиза Flowise v3.1 на надежном российском VDS в Docker Compose, настройку отказоустойчивой базы данных PostgreSQL 16, статическое шифрование API-ключей, защищенный обратный прокси Nginx с поддержкой потокового вывода ответов (SSE) и подключение готового агента к Telegram-боту.

💡 Чем Flowise отличается от Dify и Langflow

Если Dify ориентирован на комплексные готовые рабочие пространства для маркетологов, а Langflow требует значительных ресурсов Python-стека, то Flowise построен на легковесном Node.js / TypeScript. Он потребляет всего 300–500 МБ оперативной памяти, идеально транслирует нативную архитектуру LangChain.js, предоставляет готовый JavaScript-виджет для вставки чата на сайт в одну строчку кода и нативно взаимодействует с локальными моделями Ollama и DeepSeek.

1. Зачем бизнесу и разработчикам визуальный конструктор ИИ-агентов Flowise

Развертывание Flowise на собственном сервере решает четыре критические задачи современной цифровой инфраструктуры:

  • Абсолютная конфиденциальность и соответствие 152-ФЗ: Корпоративные базы знаний, прайс-листы, регламенты компании и история переписки с клиентами хранятся в вашей базе данных PostgreSQL в РФ, исключая утечку коммерческой тайны через облачные SaaS-конструкторы.
  • Быстрый запуск бизнес-агентов без программирования: Руководитель отдела продаж или системный администратор может за 20 минут собрать умного чат-бота первой линии поддержки, который обращается к PDF-инструкциям, отвечает на вопросы покупателей и передает заявки менеджерам.
  • Работа без зарубежных карт и блокировок: Flowise легко подключается как к бесплатным локальным моделям (через Ollama на CPU/GPU), так и к доступным без ограничений API (DeepSeek, YandexGPT, GigaChat, LiteLLM Proxy) с оплатой российскими рублями.
  • Мгновенное встраивание (Full API & Webhooks): Каждая собранная цепочка автоматически получает REST API эндпоинт, готовый скрипт для вставки всплывающего чата на сайт и вебхук для Telegram.

2. Архитектура Flowise: компоненты Node.js, бэкенд PostgreSQL 16 и потоковый стриминг

Flowise спроектирован как монолитное высокопроизводительное веб-приложение на TypeScript, работающее под управлением Node.js. В боевой конфигурации на VDS инфраструктура разделяется на изолированные сервисы:

Компонент Технологический стек Роль в инфраструктуре
flowise-server Node.js 20, Express, TypeORM Ядро платформы: визуальный редактор узлов, среда выполнения агентов LangChain.js, менеджер учетных записей и эндпоинты REST/WebSocket API.
flowise-postgres PostgreSQL 16 (Alpine) Реляционная СУБД для постоянного хранения графов цепочек, истории сообщений сессий, конфигураций узлов и зашифрованных токенов интеграций.
Криптографический сейф AES-256-GCM (SecretKey) Внутреннее сквозное шифрование паролей, токенов нейросетей и ключей баз данных с помощью мастер-ключа FLOWISE_SECRETKEY_OVERWRITE.
Nginx Reverse Proxy Nginx + Certbot (SSL) Терминация TLS/HTTPS, защита веб-порта, трансляция Server-Sent Events (SSE) для печати ответа нейросети в реальном времени и ограничение размера тел запросов.

По умолчанию Flowise использует встроенную SQLite, однако в production-окружении это создает риск блокировки файла базы при параллельных запросах пользователей (database is locked). Подключение PostgreSQL 16 гарантирует целостность транзакций и бесперебойную обработку сотен одновременных диалогов.

3. Системные требования к VDS и выбор конфигурации сервера

Благодаря оптимизированному движку Node.js сам Flowise крайне экономичен по ресурсам. Требования к VDS зависят от того, где выполняется инференс нейросетей — на внешних API или локально на том же сервере:

Режим работы Конфигурация VDS Диск NVMe Характер нагрузки и сценарий
Работа через внешние API (старт) 2 vCPU / 4 ГБ RAM 30–40 ГБ NVMe Идеально для 95% задач. Инференс идет через API DeepSeek, OpenAI, Groq или YandexGPT. Нагрузка на сервер минимальна.
RAG с локальными эмбеддингами 4 vCPU / 8 ГБ RAM 60–80 ГБ NVMe Генерация векторов для базы знаний на CPU (модели bge-m3 / all-minilm) + обработка тяжелых PDF-каталогов.
Полный автономный контур с Ollama 8 vCPU / 16 ГБ RAM 120+ ГБ NVMe Запуск квантованных LLM (Qwen 2.5 7B, Llama 3.1 8B в формате Q4_K_M) на многоядерном CPU сервера без интернета.

4. Генерация криптографических ключей, мастер-шифрование и подготовка .env

Развертывание выполняется на сервере под управлением Ubuntu 24.04 LTS или Debian 12 с установленным пакетом Docker Engine и плагином Compose. Подготовим изолированную рабочую директорию проекта:

bash — создание рабочей директории
sudo mkdir -p /opt/flowise
cd /opt/flowise

Flowise хранит подключенные API-ключи нейросетей, токены ботов и пароли баз данных в зашифрованном виде. Для шифрования критически важно сгенерировать статический мастер-ключ FLOWISE_SECRETKEY_OVERWRITE:

bash — генерация криптографических секретов
# Генерация мастер-ключа шифрования хранилища секретов (32 байта hex)
openssl rand -hex 32

# Генерация пароля для пользователя базы данных PostgreSQL 16
openssl rand -hex 24

⚠️ Критическая важность статического мастер-ключа FLOWISE_SECRETKEY_OVERWRITE

Если переменная FLOWISE_SECRETKEY_OVERWRITE не задана явно в .env, Flowise генерирует случайный ключ при первом старте и сохраняет его во временных файлах контейнера. При любом перезапуске, смене образа или миграции сервера временный ключ будет потерян, а все сохраненные в PostgreSQL токены нейросетей и ключи интеграций окажутся навсегда заблокированы с ошибкой расшифровки (Decryption Error). Статический мастер-ключ гарантирует надежность сохраненных данных на годы вперед.

Создайте конфигурационный файл /opt/flowise/.env (замените плейсхолдеры на сгенерированные значения и укажите логин с надежным паролем):

/opt/flowise/.env
# Фиксация стабильной версии Flowise
FLOWISE_VERSION=3.1.4

# Параметры веб-сервера
PORT=3000

# Авторизация администратора в панели управления
FLOWISE_USERNAME=admin@company.ru
FLOWISE_PASSWORD=YOUR_STRONG_PANEL_PASSWORD

# Статический мастер-ключ шифрования API-ключей и учетных данных в БД
FLOWISE_SECRETKEY_OVERWRITE=YOUR_GENERATED_32BYTE_HEX_KEY

# Параметры подключения к PostgreSQL 16
DATABASE_TYPE=postgres
DATABASE_HOST=flowise-postgres
DATABASE_PORT=5432
DATABASE_NAME=flowise
DATABASE_USER=flowise_app
DATABASE_PASSWORD=YOUR_STRONG_DB_PASSWORD
DATABASE_SSL=false

# Отключение сбора внешней аналитики
DISABLE_FLOWISE_TELEMETRY=true

# Уровень журналирования (info, error, debug)
LOG_LEVEL=info
bash — ограничение прав доступа к секретам
chmod 600 /opt/flowise/.env

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

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

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

Timeweb Cloud — Быстрые NVMe VDS

Высокочастотные процессоры 3.3+ ГГц для моментальной обработки RAG-эмбеддингов, NVMe-диски и надежный сетевой канал 1 Гбит/с.

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

Selectel — Надежные облачные серверы

Отказоустойчивая инфраструктура в сертифицированных дата-центрах уровня Tier III с гарантированными ресурсами памяти под PostgreSQL и векторные индексы.

Конфигурация
4 vCPU • 8 ГБ RAM • 80 ГБ NVMe • Дата-центры Tier III
Простота и стабильность
🟠

Beget — Простота для веб-разработчиков

Мгновенное развертывание серверов, удобное управление сетью, бесплатное ежедневное автоматическое резервное копирование и поддержка 24/7.

Конфигурация
2 vCPU • 4 ГБ RAM • 40 ГБ NVMe • Бесплатные бэкапы

5. Производственный манифест Docker Compose с изоляцией сети и лимитами ресурсов

Создадим производственный файл /opt/flowise/docker-compose.yml. В конфигурации веб-порт Flowise привязан строго к локальному адресу 127.0.0.1:3000 (что предотвращает обход файрвола UFW), для всех сервисов заданы строгие лимиты оперативной памяти (mem_limit), а база данных PostgreSQL защищена проверкой состояния (healthcheck):

/opt/flowise/docker-compose.yml
services:
  flowise:
    image: "flowiseai/flowise:${FLOWISE_VERSION:-3.1.4}"
    container_name: flowise_app
    restart: unless-stopped
    ports:
      # Защита от обхода UFW: порт открыт только для локального Nginx
      - "127.0.0.1:3000:3000"
    environment:
      PORT: ${PORT:-3000}
      FLOWISE_USERNAME: ${FLOWISE_USERNAME}
      FLOWISE_PASSWORD: ${FLOWISE_PASSWORD}
      FLOWISE_SECRETKEY_OVERWRITE: ${FLOWISE_SECRETKEY_OVERWRITE}
      DATABASE_TYPE: ${DATABASE_TYPE}
      DATABASE_HOST: ${DATABASE_HOST}
      DATABASE_PORT: ${DATABASE_PORT}
      DATABASE_NAME: ${DATABASE_NAME}
      DATABASE_USER: ${DATABASE_USER}
      DATABASE_PASSWORD: ${DATABASE_PASSWORD}
      DATABASE_SSL: ${DATABASE_SSL}
      DISABLE_FLOWISE_TELEMETRY: ${DISABLE_FLOWISE_TELEMETRY}
      LOG_LEVEL: ${LOG_LEVEL}
    volumes:
      - flowise_data:/root/.flowise
    depends_on:
      flowise-postgres:
        condition: service_healthy
    networks:
      - flowise-net
    mem_limit: 1024m
    cpus: 1.0

  flowise-postgres:
    image: "postgres:16-alpine"
    container_name: flowise_postgres
    restart: unless-stopped
    stop_signal: SIGINT
    environment:
      POSTGRES_INITDB_ARGS: "--data-checksums"
      POSTGRES_DB: ${DATABASE_NAME}
      POSTGRES_USER: ${DATABASE_USER}
      POSTGRES_PASSWORD: ${DATABASE_PASSWORD}
    volumes:
      - flowise_pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"]
      interval: 5s
      timeout: 5s
      retries: 5
    networks:
      - flowise-net
    mem_limit: 512m
    cpus: 0.5

networks:
  flowise-net:
    driver: bridge

volumes:
  flowise_data:
  flowise_pgdata:

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

bash — запуск контейнеров Flowise
docker compose up -d

Инициализация базы данных и автоматическое выполнение миграций схем таблиц занимает около 15–20 секунд. Проверьте статус работы контейнеров:

bash — проверка состояния контейнеров
docker compose ps

6. Настройка Nginx с SSL Let's Encrypt и потоковой передачей ответов (SSE/WebSocket)

Для взаимодействия с ИИ-агентами критически важен эффект плавной печати текста (Streaming). Если веб-сервер буферизует ответы, пользователь не увидит начало реплики до тех пор, пока нейросеть полностью не сгенерирует весь ответ. Чтобы этого избежать, в Nginx отключается буферизация (proxy_buffering off;) и настраивается сопоставление заголовков WebSocket.

Установите веб-сервер Nginx и Certbot:

bash — установка Nginx и Certbot
sudo apt update && sudo apt install -y nginx certbot python3-certbot-nginx

Создайте конфигурационный файл виртуального хоста /etc/nginx/sites-available/flowise.example.ru.conf (замените домен на ваш реальный):

/etc/nginx/sites-available/flowise.example.ru.conf
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    listen 80;
    server_name flowise.example.ru;

    # Лимит загрузки файлов для RAG-баз знаний (PDF, DOCX, CSV)
    client_max_body_size 50M;

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

        # Заголовки WebSocket и долгоживущих сессий
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $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;

        # Отключение буферизации для мгновенного стриминга токенов (SSE)
        proxy_buffering off;
        proxy_cache off;

        # Увеличенные таймауты для тяжелых мультиагентных цепочек
        proxy_read_timeout 600s;
        proxy_send_timeout 600s;
    }
}

Активируйте виртуальный хост и выпустите бесплатный SSL-сертификат:

bash — валидация хоста и выпуск сертификата
sudo ln -s /etc/nginx/sites-available/flowise.example.ru.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d flowise.example.ru --redirect

💡 Контроль закрытости сетевого контура

Убедитесь в изоляции базы данных и внутренних сервисов через онлайн-сканер портов SysKit. Порты 3000 и 5432 должны быть закрыты для внешних сканеров, а весь трафик обязан маршрутизироваться исключительно через HTTPS (порт 443).

7. Первый вход, безопасность панели и настройка учетных записей

Откройте в браузере адрес https://flowise.example.ru. Система встретит вас окном авторизации. Введите логин и пароль, указанные в переменных FLOWISE_USERNAME и FLOWISE_PASSWORD.

Сразу после первого входа перейдите в раздел API Keys в боковом меню. Создайте новый API-ключ для внешних интеграций: с его помощью ваш сервер Flowise сможет безопасно принимать запросы от внешних скриптов, веб-сайтов и Telegram-ботов без необходимости передачи пароля администратора.

8. Построение ИИ-агента с памятью, базой знаний RAG и инструментами

В главном окне Flowise нажмите кнопку Add New в разделе Chatflows. Перед вами откроется интерактивный холст. Сборка умного ИИ-ассистента для интернет-магазина или службы поддержки состоит из соединения пяти ключевых функциональных блоков:

  • Языковая модель (LLM Node): Добавьте узел ChatOpenAI или ChatOllama. При использовании недорогих и доступных без ограничений моделей (DeepSeek-V3 или DeepSeek-R1) выберите ChatOpenAI, укажите в качестве Base URL адрес https://api.deepseek.com/v1 и добавьте ваш API-токен в менеджер учетных данных Flowise.
  • Память диалога (Memory Node): Подключите узел Buffer Memory или Zep Memory к входу памяти агента. Это позволит модели помнить контекст всей беседы, имена клиентов и детали предыдущих сообщений.
  • Векторная база знаний (RAG / Vector Store): Чтобы бот отвечал строго по вашим регламентам и прайс-листам, добавьте узел In-Memory Vector Store или векторную базу. В качестве загрузчика документов (Document Loader) подключите PDF File или Text File, а для разбивки текста на чанки — Recursive Character Text Splitter (размер фрагмента 1000 символов с перекрытием 200).
  • Инструменты действий (Tools): В отличие от пассивных чат-ботов, агент умеет совершать действия. Подключите инструмент Custom Tool или Web Search для проверки актуального статуса заказа по номеру через API вашей CRM или поиска свежей информации.

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

9. Интеграция агента с Telegram-ботом и веб-виджетом на сайте

Каждая созданная цепочка в Flowise автоматически получает собственный идентификатор (chatflowid) и готова к подключению на любые клиентские платформы.

Для встраивания всплывающего виджета чата на сайт интернет-магазина достаточно нажать кнопку </> (API Endpoint) и скопировать готовый JavaScript-код:

html — вставка виджета Flowise на сайт
<script type="module">
    import Chatbot from "https://cdn.jsdelivr.net/npm/flowise-embed/dist/web.js"
    Chatbot.init({
        chatflowid: "YOUR_CHATFLOW_UUID_HERE",
        apiHost: "https://flowise.example.ru",
        theme: {
            button: {
                backgroundColor: "#2563eb",
                iconColor: "#ffffff"
            },
            chatWindow: {
                title: "Поддержка клиентов SysKit",
                welcomeMessage: "Здравствуйте! Чем я могу помочь вам сегодня?"
            }
        }
    })
</script>

Для подключения созданной цепочки к Telegram-боту Flowise предоставляет прямой REST API эндпоинт /api/v1/prediction/{chatflowid}. Простой асинхронный скрипт на Python или Node.js пересылает входящие сообщения из Telegram во Flowise с сохранением идентификатора чата (chatId) для разделения памяти разных пользователей:

python — Telegram-шлюз к API Flowise
import asyncio
import httpx
from aiogram import Bot, Dispatcher, types

BOT_TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"
FLOWISE_API = "https://flowise.example.ru/api/v1/prediction/YOUR_CHATFLOW_UUID"
FLOWISE_KEY = "Bearer YOUR_FLOWISE_API_KEY"

bot = Bot(token=BOT_TOKEN)
dp = Dispatcher()

@dp.message()
async def handle_message(msg: types.Message):
    await bot.send_chat_action(msg.chat.id, "typing")
    async with httpx.AsyncClient(timeout=60.0) as client:
        payload = {
            "question": msg.text,
            "chatId": f"tg_{msg.chat.id}"
        }
        headers = {"Authorization": FLOWISE_KEY}
        res = await client.post(FLOWISE_API, json=payload, headers=headers)
        if res.status_code == 200:
            reply = res.json().get("text", "Извините, ответ не сформирован.")
            await msg.answer(reply)
        else:
            await msg.answer("Ошибка связи с сервером ИИ-агентов.")

async def main():
    await dp.start_polling(bot)

if __name__ == "__main__":
    asyncio.run(main())

10. Резервное копирование базы данных, ротация секретов и регламент обновления

Вся интеллектуальная собственность — настроенные агенты, промпты, история диалогов и загруженные документы — хранится в PostgreSQL 16 и директории /root/.flowise. Настроим автоматическое резервное копирование с выгрузкой в удаленный S3-бакет (Timeweb Cloud S3 или Selectel S3).

Создайте автоматический скрипт /opt/flowise/backup.sh:

/opt/flowise/backup.sh
#!/usr/bin/env bash
set -eo pipefail

BACKUP_DIR="/var/backups/flowise"
DATE=$(date +%Y%m%d_%H%M%S)
mkdir -p "${BACKUP_DIR}"

echo "[INFO] Создание дампа PostgreSQL 16 прямой потоковой выгрузкой..."
docker exec -i flowise_postgres pg_dump -U flowise_app -d flowise -F c -b > "${BACKUP_DIR}/flowise_db_${DATE}.dump"

echo "[INFO] Архивация конфигурации и файлов окружения..."
tar -czf "${BACKUP_DIR}/flowise_env_${DATE}.tar.gz" -C /opt/flowise .env

echo "[INFO] Архивирование пользовательских файлов и векторных индексов..."
docker run --rm -v flowise_data:/data -v "${BACKUP_DIR}:/backup" alpine tar -czf "/backup/flowise_files_${DATE}.tar.gz" -C /data .

# Установка строгих прав доступа
chmod 600 "${BACKUP_DIR}/flowise_db_${DATE}.dump" "${BACKUP_DIR}/flowise_env_${DATE}.tar.gz" "${BACKUP_DIR}/flowise_files_${DATE}.tar.gz"

# Off-site синхронизация в удаленный S3
if command -v s3cmd &> /dev/null; then
  echo "[INFO] Отправка резервных копий в S3..."
  s3cmd put "${BACKUP_DIR}/flowise_db_${DATE}.dump" s3://company-backups/flowise/
  s3cmd put "${BACKUP_DIR}/flowise_files_${DATE}.tar.gz" s3://company-backups/flowise/
fi

# Удаление локальных копий старше 14 дней
find "${BACKUP_DIR}" -type f -mtime +14 -delete
echo "[OK] Резервное копирование Flowise успешно завершено: ${DATE}"

Сделайте скрипт исполняемым и добавьте его в планировщик cron:

bash — настройка cron
chmod +x /opt/flowise/backup.sh
(crontab -l 2>/dev/null; echo "0 3 * * * /opt/flowise/backup.sh >> /var/log/flowise_backup.log 2>&1") | crontab -

Регламент безопасного обновления Flowise

Для обновления платформы до новых релизов:

bash — обновление сервиса
cd /opt/flowise
# Шаг 1: Создание внеочередной резервной копии
./backup.sh

# Шаг 2: Изменение тега FLOWISE_VERSION в .env и перезапуск
docker compose pull
docker compose up -d

Запустите платформу ИИ-агентов на надежном российском VDS

Для быстрой обработки RAG-запросов и бесперебойной работы Telegram-ботов выбирайте серверы с быстрыми накопителями NVMe и стабильным сетевым каналом в РФ.

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

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

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

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

Почему в производственном развертывании Flowise необходимо заменять SQLite на PostgreSQL?
Встроенная SQLite хранит все данные в одном файле. При одновременных запросах от веб-виджета, Telegram-бота и администратора SQLite блокирует файл (database is locked), что приводит к сбоям генерации ответов и зависанию диалогов. PostgreSQL 16 обеспечивает параллельные ACID-транзакции, надежные блокировки строк и устойчивость при любой нагрузке.
Зачем обязательно задавать переменную FLOWISE_SECRETKEY_OVERWRITE?
Flowise использует эту переменную в качестве мастер-ключа симметричного шифрования (AES-256) для хранения паролей, токенов нейросетей и ключей баз данных. Если ключ не зафиксирован статически, контейнер создает временный ключ при первом запуске. При любом обновлении образа или перезапуске контейнера временный ключ теряется, а все сохраненные учетные данные в базе перестают расшифровываться.
Можно ли использовать Flowise полностью локально без платных зарубежных API?
Да. Flowise имеет встроенные узлы интеграции с Ollama и локальными совместимыми сервисами (LiteLLM Proxy). Вы можете развернуть локальную модель (например, DeepSeek-R1-Distill-Qwen или Llama 3.1) и локальный эмбеддер (bge-m3), получив полностью изолированный контур без передачи данных в интернет и без необходимости зарубежных банковских карт.

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

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