YiShaAdmin用户手册：从安装到日常运维的完整操作指南

【免费下载链接】YiShaAdmin 基于 .NET Core MVC 的权限管理系统，代码易读易懂、界面简洁美观 项目地址: https://gitcode.com/GitHub_Trending/yi/YiShaAdmin

YiShaAdmin是基于.NET Core MVC的权限管理系统，适用于网站管理后台、CMS、CRM等各类Web应用程序开发。本文档将指导您完成从环境准备到日常运维的全流程操作，帮助您快速掌握系统部署与管理技巧。

系统简介与环境要求

YiShaAdmin提供员工管理、部门配置、角色权限分配等核心功能，支持定时任务、系统日志和代码生成工具。根据README.md说明，系统当前支持.NET Core 3.1/6.0/7.0版本，数据库兼容MySQL和SQL Server。

环境准备清单

• 运行环境：.NET Core SDK 3.1+、Windows/Linux/macOS操作系统
• 数据库：MySQL 5.7+ 或 SQL Server 2016+
• Web服务器：Kestrel（内置）或Nginx反向代理
• 可选依赖：Redis（用于分布式缓存）、Git（版本控制）

快速安装部署

1. 源码获取与编译

通过Git克隆仓库或直接下载源码包：

git clone https://gitcode.com/GitHub_Trending/yi/YiShaAdmin
cd YiShaAdmin
dotnet build YiShaAdmin.sln

2. 数据库配置

系统提供MySQL和SQL Server两种数据库脚本，位于Document/DatabaseScript/目录。执行前请阅读安全提示：

Document/DatabaseScript/_readme.txt 警告：脚本会先删除表再重建，请谨慎执行！

MySQL配置示例：

-- 执行数据库脚本
mysql -u root -p < Document/DatabaseScript/mysql.sql
mysql -u root -p < Document/DatabaseScript/mysql_data.sql

3. 应用配置

修改YiSha.Web/YiSha.Admin.Web/appsettings.json文件，配置数据库连接和系统参数：

"SystemConfig": {
  "DBProvider": "SqlServer",  // 可选 MySQL/SqlServer
  "DBConnectionString": "Server=localhost;User Id=sa;Password=hmAdmin@;Database=YsData;",
  "CacheProvider": "Memory"    // 可选 Memory/Redis
}

4. 启动应用

使用提供的批处理文件快速启动：

cd YiSha.Web/YiSha.Admin.Web
./dotnet_run.bat  # 内容为 [dotnet YiSha.Admin.Web.dll](https://link.gitcode.com/i/d69f5b022fc48bb690f4e4beff668a8e)

系统默认监听 http://localhost:5000，登录页面如图所示：

系统初始化与基础配置

Nginx反向代理配置

对于生产环境，建议使用Nginx作为反向代理。配置文件参考Document/nginx.conf：

server {
    listen 80;
    server_name yourdomain.com;
    location /admin/ {
        proxy_pass http://127.0.0.1:5000/admin/;
        proxy_set_header Host $host;
    }
}

登录与权限管理

首次登录使用默认账号admin/123456，系统强制要求修改初始密码。登录后进入权限管理界面：

主要权限管理模块路径：

• 用户管理：YiSha.Business/OrganizationManage/UserBLL.cs
• 角色配置：YiSha.Business/SystemManage/RoleBLL.cs
• 菜单权限：YiSha.Business/SystemManage/MenuAuthorizeBLL.cs

日常运维与管理

数据备份策略

系统支持自动数据库备份功能，配置路径：

"SystemConfig": {
  "DBBackup": "/path/to/backup",  // 备份文件存储路径
}

备份任务由YiSha.Business.AutoJob/Job/DatabasesBackupJob.cs实现，可在定时任务模块配置执行周期。

系统监控与日志

系统提供三类日志监控：

• 操作日志：YiSha.Business/SystemManage/LogOperateBLL.cs
• 登录日志：YiSha.Business/SystemManage/LogLoginBLL.cs
• API日志：YiSha.Business/SystemManage/LogApiBLL.cs

查看日志示例：

定时任务管理

通过YiSha.Business.AutoJob/JobCenter.cs实现任务调度，支持在线添加、修改任务：

1. 进入"系统管理-定时任务"菜单
2. 点击"新增"，配置任务名称、执行周期（Cron表达式）
3. 选择任务类型（如数据库备份、日志清理）

高级功能与定制开发

代码生成工具

系统内置单表增删改查代码生成器，位于YiSha.Util/YiSha.CodeGenerator/目录。使用步骤：

1. 在"工具管理-代码生成"页面选择数据表
2. 配置生成选项（命名空间、作者信息）
3. 下载生成的代码包，包含控制器、视图和业务逻辑层文件

多环境配置管理

通过环境变量区分配置文件：

• 开发环境：appsettings.Development.json
• 生产环境：appsettings.Production.json 启动时指定环境：

dotnet YiSha.Admin.Web.dll --environment Production

常见问题解决

登录失败排查

1. 检查数据库连接：验证appsettings.json中的连接字符串
2. 查看日志文件：默认路径Logs/operate.log
3. 确认账号状态：数据库Sys_User表中Status字段应为1（启用）

性能优化建议

• 使用Redis缓存：修改配置"CacheProvider": "Redis"并配置连接字符串
• 数据库索引优化：通过YiSha.Business/SystemManage/DatabaseTableBLL.cs查看表结构
• 定时清理日志：配置日志清理任务，避免表数据过大

总结与资源

本手册涵盖了YiShaAdmin从安装部署到日常运维的核心操作。系统管理后台主界面如图所示：

更多高级功能请参考：

• 官方文档：README.md
• API接口：YiSha.Web/YiSha.Admin.WebApi/
• 任务调度源码：YiSha.Business.AutoJob/

通过合理配置与定期维护，YiShaAdmin可稳定支持各类中小型Web应用的权限管理需求。如需定制开发，建议优先使用内置的代码生成工具提高开发效率。

【免费下载链接】YiShaAdmin 基于 .NET Core MVC 的权限管理系统，代码易读易懂、界面简洁美观 项目地址: https://gitcode.com/GitHub_Trending/yi/YiShaAdmin