Nest Vue Admin

Appearance

快速开始 ​

只需三步，即可在本地启动 Nest Vue Admin。

环境要求 ​

  • Node.js: >= 20.x
  • pnpm: 推荐使用最新版本
  • 数据库: MySQL >= 5.7.44

1. 克隆项目 ​

bash
git clone https://github.com/weips001/nest-vue-admin.git
cd nest-vue-admin
pnpm i

2. 配置数据库 ​

2.1 修改数据库连接 ​

找到 apps/server/.env.example 文件，复制为 .env，并修改 DATABASE_URL：

bash
DATABASE_URL="mysql://root:Aa123456@127.0.0.1:3306/nest-vue-admin?connection_limit=20&pool_timeout=0"

参数说明：

参数示例值说明
用户名root数据库用户名
密码Aa123456数据库密码
地址:端口127.0.0.1:3306数据库地址
数据库名nest-vue-admin数据库名称

验证连接

使用 Navicat、DBeaver 等工具尝试连接该配置，确认数据库可访问。

2.2 同步数据库表结构 ​

bash
cd apps/server

# 生成物理表
pnpm run db:m

# 初始化数据
pnpm run seed

验证数据

刷新数据库工具，确认已生成 SysUser、SysRole、SysMenu 等业务表，且 sys_user 等表中有初始数据。

3. 启动项目 ​

3.1 启动后端 ​

bash
cd apps/server
pnpm run start

后端服务将在 http://localhost:3000 启动，Swagger 文档地址为 http://localhost:3000/api-docs。

3.2 启动前端 ​

bash
cd apps/web
pnpm run start

前端服务将在 http://localhost:5173 启动。

登录系统 ​

打开浏览器访问 http://localhost:5173，使用默认账号：

  • 用户名: admin
  • 密码: 123456

常见问题 ​

后端启动失败？ ​

  1. 检查 .env 中的数据库连接配置
  2. 确认 MySQL 服务已启动
  3. 确认已执行 pnpm run db:m 和 pnpm run seed

前端无法连接后端？ ​

  1. 确认后端服务正在运行
  2. 检查前端的 API 代理配置

如何修改管理员密码？ ​

登录后在「个人中心」修改，或在「用户管理」中重置。