Dorisoy.Pan部署指南：从0到1搭建私有文档管理系统-开发者社区

Dorisoy.Pan部署指南：从0到1搭建私有文档管理系统

【免费下载链接】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构建的跨平台文档管理系统，采用现代化技术栈确保高性能与安全性。系统支持多终端访问，让你随时随地管理和查阅文件，同时提供灵活的权限控制和丰富的文档操作功能，满足个人与团队的文件管理需求。

功能特性

核心优势

跨平台运行：无缝支持Windows、Linux和Mac系统，适应不同的办公环境
异步处理架构：所有操作采用异步方式，确保系统响应迅速，即使处理大量文件也不卡顿
安全认证机制：基于令牌的身份验证，保障文档访问安全可控
灵活权限管理：细粒度的权限设置，可针对不同用户和文件夹配置访问权限
模块化设计：热插拔的系统架构，便于功能扩展和定制开发

用户价值

手机/电脑随时查阅文件，打破设备限制
团队协作更高效，文件共享与权限管理一目了然
系统稳定可靠，数据安全有保障
可根据业务需求定制功能，满足特定场景需求

环境准备

系统要求

环境	最低配置	推荐配置
操作系统	Windows 10/Server 2012+，Linux (Ubuntu 18.04+)，macOS 10.14+	Windows 10/Server 2019，Ubuntu 20.04+，macOS 12+
CPU	双核2.0GHz	四核2.5GHz+
内存	4GB	8GB+
硬盘	50GB可用空间	100GB SSD
数据库	MS SQL 2012+ 或 MySQL 8.0+	MS SQL 2019 或 MySQL 8.0+
.NET SDK	7.0+	8.0+
Node.js	12.0+	16.0+

软件安装

1. 安装必要依赖

Windows系统：

# 安装Chocolatey包管理器（若未安装） Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')) # 安装.NET SDK、Node.js和Git choco install dotnet-sdk -y choco install nodejs -y choco install git -y

Linux系统（Ubuntu/Debian）：

# 添加微软包源 wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb rm packages-microsoft-prod.deb # 安装.NET SDK、Node.js和Git sudo apt-get update && sudo apt-get install -y dotnet-sdk-8.0 nodejs git

✅ 验证点：执行以下命令检查安装是否成功

dotnet --version # 应显示7.0或更高版本 node --version # 应显示12.0或更高版本 git --version # 应显示2.0或更高版本

2. 数据库准备

MySQL安装示例：

# Ubuntu安装MySQL sudo apt-get install mysql-server -y sudo systemctl enable mysql sudo systemctl start mysql # 安全配置 sudo mysql_secure_installation

创建数据库：

CREATE DATABASE dorisoy_pan CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'dorisoy_user'@'localhost' IDENTIFIED BY 'StrongPassword123!'; GRANT ALL PRIVILEGES ON dorisoy_pan.* TO 'dorisoy_user'@'localhost'; FLUSH PRIVILEGES;

部署流程

1. 获取项目代码

# 克隆代码仓库 git clone https://gitcode.com/gh_mirrors/do/Dorisoy.Pan cd Dorisoy.Pan

2. 后端部署

📌任务卡片：配置后端

操作项：修改数据库连接字符串

操作步骤：

# 进入API项目目录 cd Src/Dorisoy.Pan.API # 编辑配置文件 # Windows使用notepad，Linux使用nano或vim notepad appsettings.json

配置内容：

"ConnectionStrings": { "DefaultConnection": "Server=localhost;Database=dorisoy_pan;Uid=dorisoy_user;Pwd=StrongPassword123!;" }

预期结果：配置文件保存成功，数据库连接信息正确

✅ 验证点：确保连接字符串格式正确，数据库用户具有足够权限

📌任务卡片：初始化数据库

操作项：应用数据库迁移

操作步骤：

# 进入Domain项目目录 cd ../Dorisoy.Pan.Domain # 安装EF Core工具（若未安装） dotnet tool install --global dotnet-ef # 应用迁移 dotnet ef database update

预期结果：数据库表结构创建成功，无错误提示

