# youlai-nest
**Repository Path**: posqianmo/youlai-nest
## Basic Information
- **Project Name**: youlai-nest
- **Description**: 基于 Node、Nest 11、TypeScript、MongoDB、Vue 3 和 Element-Plus 构建的前后端分离权限管理系统，适合想入门全栈开发的前端人员。项目持续优化更新中。有问题可以加群有人解答问题
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://vue.youlai.tech/template
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 56
- **Created**: 2026-01-06
- **Last Updated**: 2026-01-21
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
## 📢 项目简介
**在线预览**: [https://vue.youlai.tech](https://vue.youlai.tech)
基于 Node.js（>= 20）、NestJS、MySQL、JWT、Redis、阿里云oss、Vue 3、Element-Plus 构建的前后端分离单体权限管理系统。
- **🚀 开发框架**: 使用 nest.js 和 Vue 3，以及 Element-Plus 等主流技术栈，实时更新。
- **🔐 安全认证**: 结合 NestJS 的自定义 AuthGuard 和 JWT，提供安全、无状态、分布式友好的身份验证和授权机制。
- **🔑 权限管理**: 基于 RBAC 模型，实现细粒度的权限控制，涵盖接口方法和按钮级别。
- **🛠️ 功能模块**: 包括用户管理、角色管理、菜单管理、部门管理、字典管理等多个功能。
- **📘 接口文档**: 自动生成接口文档，支持在线调试，提高开发效率。
## 🌈 项目源码
| 项目类型 | Gitee | Github | GitCode |
| -------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| ✅ Node 后端 | [youlai-nest](https://gitee.com/youlaiorg/youlai-nest) | [youlai-nest](https://github.com/youlaitech/youlai-nest) | [youlai-nest](https://gitcode.com/youlai/youlai-nest) |
| vue3 前端 | [vue3-element-template](https://gitee.com/youlaiorg/vue3-element-template) | [vue3-element-template](https://github.com/youlaitech/vue3-element-template) | [vue3-element-template](https://gitcode.com/youlai/vue3-element-template) |
| uni-app 移动端 | [vue-uniapp-template](https://gitee.com/youlaiorg/vue-uniapp-template) | [vue-uniapp-template](https://github.com/youlaitech/vue-uniapp-template) | [vue-uniapp-template](https://gitcode.com/youlai/vue-uniapp-template) |
## 📚 项目文档
| 文档名称 | 访问地址 |
| ------------------ | -------------------------------------------------------------------------------------------------------- |
| 在线接口文档 | [https://www.apifox.cn/apidoc](https://www.apifox.cn/apidoc/shared-195e783f-4d85-4235-a038-eec696de4ea5) |
| 项目介绍与使用指南 | [https://www.youlai.tech/youlai-nest/](https://www.youlai.tech/youlai-nest/) |
## ⚙️ 环境准备
### 1️⃣ 基础环境
- **Node.js**：20.x / 24.x LTS 下载：https://nodejs.org/zh-cn/download
> NestJS 11 已不再支持 Node 16 / 18
> https://docs.nestjs.com/migration-guide#nodejs-v16-and-v18-no-longer-supported
- **包管理器**：pnpm（>= 8）
- **开发工具**：VS Code / WebStorm
- **VS Code 插件**（推荐）：
- ESLint
- Prettier - Code formatter
- EditorConfig for VS Code
验证环境是否就绪：
```bash
node -v
pnpm -v
```
### 2️⃣ 依赖服务
▸ MySQL 5.7~8.x：业务数据存储（用户/角色/权限），安装：[Windows](https://youlai.blog.csdn.net/article/details/133272887) | [Linux](https://youlai.blog.csdn.net/article/details/130398179)
▸ Redis 稳定版：登录会话/验证码/数据缓存，安装：[Windows](https://youlai.blog.csdn.net/article/details/133410293) | [Linux](https://youlai.blog.csdn.net/article/details/130439335)
> ⚠️ 本地未配置 MySQL、Redis 不影响启动，项目默认接入 youlai 线上公共环境运行。
### 3️⃣ 初始化数据库
执行以下脚本完成数据库初始化：
```text
sql/mysql/youlai_admin.sql
```
> ⚠️ 该步骤为必执行步骤。
## ▶️ 快速启动
```bash
# 克隆代码
git clone https://gitee.com/youlaiorg/youlai-nest.git
# 切换目录
cd youlai-nest
# 安装 pnpm
npm install pnpm -g
# 设置镜像源(可忽略)
pnpm config set registry https://registry.npmmirror.com
# 安装依赖
pnpm install
# 启动运行
pnpm run start:dev
```
访问接口文档地址 [http://localhost:8000/api-docs](http://localhost:8000/api-docs) 验证项目启动是否成功。
## 💖 加交流群
① 关注「有来技术」公众号，点击菜单 **交流群** 获取加群二维码（此举防止广告进群，感谢理解和支持）。
② 直接添加微信 **`haoxianrui`** 备注「前端/后端/全栈」。
