Flowise 本地部署完整指南
Flowise 可视化拖拽 LangChain 工作流，提供3 种部署方案，优先推荐Docker（最省心、环境隔离）；Windows/macOS/Linux 通用。
硬件最低：4G 内存；推荐 ≥8G 内存；默认端口：3000
方案一：Docker 部署【推荐｜新手首选】
优势：不用装 Node，环境隔离、一键启停、数据持久化，适配 Windows Docker Desktop / Mac / Linux。
1）前置准备
Windows / Mac：安装Docker DesktopLinux：安装 Docker Engine
2）基础启动（简易版，无账号密码）
bash
运行
docker run -d \ --name flowise \ --restart unless-stopped \ -p 3000:3000 \ -v $(pwd)/flowise-data:/app/.flowise \ flowiseai/flowise:latest-v挂载目录：持久化保存你的所有工作流，删除容器数据不会丢失- 访问地址：http://localhost:3000
3）安全增强版（设置登录账号，强烈建议）
bash
运行
docker run -d \ --name flowise \ --restart unless-stopped \ -p 3000:3000 \ -v $(pwd)/flowise-data:/app/.flowise \ -e FLOWISE_USERNAME=admin \ -e FLOWISE_PASSWORD=YourStrongPass123 \ -e NODE_OPTIONS="--max-old-space-size=8192" \ flowiseai/flowise:latestWindows PowerShell 兼容命令（Windows 不要直接复制上面 bash 命令）
powershell
docker run -d ` --name flowise ` --restart unless-stopped ` -p 3000:3000 ` -v ${PWD}/flowise-data:/app/.flowise ` -e FLOWISE_USERNAME=admin ` -e FLOWISE_PASSWORD=YourStrongPass123 ` flowiseai/flowise:latest常用 Docker 管理命令
bash
运行
# 停止 docker stop flowise # 重启 docker restart flowise # 查看日志 docker logs -f flowise # 删除容器（挂载目录数据保留） docker rm flowise进阶：docker-compose.yml（便于长期使用）
新建docker-compose.yml
yaml
version: '3.8' services: flowise: image: flowiseai/flowise:latest container_name: flowise restart: unless-stopped ports: - "3000:3000" volumes: - ./flowise-data:/app/.flowise environment: - FLOWISE_USERNAME=admin - FLOWISE_PASSWORD=Admin@123456 - PORT=3000 - NODE_OPTIONS=--max-old-space-size=8192启动：
bash
运行
docker compose up -d⚠️ 连接本机 Ollama 注意： 容器内部
localhost指向容器本身，不能直接访问宿主机 OllamaWindows/Mac 使用host.docker.internal:11434Linux 使用宿主机局域网 IP
方案二：NPM 全局安装（无 Docker，本地 Node 环境）
适合开发者、不想装 Docker 的场景
前置条件
Node.js18.15.0 ~ 20.x LTS（不支持 Node16 及以下）
bash
运行
node -v步骤
- 全局安装
bash
运行
npm install -g flowise- 启动基础命令
bash
运行
flowise start访问：http://localhost:3000
带登录认证、允许局域网访问
bash
运行
# Linux/macOS export FLOWISE_USERNAME=admin export FLOWISE_PASSWORD=Pass123456 flowise start --host 0.0.0.0 --port 3000 # Windows CMD set FLOWISE_USERNAME=admin set FLOWISE_PASSWORD=Pass123456 flowise start --host 0.0.0.0 --port 3000 # Windows PowerShell $env:FLOWISE_USERNAME="admin" $env:FLOWISE_PASSWORD="Pass123456" flowise start --host 0.0.0.0 --port 3000参数说明：
--host 0.0.0.0：允许同一局域网其他设备访问- 默认数据存储路径：
C:\Users\用户名\.flowise（Windows） /~/.flowise（Mac/Linux）
方案三：源码编译部署（二次开发、自定义源码）
bash
运行
# 克隆仓库 git clone https://github.com/FlowiseAI/Flowise.git cd Flowise # 安装pnpm npm i -g pnpm # 安装依赖 pnpm install # 构建 pnpm build # 启动 pnpm start开发热更新：pnpm dev
⚙️ 核心环境变量（通用，Docker/NPM 都生效）
表格
| 环境变量 | 说明 |
|---|---|
| FLOWISE_USERNAME / FLOWISE_PASSWORD | Web 登录账号密码 |
| PORT | 服务端口，默认 3000 |
| HOST | 监听地址，0.0.0.0 开放局域网 |
| DATABASE_TYPE | 默认 sqlite；可选 mysql/postgres |
| NODE_OPTIONS="--max-old-space-size=8192" | 扩大内存限制，大 RAG 必备 |
🛠️ 常见问题
- 3000 端口占用启动时添加
--port 3001修改端口
bash
运行
flowise start --port 3001容器内无法访问本地 OllamaOllama 地址填写： Windows/Mac：
http://host.docker.internal:11434Linux：http://宿主机IP:11434同时 Ollama 启动开启局域网访问OLLAMA_HOST=0.0.0.0 ollama serve工作流重启后丢失Docker 务必挂载 volume；npm 模式不要删除
~/.flowise文件夹内存溢出报错添加环境变量
NODE_OPTIONS="--max-old-space-size=8192"
部署方案选型建议
✅ 普通使用者、快速测试：Docker Compose✅ 本地开发、修改 Flowise 代码：源码 pnpm 部署 ✅ 服务器无 Docker、简单运行：npm 全局安装
如果你需要，我可以直接给你一份「Flowise + Ollama 本地打通」完整配置样例。
