客户中心
网站
简体中文
← 知识库

在 VPS 上部署 Flowise,可视化构建 AI 工作流

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、认证和请求限制。

相关部署