NetAdmin

通用后台权限管理系统、快速开发框架（基于C#12/.NET9、Vue3/Vite、Element Plus等现代技术构建，具有十分整洁、优雅的编码规范）

在线预览

http://na.yaopy.com （演示站点仅300kbps带宽，访问较慢）

一键运行

docker run -p 8080:8080 nsnail/netadmin

构建步骤

# 1. 检查 dotnet sdk 版本 >=9.0.0
dotnet --list-sdks
# 下载 dotnet：https://dotnet.microsoft.com/zh-cn/download/dotnet

# 2. 克隆代码仓库
git clone https://github.com/nsnail/NetAdmin.git && cd ./NetAdmin

# 3. 检查本机 redis 运行状态
redis-cli dbsize
# 下载 redis for windows：https://github.com/redis-windows/redis-windows/releases
# 下载 redis for linux/mac：https://redis.io/download

# 4. 运行后端 WebApi
dotnet run --project ./src/backend/NetAdmin.AdmServer.Host/NetAdmin.AdmServer.Host.csproj --urls http://[::]:5010 -is
# 浏览器打开 http://localhost:5010 ，将看到Swagger（Knife4jUI）界面

# 5. 检查 nodejs 版本 >=20
node -v
# 下载 nodejs：https://nodejs.org/en/download

# 6. 安装 npm 依赖包
cd ./src/frontend/admin && npm install

# 7. 运行前端项目
npm run dev
# 浏览器打开 http://localhost:5020 ，将看到管理界面（默认用户名：root，密码：1234qwer）

文件目录树

+---.template.config         # dotnet 项目模板配置目录
+---assets                   # 项目资源文件目录
+---build                    # 构建相关的工程文件目录
+---dist                     # 编译生成的二进制文件目录
+---docs                     # 项目开发文档目录
+---refs                     # 引用的第三方包的仓库目录
+---scripts                  # 各种工具脚本文件目录
+---src                      # 项目源码文件目录

后端项目架构

flowchart TD
H["NetAdmin.Host\n公共主机层\n（.Net自托管主机程序）\n（输入输出格式化）\n（数据校验、鉴权）\n（...所有HTTP管道过滤器中间件）"] --> C["NetAdmin.Cache\n公共缓存层\n（基于Redis或MemoryCache的缓存策略实现）"]
C --> A["NetAdmin.Application\n公共业务逻辑层\n（内部服务增删改查）\n（外部服务增删改查）\n（...所有业务用例的计算与组合逻辑的模块化）"]
A --> D["NetAdmin.Domain\n数据实体层\n（数据库关系实体映射）\n（DTO数据传输对象）\n（...所有数据模型的抽象与封装）"]
D --> I["NetAdmin.Infrastructure\n基础设施层\n（第三方组件和Nuget包引用）\n（公共构建和程序运行配置）\n（公共常量枚举异常定义）\n（全球化化和多语言）\n（...所有公共Utility工具）"]

XH["NetAdmin.XXX.Host\n（WebApi）"]-->H
XS["NetAdmin.XXXService\n（常驻内存服务）"]-->H
XS["NetAdmin.XXXService\n（常驻内存服务）"]-->XC
XC["NetAdmin.XXX.Cache\n（缓存层实例）"]-->C
XA["NetAdmin.XXX.Application\n（业务逻辑层实例）"]-->A

XH-->XC
XC-->XA

引用的开源代码 / 特别鸣谢

语言	集成领域	开源库
C#	Web基础框架	ASP.NET Core
C#	快速开发脚手架	Furion
C#	数据库关系映射	FreeSql
C#	代码质量检查	Roslynator.Analyzers | SonarAnalyzer.CSharp | StyleCop.Analyzers
C#	单元测试框架	xunit | coverlet.collector
C#	分布式锁	RedLock.net
C#	控制台终端界面库	Spectre.Console
C#	扩展函数库	NSExt
C#	图形处理库	SixLabors.ImageSharp
C#	文件对象存储	Minio
C#	性能监控采集	prometheus-net.AspNetCore
C#	雪花ID生成器	Yitter.IdGenerator
C#	自动化版本管理	MinVer
C#	JavaScript引擎	MsieJavaScriptEngine
C#	WebApi图形界面	IGeekFan.AspNetCore.Knife4jUI
TypeScript	SPA基础框架	Vue
TypeScript	前端构建工具	Vite
TypeScript	UI控件库	Element Plus
TypeScript	CSS解析器	Sass
TypeScript	图表和数据可视化	ECharts
JavaScript	后台管理界面	SCUI
JavaScript	HTTP请求库	Axios
JavaScript	JavaScript解析器	Terser
JavaScript	代码质量检查	ESLint
JavaScript	代码格式化工具	Prettier
JavaScript	标准加密库	crypto-js