tongflow

环境要求

• 已安装 Docker（使用 Compose 方式还需 docker compose）
• 首次安装插件需能访问 GitHub 与 PyPI 的网络
• 使用示例工作流需注册 Modal 账号并获取 Token
• 若改用源码运行，需 Node + pnpm 以及 PATH 中的 Python 3.10+

安装与启动步骤

1. 1启动容器

   一条命令拉起自托管镜像，数据与插件目录挂载到命名卷，端口仅绑定本机 127.0.0.1

   docker run -d -p 127.0.0.1:3000:3000 
     -v tongflow-data:/data -v tongflow-plugins:/plugins 
     ghcr.io/tong-io/tongflow:latest

   复制

2. 2获取登录链接

   容器启动后会把带 token 的登录链接打印到日志，首次打开用它完成登录

   docker logs $(docker ps -lq)

   复制

3. 3打开画布

   浏览器访问日志中的地址即可看到可视化画布，自托管环境会预载一个示例工作流

4. 4填写模型密钥

   可选。在应用内 Settings 对话框填 API Key，或启动时用 -e 传入；不填也能先打开界面

   docker run -d -p 127.0.0.1:3000:3000 
     -v tongflow-data:/data -v tongflow-plugins:/plugins 
     -e OPENROUTER_API_KEY=sk-xxxxxxxx 
     ghcr.io/tong-io/tongflow:latest

   复制

5. 5安装插件

   镜像不含插件，点右上角方块图标打开插件管理器安装，装完立即可用无需重启

6. 6装示例所需插件

   跑预载示例（文→图→融合→视频）需装 tongflow-modal-z-image、qwen-image-edit、minimax-h3 三个插件

7. 7运行示例工作流

   逐节点运行，或切到 Execute Mode 点运行按钮一键跑完整条流程

关键配置

如何确认成功

浏览器打开日志中 http://localhost:3000/?token=… 链接，能加载出画布并看到预载示例工作流即成功。

常见问题

注意事项

• 所有可写数据（SQLite 数据库、上传文件、设置）都在 /data 卷中，重建容器前注意备份该卷。
• 镜像本身不含任何插件，插件需从应用内插件管理器安装，且首次安装依赖网络。
• 使用 Modal 系插件除了 Token 外还需 Modal 账号（每月含最高约 30 美元免费 GPU 额度）。
• 项目采用 AGPL-3.0 许可证，商用或二次分发前请确认合规要求。