从零到生产YiShaAdmin 权限管理系统 5 步跑通指南【免费下载链接】YiShaAdmin基于 .NET Core MVC 的权限管理系统代码易读易懂、界面简洁美观项目地址: https://gitcode.com/GitHub_Trending/yi/YiShaAdminYiShaAdmin 是一个基于 .NET Core MVC 的权限管理系统内置员工、部门、角色、菜单、按钮级权限、定时任务和代码生成器适合你要快速搭网站后台、CMS、CRM 或 OA 这类管理端项目的场景。下面按实际部署路线走一遍一次会话就能登录进你自己配好的权限管理系统。整个流程分五个阶段动手前先有全局概念阶段目标做什么1 装环境SDK 与代码就位确认 .NET Core SDK 版本克隆仓库2 配数据库建库 灌种子数据执行 Document/DatabaseScript 下的 SQL 脚本3 跑服务Web 与 WebApi 启动改 appsettings.jsondotnet run4 验功能登录验证权限admin 登录查菜单、按钮权限、定时任务5 加固上线生产可用改密码、HTTPS、Redis、备份把 SDK 版本和仓库对齐仓库默认分支master编译目标是netcoreapp3.1如果你的机器装的是新版 SDK先切到对应版本分支再跑README 中列了 YiShaAdmin-Net6、YiShaAdmin-Net7 分支。先确认本机装了哪个 SDKdotnet --list-sdks预期输出里包含 3.1.4xx 或与你所选分支匹配的版本这步卡住的话大概率是 SDK 没装对去微软官网装对应版本即可。然后克隆代码并进入目录git clone https://gitcode.com/GitHub_Trending/yi/YiShaAdmin cd YiShaAdmin解决方案里有两个 Web 工程YiSha.Admin.WebMVC 前端端口 5000和 YiSha.Admin.WebApiREST API端口 5001两者共用一套数据库配置。✅ 本阶段完成标志dotnet --list-sdks能看到目标 SDK 版本仓库已在本地就位。让数据库先跑起来YiShaAdmin 同时支持 MySQL 和 SQL ServerDocument/DatabaseScript/ 下脚本分两组建表结构mysql.sql / sqlserver.sql和种子数据mysql_data.sql / sqlserver_data.sql。种子数据里带默认管理员、菜单、角色、字典——跳过它你连不进去。以 MySQL 为例下面三条命令依次是建库、导结构、导数据mysql -u root -p -e CREATE DATABASE YiShaAdmin DEFAULT CHARSET utf8mb4; mysql -u root -p YiShaAdmin Document/DatabaseScript/mysql.sql mysql -u root -p YiShaAdmin Document/DatabaseScript/mysql_data.sql⚠️ 脚本会先删表再重建千万别对着有真实数据的库执行。三条命令无报错输出即成功再用mysql -u root -p -e USE YiShaAdmin; SHOW TABLES;确认能看到 SysUser、SysMenu、SysRole 等二十多张表。✅ 本阶段完成标志数据库中表结构齐全SysUser 表里有 admin 这条记录。改两处配置dotnet run 启动上一步没问题现在处理最容易被忽略的一个点连接字符串。打开YiSha.Web/YiSha.Admin.Web/appsettings.json只改 SystemConfig 里这两行DBProvider: MySql, DBConnectionString: serverlocalhost;databaseYiShaAdmin;userroot;password你的密码;port3306;charsetutf8mb4;仓库默认是 SqlServer DatabaseYsData用 SQL Server 就保留 DBProvider 不动只把连接串换成你自己的账号库名JSON 别留尾逗号否则启动直接报错。如果还要跑 WebApiYiSha.Web/YiSha.Admin.WebApi/appsettings.json同样改一遍——两个工程端口 5000 / 5001 是各自 Program.cs 里写死的不用配。✅ 本阶段完成标志两个 appsettings.json 保存无误JSON 可被正常解析。然后进 YiSha.Admin.Web 目录启动dotnet run预期终端打印Now listening on: http://*:5000出现这行说明服务起来了。✅ 本阶段完成标志5000 端口监听正常浏览器能打开登录页。登录并验证权限管理功能菜单、按钮、定时任务浏览器打开http://localhost:5000/admin/——注意带/admin虚拟目录这来自配置里的 VirtualDirectory。用种子数据里的账号 admin / 123456 加图片验证码登录。登录后左侧应出现完整的模块菜单单位组织、系统管理、系统工具。菜单为空基本就是数据没导全直接看下面的踩坑速查。接下来验权限。进单位组织 → 员工管理列表支持按组织树筛选和多条件搜索点开任一员工的编辑能看到角色分配入口。而角色到底有哪些菜单和按钮权限要到系统管理 → 角色管理点权限勾选——YiShaAdmin 的权限控制细到按钮级某个按钮不可用基本都是权限标识没勾给当前角色。最后验证定时任务。系统管理 → 定时任务里种子数据已预置任务确认状态为启用、下次执行时间按 Cron 推进点日志能看到执行记录。任务调度 JobCenter 是随进程启动初始化的改完任务记得重启应用才生效。✅ 本阶段完成标志admin 登录成功、菜单完整、员工编辑保存成功、任务日志有新记录。踩坑速查根路径访问 404→ 站点挂在 /admin 虚拟目录下 → 直接访问http://localhost:5000/admin/。登录提示密码错误→ 只导了建表脚本、漏了 mysql_data.sqlSysUser 是空的 →mysql -u root -p YiShaAdmin Document/DatabaseScript/mysql_data.sql后重试。定时任务一直不执行→ 任务状态是禁用或改完没重启、调度器没重建 → 把 JobStatus 置为启用重启 dotnet run。上线前清单改掉 admin / 123456 默认密码种子数据必须换CacheProvider 切到 Redis 并设置密码单机小流量可以保留 Memory套反向代理加 HTTPS仓库里的 Document/nginx.conf 是现成范例设ASPNETCORE_ENVIRONMENTProduction开发异常页在正式环境会泄露堆栈定期备份数据库内置的 DatabasesBackupJob 定时任务可以直接派上用场从克隆仓库到验证完权限整条路线其实就五步大部分时间花在数据库和连接串上。想继续深入按这三处看功能清单与版本分支说明README.md建表与种子数据脚本Document/DatabaseScript/权限核心逻辑菜单、角色、授权分配YiSha.Business/YiSha.Business/SystemManage/【免费下载链接】YiShaAdmin基于 .NET Core MVC 的权限管理系统代码易读易懂、界面简洁美观项目地址: https://gitcode.com/GitHub_Trending/yi/YiShaAdmin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/21 20:21:33 · 阅读 1.2k 从零到生产：YiShaAdmin 权限管理系统 5 步跑通指南
从零到生产YiShaAdmin 权限管理系统 5 步跑通指南【免费下载链接】YiShaAdmin基于 .NET Core MVC 的权限管理系统代码易读易懂、界面简洁美观项目地址: https://gitcode.com/GitHub_Trending/yi/YiShaAdminYiShaAdmin 是一个基于 .NET Core MVC 的权限管理系统内置员工、部门、角色、菜单、按钮级权限、定时任务和代码生成器适合你要快速搭网站后台、CMS、CRM 或 OA 这类管理端项目的场景。下面按实际部署路线走一遍一次会话就能登录进你自己配好的权限管理系统。整个流程分五个阶段动手前先有全局概念阶段目标做什么1 装环境SDK 与代码就位确认 .NET Core SDK 版本克隆仓库2 配数据库建库 灌种子数据执行 Document/DatabaseScript 下的 SQL 脚本3 跑服务Web 与 WebApi 启动改 appsettings.jsondotnet run4 验功能登录验证权限admin 登录查菜单、按钮权限、定时任务5 加固上线生产可用改密码、HTTPS、Redis、备份把 SDK 版本和仓库对齐仓库默认分支master编译目标是netcoreapp3.1如果你的机器装的是新版 SDK先切到对应版本分支再跑README 中列了 YiShaAdmin-Net6、YiShaAdmin-Net7 分支。先确认本机装了哪个 SDKdotnet --list-sdks预期输出里包含 3.1.4xx 或与你所选分支匹配的版本这步卡住的话大概率是 SDK 没装对去微软官网装对应版本即可。然后克隆代码并进入目录git clone https://gitcode.com/GitHub_Trending/yi/YiShaAdmin cd YiShaAdmin解决方案里有两个 Web 工程YiSha.Admin.WebMVC 前端端口 5000和 YiSha.Admin.WebApiREST API端口 5001两者共用一套数据库配置。✅ 本阶段完成标志dotnet --list-sdks能看到目标 SDK 版本仓库已在本地就位。让数据库先跑起来YiShaAdmin 同时支持 MySQL 和 SQL ServerDocument/DatabaseScript/ 下脚本分两组建表结构mysql.sql / sqlserver.sql和种子数据mysql_data.sql / sqlserver_data.sql。种子数据里带默认管理员、菜单、角色、字典——跳过它你连不进去。以 MySQL 为例下面三条命令依次是建库、导结构、导数据mysql -u root -p -e CREATE DATABASE YiShaAdmin DEFAULT CHARSET utf8mb4; mysql -u root -p YiShaAdmin Document/DatabaseScript/mysql.sql mysql -u root -p YiShaAdmin Document/DatabaseScript/mysql_data.sql⚠️ 脚本会先删表再重建千万别对着有真实数据的库执行。三条命令无报错输出即成功再用mysql -u root -p -e USE YiShaAdmin; SHOW TABLES;确认能看到 SysUser、SysMenu、SysRole 等二十多张表。✅ 本阶段完成标志数据库中表结构齐全SysUser 表里有 admin 这条记录。改两处配置dotnet run 启动上一步没问题现在处理最容易被忽略的一个点连接字符串。打开YiSha.Web/YiSha.Admin.Web/appsettings.json只改 SystemConfig 里这两行DBProvider: MySql, DBConnectionString: serverlocalhost;databaseYiShaAdmin;userroot;password你的密码;port3306;charsetutf8mb4;仓库默认是 SqlServer DatabaseYsData用 SQL Server 就保留 DBProvider 不动只把连接串换成你自己的账号库名JSON 别留尾逗号否则启动直接报错。如果还要跑 WebApiYiSha.Web/YiSha.Admin.WebApi/appsettings.json同样改一遍——两个工程端口 5000 / 5001 是各自 Program.cs 里写死的不用配。✅ 本阶段完成标志两个 appsettings.json 保存无误JSON 可被正常解析。然后进 YiSha.Admin.Web 目录启动dotnet run预期终端打印Now listening on: http://*:5000出现这行说明服务起来了。✅ 本阶段完成标志5000 端口监听正常浏览器能打开登录页。登录并验证权限管理功能菜单、按钮、定时任务浏览器打开http://localhost:5000/admin/——注意带/admin虚拟目录这来自配置里的 VirtualDirectory。用种子数据里的账号 admin / 123456 加图片验证码登录。登录后左侧应出现完整的模块菜单单位组织、系统管理、系统工具。菜单为空基本就是数据没导全直接看下面的踩坑速查。接下来验权限。进单位组织 → 员工管理列表支持按组织树筛选和多条件搜索点开任一员工的编辑能看到角色分配入口。而角色到底有哪些菜单和按钮权限要到系统管理 → 角色管理点权限勾选——YiShaAdmin 的权限控制细到按钮级某个按钮不可用基本都是权限标识没勾给当前角色。最后验证定时任务。系统管理 → 定时任务里种子数据已预置任务确认状态为启用、下次执行时间按 Cron 推进点日志能看到执行记录。任务调度 JobCenter 是随进程启动初始化的改完任务记得重启应用才生效。✅ 本阶段完成标志admin 登录成功、菜单完整、员工编辑保存成功、任务日志有新记录。踩坑速查根路径访问 404→ 站点挂在 /admin 虚拟目录下 → 直接访问http://localhost:5000/admin/。登录提示密码错误→ 只导了建表脚本、漏了 mysql_data.sqlSysUser 是空的 →mysql -u root -p YiShaAdmin Document/DatabaseScript/mysql_data.sql后重试。定时任务一直不执行→ 任务状态是禁用或改完没重启、调度器没重建 → 把 JobStatus 置为启用重启 dotnet run。上线前清单改掉 admin / 123456 默认密码种子数据必须换CacheProvider 切到 Redis 并设置密码单机小流量可以保留 Memory套反向代理加 HTTPS仓库里的 Document/nginx.conf 是现成范例设ASPNETCORE_ENVIRONMENTProduction开发异常页在正式环境会泄露堆栈定期备份数据库内置的 DatabasesBackupJob 定时任务可以直接派上用场从克隆仓库到验证完权限整条路线其实就五步大部分时间花在数据库和连接串上。想继续深入按这三处看功能清单与版本分支说明README.md建表与种子数据脚本Document/DatabaseScript/权限核心逻辑菜单、角色、授权分配YiSha.Business/YiSha.Business/SystemManage/【免费下载链接】YiShaAdmin基于 .NET Core MVC 的权限管理系统代码易读易懂、界面简洁美观项目地址: https://gitcode.com/GitHub_Trending/yi/YiShaAdmin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考