Создание прикладных систем на базе больших языковых моделей (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. Подготовим изолированную рабочую директорию проекта:
sudo mkdir -p /opt/flowise
cd /opt/flowise
Flowise хранит подключенные API-ключи нейросетей, токены ботов и пароли баз данных в зашифрованном виде. Для шифрования критически важно сгенерировать статический мастер-ключ FLOWISE_SECRETKEY_OVERWRITE:
# Генерация мастер-ключа шифрования хранилища секретов (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 (замените плейсхолдеры на сгенерированные значения и укажите логин с надежным паролем):
# Фиксация стабильной версии 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
chmod 600 /opt/flowise/.env
Рекомендуемые VDS-провайдеры
Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с
Timeweb Cloud — Быстрые NVMe VDS
Высокочастотные процессоры 3.3+ ГГц для моментальной обработки RAG-эмбеддингов, NVMe-диски и надежный сетевой канал 1 Гбит/с.
Selectel — Надежные облачные серверы
Отказоустойчивая инфраструктура в сертифицированных дата-центрах уровня Tier III с гарантированными ресурсами памяти под PostgreSQL и векторные индексы.
Beget — Простота для веб-разработчиков
Мгновенное развертывание серверов, удобное управление сетью, бесплатное ежедневное автоматическое резервное копирование и поддержка 24/7.
5. Производственный манифест Docker Compose с изоляцией сети и лимитами ресурсов
Создадим производственный файл /opt/flowise/docker-compose.yml. В конфигурации веб-порт Flowise привязан строго к локальному адресу 127.0.0.1:3000 (что предотвращает обход файрвола UFW), для всех сервисов заданы строгие лимиты оперативной памяти (mem_limit), а база данных PostgreSQL защищена проверкой состояния (healthcheck):
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:
Запустите контейнеры комплекса:
docker compose up -d
Инициализация базы данных и автоматическое выполнение миграций схем таблиц занимает около 15–20 секунд. Проверьте статус работы контейнеров:
docker compose ps
6. Настройка Nginx с SSL Let's Encrypt и потоковой передачей ответов (SSE/WebSocket)
Для взаимодействия с ИИ-агентами критически важен эффект плавной печати текста (Streaming). Если веб-сервер буферизует ответы, пользователь не увидит начало реплики до тех пор, пока нейросеть полностью не сгенерирует весь ответ. Чтобы этого избежать, в Nginx отключается буферизация (proxy_buffering off;) и настраивается сопоставление заголовков WebSocket.
Установите веб-сервер Nginx и Certbot:
sudo apt update && sudo apt install -y nginx certbot python3-certbot-nginx
Создайте конфигурационный файл виртуального хоста /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-сертификат:
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-код:
<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) для разделения памяти разных пользователей:
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:
#!/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:
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
Для обновления платформы до новых релизов:
cd /opt/flowise
# Шаг 1: Создание внеочередной резервной копии
./backup.sh
# Шаг 2: Изменение тега FLOWISE_VERSION в .env и перезапуск
docker compose pull
docker compose up -d
Запустите платформу ИИ-агентов на надежном российском VDS
Для быстрой обработки RAG-запросов и бесперебойной работы Telegram-ботов выбирайте серверы с быстрыми накопителями NVMe и стабильным сетевым каналом в РФ.