Flowise 可通过可视化方式连接模型调用、检索和应用逻辑。先建立用于起草或分类的简单提示词到回答流程,文本路径可靠后再添加工具执行。本例使用当前邮箱/密码管理员流程,而非已弃用的基本用户名环境变量。
目标环境: Ubuntu Server 24.04 LTS、x86-64、SSH 和 sudo 账户。文档审核日期:2026 年 11 月 15 日。命令尚未在 Ubuntu 上完成端到端测试。
开始之前
使用外部推理时,可规划约 2–4 个 vCPU、4 GB 内存和 15 GB 可用磁盘。更多文档解析、工作进程或本地推理需要更多资源。外部服务商需要您的凭据和用量预算,流程编辑器不包含模型算力。
这些资源数值仅为小规模评估的规划估算,不是性能保证或套餐规格。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 不会改变宿主机端口仅绑定回环地址的事实。
以下项目均为全新安装。不要对现有部署重新执行密钥生成步骤。
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. 私下初始化所有者
运行服务并从本机连接。打开与 APP_URL 一致的 http://localhost:3000,创建管理员。如其他应用已使用本地 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,为单一任务设计提示词,例如对示例支持请求分类。通过凭据库添加服务商凭据,保存并在编辑器测试。首次测试不要连接公司数据库或 shell 工具。菜单和节点名称可能随版本变化,应选择匹配所配置服务商的节点。
4. 保护预测端点
编辑器登录与流程 API 访问是独立控制。公开预测端点前先为流程指定 API 密钥,并从后端调用,不要将密钥放在浏览器代码中。保持编辑器私有。将 data 与 .env 一起备份,也导出流程定义,但不要认为导出包含全部密钥或数据库记录。连接自动触发器前,请设置服务商开销限制。
更新与恢复
升级前停止应用以制作一致性备份,将数据和密钥保留在 VPS 之外,并在独立实例测试恢复。示例中的浮动镜像标签用于初期评估;长期使用前请固定已审核的版本或摘要。可通过 sudo docker image inspect IMAGE_NAME --format '{{json .RepoDigests}}' 记录当前摘要。不要在未检查兼容性时无人值守升级,也不要用 down -v 删除持久卷。
启动失败时,请检查 sudo docker compose ps、近期日志、剩余磁盘和内存。不要分享包含密钥、提示词或个人数据的日志。目录权限出错时,应核对预期 UID/GID 与所有权,不要授予 777。共享访问前请配置 HTTPS、认证和请求限制。