介绍
栖梧(Qiwu,项目名 qiwu-vue-admin)是一个 Node 全栈的管理后台模板。它提供企业后台常用的基础能力,包括登录、单点登录、权限、组织架构、字典、日志、监控、定时任务、消息、文件、代码生成和审批流程。你只需要在上面写自己的业务。

想知道我为什么做这个项目,见项目由来。
当前状态
v1.16.0 新增员工聊天、语音消息和前台音视频,PC Web 与 App/H5 共用聊天;实时通话通过可配置的自托管 LiveKit,群通话含本人最多 8 人。APP_IM 默认关闭,im.call.enabled 默认关闭。App 增加长期会话和单 App 会话规则。变化与升级步骤见 v1.16.0 更新日志 · 公开源码提交。 正式发布:v1.16.0。
本版发布自有源码、依赖坐标与接入说明,不附第三方 SDK 二进制或已签名安装包。插件编译和模拟器测试已有记录;真实 LiveKit/TURN、宿主签名安装及 Android/iPhone 硬件媒体仍未验收。Android 一项传递依赖的分发许可仍待澄清,详见App 要求。小程序聊天和 App 离线推送未实施。
当前公开组合提供基础 OA 申请与审批,包括请假、出差、报销、用印、通用申请及所需附件、通知和基本移动办理。原生考勤和 OA 助手代申请曾在 v1.10.0 公开,但不在当前 v1.16.0 组合中;历史说明与旧标签保留。会议、知识、物资等完整办公业务不属于当前公开版本。
栖梧按 MIT 协议开源。登录、权限、多租户、代码生成、工作流、消息、文件、通用助手等能力见下表;移动端可本机构建和调试,真实设备、应用商店、SMTP 与 S3 仍需部署方验收。版本历史见更新日志。
在线演示
无需安装环境,可以直接访问在线演示。
演示站打开了多租户:一套系统同时服务多家公司,每一家叫一个租户,各家的数据互相看不到。所以登录页多了一个“租户编码”输入框,用来说明你要登录哪家公司。用平台账号(运营这套系统的一方使用的账号)登录时,租户编码留空:
| 登录信息 | 内容 |
|---|---|
| 租户编码 | 留空 |
| 账号 | admin |
| 密码 | admin@123 |

