Flowise позволяет визуально связывать вызовы моделей, поиск и логику приложения. Начните с простой цепочки «запрос — ответ» для черновиков или классификации. Выполнение действий добавляйте после проверки текстового сценария. Здесь используется современный вход администратора по email и паролю, а не устаревшие переменные базовой авторизации.
Среда: Ubuntu Server 24.04 LTS, x86-64, SSH и учётная запись с sudo. Проверено по документации 15 ноября 2026 года. Команды не проходили сквозное испытание на Ubuntu.
Что подготовить
При внешней обработке моделью ориентируйтесь на 2–4 vCPU, 4 ГБ RAM и 15 ГБ свободного диска. Разбор документов, дополнительные обработчики и локальные модели требуют больше ресурсов. Для внешних провайдеров нужны собственные ключи и бюджет; редактор не включает вычислительные ресурсы модели.
Приведённые ресурсы — ориентир для небольшого теста, а не гарантия производительности или описание тарифов. VPS/VDS не означает наличие GPU. Проверьте память, диск и доступные ресурсы перед заказом.
На чистой Ubuntu установите пакеты ниже. Если Docker уже установлен из другого репозитория, сохраните текущую установку и сначала проверьте совместимость: не смешивайте пакеты Docker CE и docker.io. Нужен Compose v2; при отсутствии пакета проверьте включение репозитория Ubuntu Universe.
sudo apt update
sudo apt install -y docker.io docker-compose-v2 curl openssl
sudo systemctl enable --now docker
sudo docker compose version
Все примеры публикуют порты только на 127.0.0.1 сервера. Для доступа с компьютера используйте SSH-туннель; домен для этого не нужен. Не открывайте эти порты в интернете. Внутренний адрес 0.0.0.0 в контейнере не отменяет привязку опубликованного порта к loopback хоста.
Каждый проект ниже — новая установка. Не повторяйте генерацию секретов поверх уже работающего экземпляра.
1. Сохраняйте состояние и постоянные секреты
Современный контейнер использует /home/node/.flowise. Создайте разные секреты и сохраните compose.yaml. Не теряйте файл окружения: без ключа шифрования сохранённые данные провайдеров могут стать недоступны.
umask 077
mkdir -p ~/ai-flowise
cd ~/ai-flowise
sudo install -d -m 700 -o 1000 -g 1000 data
for key in FLOWISE_SECRETKEY_OVERWRITE JWT_AUTH_TOKEN_SECRET JWT_REFRESH_TOKEN_SECRET EXPRESS_SESSION_SECRET TOKEN_HASH_SECRET; do
printf '%s=%s\n' "$key" "$(openssl rand -hex 32)"
done > .env
services:
flowise:
image: flowiseai/flowise:latest
restart: unless-stopped
env_file: .env
environment:
PORT: "3000"
APP_URL: http://localhost:3000
DATABASE_PATH: /home/node/.flowise
SECRETKEY_PATH: /home/node/.flowise
BLOB_STORAGE_PATH: /home/node/.flowise/storage
LOG_PATH: /home/node/.flowise/logs
ports:
- "127.0.0.1:3000:3000"
volumes:
- ./data:/home/node/.flowise
2. Создайте владельца через приватный доступ
Запустите сервис и подключитесь со своего компьютера. Откройте http://localhost:3000 в соответствии с APP_URL и создайте администратора. Если локальный порт 3000 занят, согласованно измените его в публикации порта, туннеле и APP_URL.
sudo docker compose up -d
curl --fail-with-body http://127.0.0.1:3000/api/v1/ping
ssh -N -L 127.0.0.1:3000:127.0.0.1:3000 YOUR_USER@YOUR_SERVER_IP
3. Соберите небольшой процесс
Создайте Chatflow с чат-моделью и инструкцией для одной задачи, например классификации тестового обращения. Добавьте ключ через хранилище учётных данных, сохраните и проверьте процесс в редакторе. На первом этапе не подключайте корпоративные базы и командную оболочку. Названия меню и узлов могут меняться: выберите узел своего провайдера.
4. Защитите API процесса
Вход в редактор и доступ к API конкретного процесса — разные уровни защиты. Перед публикацией prediction endpoint назначьте процессу API-ключ и вызывайте его со своего бэкенда, а не из браузерного кода, где ключ будет виден. Редактор оставьте приватным. Копируйте data и .env вместе и экспортируйте схемы; экспорт не обязательно включает все секреты и записи базы. До подключения автоматических запусков настройте лимиты расходов у провайдера.
Обновления и восстановление
Перед обновлением остановите приложение на время согласованного резервного копирования, сохраните данные и секреты за пределами VPS и проверьте восстановление на отдельном экземпляре. Изменяемые теги образов в примерах нужны для первоначальной оценки; перед постоянной эксплуатацией зафиксируйте проверенный тег выпуска или digest. Запишите текущий digest командой sudo docker image inspect ИМЯ_ОБРАЗА --format '{{json .RepoDigests}}'. Не запускайте автоматические обновления без проверки совместимости и не удаляйте тома командой down -v.
Если приложение не запускается, проверьте sudo docker compose ps, последние журналы, свободное место и память. Не публикуйте журналы с ключами, содержимым запросов или персональными данными. При ошибке доступа к каталогу проверьте UID/GID и владельца, а не назначайте права 777. Для совместного доступа сначала настройте HTTPS, аутентификацию и ограничения запросов.