Dorisoy.Pan部署指南：从环境搭建到性能调优的完整路径

Dorisoy.Pan部署指南：从环境搭建到性能调优的完整路径

【免费下载链接】Dorisoy.PanDorisoy.Pan 是基于.net core8 的跨平台文档管理系统，使用 MS SQL 2012 / MySql8.0（或更高版本）后端数据库，您可以在 Windows、Linux 或 Mac 上运行它,项目中的所有方法都是异步的,支持令牌基身份验证,项目体系结构遵循著名的软件模式和最佳安全实践。源代码是完全可定制的,热插拔且清晰的体系结构,使开发定制功能和遵循任何业务需求变得容易。 系统使用最新的 Microsoft 技术，高性能稳定性和安全性项目地址: https://gitcode.com/gh_mirrors/do/Dorisoy.Pan

Dorisoy.Pan是一款基于.NET Core 8构建的跨平台文档管理系统，提供高效安全的文件管理解决方案。该系统支持MS SQL 2012/MySQL 8.0及以上版本作为后端数据库，可在Windows、Linux和Mac等多种操作系统上稳定运行。本文将详细介绍如何部署Dorisoy.Pan系统，解决数据库连接超时等常见问题，帮助您顺利完成从环境准备到性能优化的全过程。

准备阶段

环境兼容性检测

在开始部署Dorisoy.Pan之前，需要确保您的环境满足系统要求。以下是主要组件的兼容性矩阵：

[!TIP] 您可以通过运行以下命令检查已安装的.NET SDK版本：

dotnet --version

项目获取

首先，克隆Dorisoy.Pan项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/do/Dorisoy.Pan

环境配置

Dorisoy.Pan采用前后端分离架构，主要包括API服务、数据库和前端应用三个部分。系统架构如下：

该架构具有以下特点：

• 采用异步编程模型，提升系统响应性能
• 基于令牌的身份验证机制，确保数据安全
• 模块化设计，支持功能扩展和定制

部署阶段

基础配置

后端部署

1. 进入项目目录，还原NuGet包：

cd Dorisoy.Pan/Src/Dorisoy.Pan.API dotnet restore

2. 修改数据库连接字符串。打开appsettings.json文件，根据您使用的数据库类型修改相应的连接字符串：

对于SQL Server：

"ConnectionStrings": { "DefaultConnection": "Server=localhost;Database=DorisoyPan;User Id=sa;Password=YourPassword;" }

对于MySQL：

"ConnectionStrings": { "DefaultConnection": "server=localhost;database=DorisoyPan;uid=root;pwd=YourPassword;sslmode=none" }

3. 执行数据库迁移：

cd ../Dorisoy.Pan.Domain dotnet ef database update

[!TIP] 如果使用MySQL数据库，还需要运行项目提供的SQL脚本创建必要的存储过程：

mysql -u root -p DorisoyPan < ../../SQL/MySQL.sql mysql -u root -p DorisoyPan < ../../SQL/PROCEDURE-MySQL.sql

4. 启动API服务：

cd ../Dorisoy.Pan.API dotnet run

前端部署

1. 进入UI目录，安装依赖：

cd ../../../UI npm install

2. 启动前端开发服务器：

npm run start

此时，您可以通过访问http://localhost:4200来查看前端应用。系统登录界面如下：

高级选项

生产环境构建

对于生产环境，建议进行优化构建：

后端构建：

cd Src/Dorisoy.Pan.API dotnet publish -c Release -o publish

前端构建：

cd ../../UI npm run build --prod

构建完成后，前端文件将生成在UI/dist目录下，可以部署到Nginx或IIS等Web服务器。

数据库迁移工具替代方案

除了使用Entity Framework Core的迁移命令外，您还可以使用数据库备份恢复的方式初始化数据库：

1. 执行SQL脚本创建数据库结构：

# SQL Server sqlcmd -S localhost -U sa -P YourPassword -i SQL/MsSQL.sql # MySQL mysql -u root -p -e "CREATE DATABASE DorisoyPan;" mysql -u root -p DorisoyPan < SQL/MySQL.sql

2. 导入初始数据：

# MySQL示例 mysql -u root -p DorisoyPan < Server/Dump20240403.sql

验证阶段

功能验证

部署完成后，您可以通过以下步骤验证系统功能：

1. 访问前端应用（默认地址：http://localhost:4200）
2. 使用默认管理员账号登录（admin@test.com，密码：123456）
3. 检查文件上传、下载、共享等核心功能是否正常

性能调优建议

为了获得更好的系统性能，建议进行以下优化：

缓存策略

在appsettings.json中配置缓存：

"CacheSettings": { "DefaultCacheDuration": 3600, "SlidingExpiration": true }

数据库连接池配置

优化数据库连接池设置：

"ConnectionStrings": { "DefaultConnection": "Server=localhost;Database=DorisoyPan;User Id=sa;Password=YourPassword;Max Pool Size=100;Min Pool Size=10;" }

部署模式对比

不同部署模式的资源占用情况对比：

常见故障排除

1. 数据库连接超时

问题表现：API服务启动失败，日志中出现数据库连接超时错误。

解决方案：

• 检查数据库服务是否正常运行
• 验证连接字符串中的服务器地址和端口是否正确
• 确认数据库用户具有足够的权限
• 尝试增加连接超时时间：

  "ConnectionStrings": { "DefaultConnection": "Server=localhost;Database=DorisoyPan;User Id=sa;Password=YourPassword;Connect Timeout=30;" }

2. 前端无法访问API

问题表现：前端页面加载正常，但无法获取数据，浏览器控制台显示404或500错误。

解决方案：

• 检查API服务是否正常运行
• 确认API基础URL配置正确（位于UI/src/environments/environment.ts）
• 检查跨域设置，确保API允许前端域名访问
• 运行以下命令检查API是否可访问：

  curl http://localhost:5000/api/health

3. 文件上传失败

问题表现：上传文件时进度条卡住或提示上传失败。

解决方案：

• 检查服务器磁盘空间是否充足
• 验证文件大小限制设置（位于appsettings.json的FileSettings部分）
• 检查网络连接是否稳定
• 对于大文件上传，尝试启用分块上传功能：

  "FileSettings": { "EnableChunkedUpload": true, "ChunkSize": 10485760 }

通过以上步骤，您应该能够成功部署和优化Dorisoy.Pan文档管理系统。如果遇到其他问题，可以查看系统日志或项目文档获取更多帮助。祝您使用愉快！

【免费下载链接】Dorisoy.PanDorisoy.Pan 是基于.net core8 的跨平台文档管理系统，使用 MS SQL 2012 / MySql8.0（或更高版本）后端数据库，您可以在 Windows、Linux 或 Mac 上运行它,项目中的所有方法都是异步的,支持令牌基身份验证,项目体系结构遵循著名的软件模式和最佳安全实践。源代码是完全可定制的,热插拔且清晰的体系结构,使开发定制功能和遵循任何业务需求变得容易。 系统使用最新的 Microsoft 技术，高性能稳定性和安全性项目地址: https://gitcode.com/gh_mirrors/do/Dorisoy.Pan