想看看一家公司登录后看到的样子,可以用两个示例租户登录。每个租户有一个套餐,规定这个租户能用哪些功能:
| 示例租户 | 租户编码 | 账号 | 密码 |
|---|---|---|---|
| 云杉科技(示例):品牌名“云杉协同”,套餐包含租户能用的全部功能 | yunshan | admin | KnjUB2fTabw2wnxL |
| 青禾商贸(示例):品牌名“青禾办公”,套餐里没有流程审批 | qinghe | admin | KnjUB2fTabw2wnxL |
用平台账号登录后,在 系统管理 → 租户管理 里点某个租户的“进入”,填写原因,再点“进入租户”,就能以平台人员的身份查看这个租户。进入期间,页面顶部会一直显示一条横幅,提醒你正在操作别的租户;点横幅上的“退出租户”就回到平台。
登录时会显示滑块验证码,把拼图块拖到缺口的位置即可。
演示模式
访客可以浏览全部功能。除登录、退出、切换语言、保存表格列设置、标为已读、进入和退出租户等少数操作外,写入操作都会被拒绝,并提示“演示模式下不能执行此操作”。访客的 IP 和 User-Agent(UA)会脱敏展示。请勿输入真实个人信息。
源码仓库:732124645/qiwu-vue-admin。想在本机运行并修改代码,见快速开始。
适合谁用
- 学生和编程新手:从安装环境、终端用法讲起,一步步带你做出第一个功能模块。有专门的从零开始教程。
- 想做全栈的前端开发者:会 Vue 就能上手,后端同样使用 TypeScript,不需要再学一门语言。有专门的后端入门。
- 从 Java 转到 Node 的后端开发者:功能和 RuoYi 这类后台对应,概念一看就懂。有专门的对照文档。
- 全栈小团队和外包工作室:一个仓库交付整套后台,前后端共用类型和校验规则。
- 独立开发者:做 SaaS 或内部工具时,直接拿它当后台底座。
技术栈
| 部分 | 选型 |
|---|---|
| 后端 | NestJS 12(ESM)、TypeORM、MySQL 8.4、Redis 7+、Socket.IO |
| 前端 | Vue 3.5、Vite 8、Element Plus、Pinia、vue-i18n |
| 共享 | @qiwu/shared:zod 校验规则、类型、错误码、权限常量 |
| 工程 | pnpm workspace、TypeScript 6、Vitest、Playwright、oxlint + ESLint |
和 Java 后台模板有什么不同
功能范围参考了 RuoYi 和芋道的 system/infra 部分。表名、接口、权限写法、字典编码和界面文字都不相同,接口协议也不兼容。
主要区别在于:
- 一种语言:前后端都是 TypeScript,同一个 zod 规则同时用于后端校验、前端表单和接口文档。
- 更严格的默认安全:数据范围越界统一返回 404,不泄露记录是否存在;防越权授予、密钥加密存储、上传文件按内容识别类型等措施默认开启。详见安全基线。
- 原生国际化:从第一行代码起,所有文案都通过翻译键输出,不是事后补充的。
- Node 生态的取舍:Java 专属的功能(比如 Druid 监控、JVM 面板)换成了对应的替代品,例如 MySQL 状态卡和 Node 运行时面板。
功能一览
✅ 已完成 🚧 开发中 ⏸ 以后再做
每个功能的详细介绍见功能总览。
系统管理
| 功能 | 状态 |
|---|---|
| 用户(部门树筛选、导入导出、重置密码、分配角色) | ✅ |
| 角色(菜单授权、数据范围、分配用户、防越权授予) | ✅ |
| 菜单(目录/页面/操作三种类型,"操作"即按钮权限;外链、内嵌页面、缓存) | ✅ |
| 部门、岗位 | ✅ |
| 字典、参数设置 | ✅ |
| 通知公告(富文本、铃铛提醒、已读统计) | ✅ |
| 个人中心(资料、改密、头像裁剪、手机号换绑、访问令牌) | ✅ |
| App 版本(登记移动端 App 的热更新包和整包,App 启动时提示更新) | ✅ |
安全与审计
| 功能 | 状态 |
|---|---|
| 账号密码登录、短信登录、注册(默认关闭)、短信找回密码 | ✅ |
| 图形验证码 / 滑块验证码 | ✅ |
| 登录失败锁定、IP 黑名单、首次登录强制改密、密码过期 | ✅ |
| 微信小程序登录、账号绑定(默认关闭) | ✅ |
| 在线用户、强制下线(对方实时掉线) | ✅ |
| 操作日志、登录日志、API 访问日志、API 错误日志 | ✅ |
| 演示模式(只读) | ✅ |
系统工具与监控
| 功能 | 状态 |
|---|---|
| 代码生成(单表 / 树表 / 主子表,页面与命令行两种方式,可以同时生成移动端页面) | ✅ |
| 用 AI 开发(一份开发规则供各种 AI 编程工具读取、项目自己的规则文件、十个任务配方、自动生成的项目地图、检查报错带改法) | ✅ |
| 定时任务(可视化 Cron、错过策略、重试、超时、执行日志) | ✅ |
| 文件存储(本地 / S3 兼容、浏览器直传、私有文件鉴权下载) | ✅ |
| 站内信、邮件、短信(阿里云 / 腾讯云) | ✅ |
| 服务器、MySQL、Redis 监控,缓存管理 | ✅ |
| 任务队列(用已有的 Redis,任务在添加它的租户里执行,失败自动重试),队列监控 | ✅ |
| 地区树、IP 归属地 | ✅ |
| 接口文档(Swagger) | ✅ |
| 表单设计器(人员、部门、字典、附件、地区组件,自动算天数和明细合计,导出 JSON 和 Vue 代码) | ✅ |
工作流
| 功能 | 状态 |
|---|---|
| 流程引擎(会签 / 或签 / 依次、并行与条件分支、退回、转办、加签、撤回、超时提醒) | ✅ |
| 审批中心(待办、已办、我的发起、抄送我的、催办、打印) | ✅ |
| OA 办公(请假、出差、报销、用印和通用申请;共用审批中心、私有附件、通知与基本手机办理) | ✅ |
| 打卡考勤(v1.10.0 历史能力,不含在当前公开组合) | 历史版本 |
| 流程设计器(仿钉钉树形,发布前检查并定位出错节点) | ✅ |
BPMN 设计器(标准流程图画法,发布时转换为树形运行;导入导出 .bpmn、实例详情只读流程图) | ✅ |
| 超时自动处理(到期后自动通过、自动驳回或转给上级) | ✅ |
| 流程模型管理(分类、版本、JSON 导出导入)、进度树 | ✅ |
| 动态表单审批(字段权限、表单中的人作审批人、私有附件) | ✅ |
| 零代码审批(新建审批向导,内置通用审批、请假、报销、加班模板) | ✅ |
| 审批数据(按表单字段筛选、导出 Excel) | ✅ |
其他
| 功能 | 状态 |
|---|---|
| 三种布局、多标签页、暗色模式、浅色 / 深色侧栏、锁屏、用户名水印、中英文切换 | ✅ |
| 多实例部署(跨实例实时推送、Redis 共享限流) | ✅ |
| 服务器部署套件(每个版本一个目录、PM2 集群逐个重启、健康检查、失败自动切回上一版本的代码)和 GitHub Actions 自动检查、自动发布 | ✅ |
| 新项目初始化脚本(独立的数据库、Redis 库号、密钥和系统名称) | ✅ |
| OAuth2 授权服务 / 单点登录(授权码 + PKCE,其他系统用这里的账号登录;客户端管理、授权同意页、记住授权) | ✅ |
| 多租户(一套部署服务多家公司,共用一个数据库、按租户隔离数据;租户管理、租户套餐、绑定域名、品牌,平台人员进入租户排查问题;默认关闭) | ✅ |
| 微信公众号(多账号接入、消息与会话、自动回复、自定义菜单、粉丝与标签、素材、模板消息、渠道二维码;图文草稿、发表、群发、数据统计、留言、订阅通知需要已认证的服务号,目前只在模拟环境里验证过;默认关闭) | ✅ |
| MCP 智能体接入(智能体以用户本人的权限调用后台工具;个人访问令牌或 OAuth2、急停、限流、按工具停用、操作日志;默认关闭) | ✅ |
| 智能助手(右侧悬浮聊天:积分费率和真实用量明细、接入兼容 OpenAI 接口的模型,联网搜索、外部 MCP 服务器、技能,默认在改数据前由人确认,可对列表选中的记录批量执行;自动化、配置方案、记忆、自动审查、深度研究和图表;默认关闭) | ✅ |
| 移动端(uni-app:微信小程序、安卓、iOS;登录、工作台、消息、审批(含动态表单)、实时推送、微信订阅消息提醒、App 更新检查已完成,支持浅色和深色主题;发布前的真机核对还在进行) | 🚧 |
| 其他第三方登录(GitHub、钉钉、企业微信、飞书、微信扫码等) | ⏸ |
| 员工聊天与通话(私聊、群聊、通讯录、文字/图片/文件/表情/语音;前台最多 8 人音视频) | 源码与工程验证完成;真实媒体、真机及原生分发条件另验 |
| 小程序聊天、App 离线推送和后台来电 | ⏸ |

免责声明
本项目按 MIT 许可"按原样"提供,不提供任何担保。用它做什么由使用者自行决定并承担责任,不得用于违法违规用途。完整内容见免责声明。
参与贡献
栖梧是开源项目,欢迎参与。按你想做的事找入口:
| 想做什么 | 去哪里 |
|---|---|
| 提问,交流用法和想法 | 讨论区(Discussions) |
| 报告缺陷,提出功能建议 | 问题(Issues),请用问题模板,写明版本、环境和复现步骤 |
| 提交代码,或改进模板仓库里的文档 | 先读贡献指南,再发起合并请求(PR);较大的改动请先在讨论区或问题里商量方案 |
| 报告安全漏洞 | 不要公开提交,按报告安全漏洞里的步骤私密报告 |
| 指出本文档站的错误 | 点页面底部的"在 GitHub 上编辑此页",或在页面下方的评论区留言 |