✅ 验证点：登录数据库，确认表已创建

📌任务卡片：启动后端服务

操作项：运行API服务

操作步骤：

# 进入API项目目录 cd ../Dorisoy.Pan.API # 启动服务 dotnet run

预期结果：服务启动成功，显示"Now listening on: http://localhost:5000"

✅ 验证点：打开浏览器访问http://localhost:5000，应看到API文档页面

3. 前端部署

📌任务卡片：安装前端依赖

操作项：安装Node.js依赖包

操作步骤：

# 返回项目根目录并进入UI文件夹 cd ../../../UI # 安装依赖 npm install

预期结果：依赖包安装完成，无错误提示

✅ 验证点：node_modules文件夹创建成功，包含大量依赖文件

📌任务卡片：构建前端项目

操作项：构建生产环境前端资源

操作步骤：

# 构建生产版本 npm run build --prod

预期结果：构建成功，生成dist文件夹

✅ 验证点：dist文件夹中包含index.html和相关静态资源

4. 容器化部署（备选方案）

💡 如果你熟悉Docker，可使用容器化部署简化流程

# 构建Docker镜像 docker build -t dorisoy-pan -f Server/Dockerfile . # 运行容器 docker run -d -p 5000:80 --name dorisoy-pan-container dorisoy-pan

验证测试

环境验证

服务状态检查

# 检查API服务是否运行（Linux） curl http://localhost:5000/health # 应返回{"status":"Healthy"}

数据库连接测试

# 使用EF Core命令测试连接 cd Src/Dorisoy.Pan.Domain dotnet ef dbcontext info

前端访问测试
- 打开浏览器访问http://localhost:5000
- 应看到登录界面，如前文数据库配置界面所示

功能测试

登录系统
- 使用默认管理员账户：admin@test.com，密码：Admin@123
- 预期结果：成功登录系统，进入主界面
创建文件夹
- 点击"新建文件夹"按钮，输入名称并确认
- 预期结果：文件夹创建成功，显示在文件列表中
上传文件
- 选择一个测试文件，点击上传
- 预期结果：文件上传成功，显示在文件列表中

常见问题

故障排查

[!WARNING] 数据库连接失败？
检查数据库服务是否运行
验证连接字符串中的用户名、密码和数据库名是否正确
确认数据库用户具有足够权限

[!WARNING] 前端构建失败？
检查Node.js版本是否符合要求
删除node_modules文件夹后重新执行npm install
检查网络连接，确保能正常访问npm仓库

性能优化

数据库优化

索引建议：为频繁查询的字段创建索引

CREATE INDEX idx_document_name ON Document(Name); CREATE INDEX idx_document_createdate ON Document(CreatedAt);

定期维护：MySQL执行OPTIMIZE TABLE，SQL Server执行REBUILD INDEX

系统监控

关键指标：
- CPU使用率：应低于70%
- 内存使用率：应低于80%
- 数据库连接数：根据服务器配置调整，一般不超过100

数据备份

创建定时备份脚本：

#!/bin/bash # backup.sh TIMESTAMP=$(date +"%Y%m%d_%H%M%S") BACKUP_DIR="/path/to/backups" # 创建备份目录 mkdir -p $BACKUP_DIR # MySQL备份 mysqldump -u dorisoy_user -pStrongPassword123! dorisoy_pan > $BACKUP_DIR/dorisoy_pan_$TIMESTAMP.sql # 保留最近30天备份 find $BACKUP_DIR -name "dorisoy_pan_*.sql" -mtime +30 -delete

设置定时任务：

# 每天凌晨2点执行备份 crontab -e # 添加以下行 0 2 * * * /path/to/backup.sh

通过以上步骤，你已经成功部署了Dorisoy.Pan文档管理系统。系统采用现代化架构设计，确保了高性能和安全性，同时提供了灵活的定制能力。无论是个人使用还是团队协作，Dorisoy.Pan都能满足你的文档管理需求。如有任何问题，可参考项目文档或社区支持获取帮助。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Dorisoy.Pan部署指南：从0到1搭建私有文档管理系统