Flowise：拖拽式 LLM Agent 编排平台（仓库已归档）｜部署与使用全指南

仓库：https://github.com/FlowiseAI/Flowise 官方文档：https://docs.flowiseai.com/ 许可证：Apache License 2.0 默认端口：3000 ⚠️ 官方状态：仓库已归档，详见 https://github.com/FlowiseAI/Flowise/discussions/6727

1. 项目简介

Flowise 是一个可视化拖拽搭建 LLM / Agent 工作流的开源平台。用户在画布上连接节点（模型、向量库、工具、输出），即可发布成 API 或聊天窗口。仓库是 monorepo，包含 server（Node 后端）、ui（React 前端）、components（第三方节点集成）、api-documentation 四个模块。

1.1 核心信息一览

1.2 适用场景

• 想不写代码就能拼出 RAG / Agent 工作流；
• 想把工作流一键发布为 API 或嵌入聊天窗口；
• 适合做内部原型验证、教学演示。

1.3 能力边界（官方口径）

• ⚠️ README 顶部已明确："Flowise has been archived. Refer to Future of Flowise"——仓库不再接受新功能维护，未来走向见 Discussion 6727；
• 生产部署前请先评估归档风险，关注官方后续分支或 fork；
• 自托管需自备各模型 Provider 的 API Key。

2. 功能特性

• 可视化拖拽画布：连接模型、向量库、工具、输出节点；
• 多模块 monorepo：server / ui / components / api-documentation；
• 多部署方式：npm、Docker、Compose、AWS / Azure / GCP / DigitalOcean / 阿里云 / Railway / Render / HF Spaces / Sealos 等；
• 环境变量驱动：在 packages/server/.env 中配置；
• 自动生成 Swagger API 文档。

3. 官方界面预览

官方 README 顶部 GIF，展示在画布上拖拽节点编排 Agent Flow 的过程。

4. 官方跳转链接汇总

• 仓库主页：https://github.com/FlowiseAI/Flowise
• 归档说明（Future of Flowise）：https://github.com/FlowiseAI/Flowise/discussions/6727
• 文档：https://docs.flowiseai.com/
• 部署文档：https://docs.flowiseai.com/configuration/deployment
• Discord：https://discord.gg/jbaHfsRVBW
• Flowise Cloud：https://flowiseai.com/

5. 前置要求与服务器配置

• Node.js ≥ 20.0.0（官方 README 明确要求）；
• 全局安装 pnpm（源码开发时）；
• 端口 3000 不被占用；
• 模型 Provider API Key（OpenAI、Anthropic 等）。

6. 方式一：npm 全局安装（最快）

npm install -g flowise
npx flowise start

打开 http://localhost:3000 即可。

7. 方式二：Docker / Compose 部署

Docker Compose：

git clone https://github.com/FlowiseAI/Flowise.git
cd Flowise/docker
cp .env.example .env
docker compose up -d

打开 http://localhost:3000。停止：

docker compose stop

Docker 镜像方式：

# 本地构建
docker build --no-cache -t flowise .
# 运行
docker run -d --name flowise -p 3000:3000 flowise
# 停止
docker stop flowise

8. 源码 / 本地开发

npm i -g pnpm
git clone https://github.com/FlowiseAI/Flowise.git
cd Flowise
pnpm install
pnpm build
pnpm start

访问 http://localhost:3000。开发模式：

# 在 packages/ui/.env 配 VITE_PORT
# 在 packages/server/.env 配 PORT
pnpm dev

代码改动自动热更新，访问 http://localhost:8080。

构建时若遇到 Exit code 134 (JavaScript heap out of memory)，先：

export NODE_OPTIONS="--max-old-space-size=4096"
pnpm build

9. 配置项说明

更多环境变量见仓库 CONTRIBUTING.md 与 docs.flowiseai.com。

10. 常用运维命令

# npm 全局
npx flowise start

# Compose
docker compose up -d
docker compose stop
docker compose logs -f

# Docker 镜像
docker ps --filter name=flowise
docker logs -f flowise
docker restart flowise

# 源码
pnpm install
pnpm build
pnpm start
pnpm dev

11. 常见故障排查

• Node 版本过低：必须 ≥ 20，node -v 检查；
• build 内存溢出：设 NODE_OPTIONS=--max-old-space-size=4096；
• 端口被占：改 PORT 或换宿主机映射端口；
• 模型 401：在 Flowise 画布的节点里填对应 API Key；
• 仓库已归档：关注 Discussion 6727，必要时切到官方后续分支或活跃 fork。

12. 风险与合规说明

• Apache-2.0 许可；
• ⚠️ 官方仓库已归档，生产使用前请评估长期维护风险；
• 模型调用费用由你配置的 Provider 账号承担；
• 本文为社区部署笔记，命令以官方 README 与 docs.flowiseai.com 最新版本为准。