loonflow

拖拽配置审批流，工单自动流转可追踪

loonflow 是一套智能可视化流程自动化系统，面向企业内部的工单、审批与流程编排场景。它把传统需要写代码才能搭建的审批流、工单流，变成可视化配置：管理员在界面上拖拽节点、设置条件分支、指定处理人，即可上线一条业务流程。系统内置工单管理能力，支持流程发起、流转、催办、归档与查询，并可与 DevOps 工具链打通，把发布、变更、故障处理等操作纳入统一流程管控。项目采用 Django + Python 后端与 TypeScript 前端，同时提供 MCP 接口，方便接入 AI 助手或自动化代理，让智能体也能触发和操作流程。核心价值在于降低流程自动化的门槛，把散落在邮件、群聊和表格里的审批动作收敛到一套可追踪、可审计的系统里，适合中小团队快速落地内部流程数字化。

开源 free 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2090

维护状态较活跃

是否开源是

定价模式 free

项目预览

项目数据

分类自动化工作流

开发团队blackholll

所属国家

官网地址

GitHubhttps://github.com/blackholll/loonflow

定价模式free

价格说明开源免费，需自行部署

访问状态

是否开源是

开源协议AGPL-3.0

主要语言TypeScript

技术栈/模型devops,django,mcp,python,ticket,workflow,workflow-engine

GitHub 星标★ 2090

30天Star增速

HF 下载量

上线时间2018-02-08 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-07

浏览次数0

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：Docker 4 步

环境要求

已安装 Docker 与 docker-compose（docker-compose 命令可用）
服务器可访问 raw.githubusercontent.com 下载部署文件
一个用于登录 loonflow 的邮箱与密码（后续在 .env 中设置）
可访问部署机器映射出的 Web 端口（需要浏览器登录验证）

安装与启动步骤

1下载部署文件

在任意目录执行两条 wget，拉取 docker-compose.yml 与 .env 两个文件，确保下载完整、无 HTML 报错内容。

wget https://raw.githubusercontent.com/blackholll/loonflow/refs/heads/master/docker_compose_deploy/docker-compose.yml
wget https://raw.githubusercontent.com/blackholll/loonflow/refs/heads/master/docker_compose_deploy/.env

2修改 .env 配置

按 README 要求至少修改密码部分（以及登录邮箱），用编辑器打开 .env 逐项确认，保存后再启动。
```
vim .env
```
3启动服务

进入 docker-compose.yml 所在目录后执行，后台拉起全部容器；首次启动需拉取镜像，耐心等待。
```
docker-compose up -d
```
4登录访问

在浏览器打开部署机器地址，使用 .env 中设置的邮箱和密码登录 loonflow，进入流程设计界面。

关键配置

配置项	必填	说明	示例
`邮箱`	是	登录 loonflow 使用的账号邮箱，在 .env 中设置	`admin@example.com`
`密码`	是	登录密码，README 明确要求至少修改此项，务必改成强密码	`YourStrongPassword123`

如何确认成功

执行 docker-compose up -d 后容器正常运行，浏览器打开部署地址，用 .env 里的邮箱和密码能成功登录即部署成功。

常见问题

Q：wget 下载 docker-compose.yml 或 .env 失败怎么办？

A：多为网络无法访问 raw.githubusercontent.com 所致，可在能联网的机器下载后上传到部署目录，或配置代理后重试，注意确认文件内容是纯文本而非报错页面。

Q：.env 里的密码可以不改吗？

A：不建议。README 明确要求至少修改密码部分，默认密码存在安全风险，请改成强密码后再启动服务。

Q：docker-compose up -d 提示命令不存在？

A：说明未安装 docker-compose 或版本较新只带 compose 插件，可改用 docker compose up -d，或先安装 docker-compose 再重试。

Q：启动后浏览器打不开页面？

A：先执行 docker-compose ps 或 docker-compose logs 查看容器状态与报错；若是云服务器，检查安全组/防火墙是否放行对应端口。

注意事项

必须先修改 .env（至少密码）再执行 docker-compose up -d，避免用默认密码上线。
本教程步骤完全来自 README 的安装部署章节，README 未给出具体端口、环境变量清单等细节，如需调整请查看 docker-compose.yml 与 .env 内注释。
README 还提到官方托管 SaaS 版 loonflow.com，提供两周免费试用，不想自建可选择该方式。

核心亮点

可视化流程设计器，拖拽节点和条件分支即可上线流程，无需写代码
内置工单全生命周期管理，发起、流转、催办、归档、查询一站式覆盖
提供 MCP 接口，可被 AI 助手或自动化代理调用，便于接入智能体场景

不足之处

项目定位偏企业内部流程，复杂跨系统编排能力相比专业 BPM 引擎仍有差距
社区与生态规模相对有限，插件和第三方集成丰富度有待观察

适用场景

企业内部请假、报销、采购等审批工单流程搭建
IT 运维变更、发布、故障处理流程的标准化与留痕
接入 AI 助手，让智能体自动发起和推进业务流程

替代项目

Activiti、Flowable

项目介绍

loonflow 是自动化工作流领域的开源项目，由 blackholll 开发，2018 年首次发布。

在全站 13,821 个收录项目中，它的 GitHub 星标数（2,090）位列前 30%，在自动化工作流分类中处于中上游。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-20。开源免费，需自行部署。

它主要面向的使用场景是：企业内部请假、报销、采购等审批工单流程搭建。同类可对比的替代方案包括 Activiti、Flowable。

上一篇：excalidraw-cli

下一篇：workflowbuilder