ZR.Admin.NET 安装和配置指南
1. 项目基础介绍和主要编程语言
项目基础介绍
ZR.Admin.NET 是一款前后端分离的、跨平台基于 RBAC(基于角色的访问控制)的通用权限管理后台。该项目旨在提供一个快速开发框架,帮助开发者轻松构建 Web 管理系统。
主要编程语言
- 后端:C#(基于 .NET 8)
- 前端:Vue.js(Vue 2.x 和 Vue 3.x)
2. 项目使用的关键技术和框架
后端技术
- 核心框架:.NET 8 + Web API
- ORM:SqlSugar
- 安全支持:过滤器、Sql 注入、请求伪造
- 日志管理:NLog
- 定时任务:Quartz.NET
- 缓存:Redis
- 接口限流:IpRateLimit
- 代码生成:支持一键生成前后端代码
前端技术
- 框架:Vue 2.x/Vue 3.x
- UI 库:Ant Design Vue
- 状态管理:Vuex
- 路由管理:Vue-Router
- 国际化:i18n
3. 项目安装和配置的准备工作和详细安装步骤
准备工作
- 安装 .NET SDK:确保你的开发环境已经安装了 .NET 8 SDK。你可以从 .NET 官方网站 下载并安装。
- 安装 Node.js:前端开发需要 Node.js 环境。你可以从 Node.js 官方网站 下载并安装。
- 安装数据库:项目使用 SqlSugar 作为 ORM,支持多种数据库。你可以选择安装 SQL Server、MySQL 或其他支持的数据库。
- 安装 Redis:项目使用 Redis 作为缓存服务。你可以从 Redis 官方网站 下载并安装。
详细安装步骤
后端安装
-
克隆项目:
git clone https://github.com/izhaorui/Zr.Admin.NET.git cd Zr.Admin.NET
-
还原依赖包:
dotnet restore
-
配置数据库连接字符串: 打开
appsettings.json
文件,找到ConnectionStrings
部分,配置你的数据库连接字符串。 -
运行数据库迁移:
dotnet ef database update
-
启动项目:
dotnet run
前端安装
-
进入前端目录:
cd Zr.Admin.NET/Zr.Vue
-
安装依赖:
npm install
-
启动前端项目:
npm run serve
配置
-
配置 Redis: 在
appsettings.json
中找到Redis
配置部分,配置你的 Redis 连接信息。 -
配置国际化: 前端项目支持国际化,你可以在
src/i18n
目录下添加或修改语言文件。 -
配置定时任务: 在
Zr.Tasks
目录下配置你的定时任务,使用 Quartz.NET 进行调度。
运行项目
-
后端: 确保后端项目已经启动,默认端口为
5000
。 -
前端: 确保前端项目已经启动,默认端口为
8080
。 -
访问项目: 打开浏览器,访问
http://localhost:8080
,即可看到项目运行界面。
通过以上步骤,你已经成功安装并配置了 ZR.Admin.NET 项目。现在你可以开始开发你的 Web 管理系统了!