Toonflow 部署与安装指南：一站式AI短剧创作工具

Toonflow 是一个围绕“策划 → 编剧 → 分镜 → 出片”构建完整闭环的AI工作台。它集成了AI编剧、智能分镜、角色生成与视频生成等功能，支持无限画布生产工作台、三层Agent协作体系和持久化记忆。本指南将覆盖桌面端安装、Docker部署、云服务器部署以及在智星云等算力平台上的镜像部署。

1. 系统要求与准备

1.1 硬件要求

• 最低配置：4GB内存，20GB可用磁盘空间。
• 推荐配置：8GB+内存，50GB+可用磁盘空间，建议配备NVIDIA GPU（用于加速本地推理）。

1.2 软件前提

• 操作系统：Windows、macOS 或 Linux。
• AI服务：需要准备以下AI服务的API接口：
  • 大语言模型（LLM）服务地址（如OpenAI、DeepSeek等）。
  • 视频生成服务地址（如Sora、豆包、Seedance等）。
  • 图像生成服务地址（如Nano Banana Pro、FLUX等）。
• （可选）Docker：用于容器化部署。
• （可选）Node.js 24.x、Yarn、PM2：用于云服务器手动部署。

2. 桌面端安装（推荐普通用户）

这是最直接、适合个人创作者的方式。

2.1 下载安装包

1. 访问项目的 GitHub Releases 页面。
2. 根据您的操作系统下载对应的安装包：
   • Windows：下载 .exe 安装程序。
   • macOS：下载 .dmg 文件。
   • Linux：下载 .AppImage 或 .deb 包。

2.2 安装与首次启动

• Windows：双击 .exe 文件，按向导完成安装。
• macOS：
  1. 打开 .dmg，将 Toonflow.app 拖入 Applications 文件夹。
  2. 如果提示“无法验证开发者”，请前往 系统设置 > 隐私与安全性，点击 “仍要打开”。
• Linux：赋予 .AppImage 执行权限并运行：chmod +x Toonflow.AppImage && ./Toonflow.AppImage。

2.3 首次登录与配置

1. 启动应用后，使用默认账号登录：
   • 账号：admin
   • 密码：admin123（建议登录后立即修改）
2. 进入 设置中心，配置您的AI供应商：
   • 文本模型：填写LLM的API Key和接口地址。
   • 图像模型：填写图像生成服务的API信息。
   • 视频模型：填写视频生成服务的API信息。
3. 配置完成后，即可开始创建项目。

3. Docker 部署（适合服务器或个人开发者）

Docker方式可以快速在服务器上部署Toonflow的Web服务版。

3.1 前置条件

• 已安装 Docker（版本20.10+）和 Docker Compose（可选）。

3.2 本地构建并运行

1
2
3
4
5
6
7
8
9
10

# 克隆项目
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app

# 使用 docker-compose 本地构建并启动（推荐）
yarn docker:local

# 或者手动构建并运行
docker build -t toonflow .
docker run -d -p 10588:10588 -v $(pwd)/data:/app/data toonflow

3.3 访问服务

启动成功后，在浏览器中访问：http://localhost:10588/web/index.html（注意路径包含 /web/index.html）。

4. 云服务器部署（生产环境）

适合需要长期稳定运行、对外提供服务的场景。

4.1 服务器环境准备

• 操作系统：Ubuntu 20.04+ / CentOS 7+
• Node.js：24.x（推荐，最低 23.11.1+）
• 内存：2GB+
• PM2：用于进程守护

4.2 安装依赖环境

1
2
3
4
5
6
7

# 安装 Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 24

# 安装 Yarn 和 PM2
npm install -g yarn pm2

4.3 部署项目代码

1
2
3
4
5
6
7
8
9

cd /opt

# 从 GitHub 克隆（或使用 Gitee 国内镜像）
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
# 或 git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git

cd Toonflow-app
yarn install
yarn build

4.4 配置 PM2 进程管理

在项目根目录创建 pm2.json 文件：

1
2
3
4
5
6
7
8
9
10
11

{
  "name": "toonflow-app",
  "script": "data/serve/app.js",
  "instances": "max",
  "exec_mode": "cluster",
  "env": {
    "NODE_ENV": "prod",
    "PORT": 10588,
    "OSSURL": "http://127.0.0.1:10588/"
  }
}

4.5 启动并保存服务

1
2
3

pm2 start pm2.json
pm2 startup
pm2 save

服务将运行在 http://你的服务器IP:10588/web/index.html。

5. 智星云平台镜像部署（开箱即用）

Toonflow已与智星云合作，提供预装好的商用镜像，适合无需手动配置环境的用户。

1. 租用GPU实例：在智星云平台选择 windows10LTSCwin10_Toonflow 镜像，创建实例。
2. 远程桌面连接：通过RDP登录到云端Windows桌面。
3. 启动Toonflow：桌面上已有Toonflow程序，双击启动。
4. 配置模型服务（关键）：
   • 在Toonflow的“模型服务”中，使用智星云提供的Token服务地址：https://token.ai-galaxy.com/v1。
   • 在智星云“Token市场”充值并创建API Key，粘贴到Toonflow中。
   • 选择模型（如 deepseek-v4-pro）并确认。
5. 启动ComfyUI：云端桌面上的“绘世启动器”用于启动ComfyUI（用于图像/视频生成），保持其运行状态。

6. 从源码开发（面向开发者）

如需二次开发，请参考以下步骤。

6.1 克隆并安装依赖

1
2
3

git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn install

6.2 启动开发环境

• 仅启动后端API服务（无前端界面）：

  1

  yarn dev

  访问 http://localhost:10588 仅能调用API。

• 启动Electron桌面客户端（推荐开发者完整体验）：

  1	yarn dev:gui

  这会同时启动后端和Electron窗口。

• 生产模式启动（需先构建）：

  1 2	yarn build yarn start

6.3 打包桌面应用

1
2
3

yarn dist:win    # Windows
yarn dist:mac    # macOS
yarn dist:linux  # Linux

7. 常见问题排查

8. 总结

Toonflow 提供了从桌面到云端的多种部署方式，适应不同用户的需求。

核心部署路径：

1. 个人创作者：下载桌面端安装包 → 安装并登录 → 配置AI模型 → 开始创作。
2. 服务端部署：使用Docker快速拉起，或在云服务器上手动部署（Node.js + PM2）。
3. 零配置体验：通过智星云镜像直接使用预装环境，无需手动安装依赖。

无论选择哪种方式，配置正确的AI模型服务（LLM、图像、视频）是启动后最关键的一步。建议从桌面端开始体验完整功能，再根据需求决定是否迁移到服务器版本。

项目地址：https://github.com/HBAI-Ltd/Toonflow-app