数字档案馆系统云应用部署实操 手把手搭建私有化档案管理系统

前置环境准备

云服务器配置要求

最低配置2核4G云服务器，操作系统选择CentOS7.9或Ubuntu22.04，公网带宽≥3M，单独挂载≥100G数据盘用于存储档案文件，避免系统盘占满导致服务崩溃。

基础软件安装

仅需安装Docker和Docker Compose即可，无需手动配置JDK、MySQL等依赖，对应CentOS系统安装命令如下：

``` 安装yum工具 yum install -y yum-utils 配置Docker官方国内源 yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo 安装Docker及相关组件 yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin 启动Docker并设置开机自启 systemctl start docker systemctl enable docker ```

安装完成后执行以下命令验证，输出版本号即为安装成功：

``` docker -v docker compose version ```

数字档案馆系统部署实操

第一步：拉取系统部署包

执行以下命令从国内Gitee仓库拉取最新稳定版部署包，避免GitHub访问超时：

``` git clone https://gitee.com/opensource-archives/archives-cloud-system.git cd archives-cloud-system ```

第二步：修改核心配置文件

复制项目内.env.example文件为.env，直接替换为以下完整配置，必须修改数据库密码和管理员默认密码为自定义强密码，存储路径修改为实际数据盘挂载路径：

``` 系统访问端口配置 SERVER_PORT=8080 MySQL数据库配置 DB_HOST=mysql DB_PORT=3306 DB_NAME=archives_db DB_USER=archives_user DB_PASSWORD=ArChIvEs_2024@test 必须修改为自定义强密码 档案文件存储路径 FILE_STORAGE_PATH=/mnt/data/archives/files 替换为实际数据盘路径 管理员默认账号密码 ADMIN_DEFAULT_USER=admin ADMIN_DEFAULT_PASS=Admin@202406 必须修改为自定义强密码 ```

第三步：一键启动服务

执行以下命令后台启动所有服务，包含系统主程序、MySQL数据库、Redis缓存、OCR识别服务，无需单独部署：

``` docker compose up -d ```

等待3-5分钟完成初始化，执行`docker compose ps`查看所有服务状态为healthy即为启动成功。

系统初始化配置实操

第一步：登录系统后台

访问地址为`http://你的云服务器公网IP:8080`，输入配置文件中设置的管理员账号密码登录。如果无法访问，需先在云服务器安全组入方向放行TCP 8080端口，允许0.0.0.0/0访问。

第二步：导入标准档案规则

按照以下步骤配置符合国家《数字档案馆建设规范》的基础规则，无需手动创建：

• 左侧菜单进入【系统配置】-【档案分类管理】，点击【批量导入】，选择项目根目录下template文件夹内的《档案分类标准模板.xlsx》，一键导入文书、科技、人事、会计四大类标准分类
• 进入【系统配置】-【元数据管理】，点击【初始化默认元数据】，自动生成符合国标要求的128个通用元数据字段
• 进入【存储配置】，如果需要对接阿里云OSS/腾讯云COS，直接填写对应AK、SK、桶名、地域，保存后自动切换为对象存储，默认存储在本地数据盘

第三步：配置用户权限

• 进入【用户管理】-【角色管理】，新建4个标准角色：档案录入员、档案审核员、档案利用员、超级管理员，分别勾选对应权限：录入员仅可上传编辑档案、审核员可审核归档、利用员仅可检索借阅、管理员拥有所有权限
• 进入【用户管理】-【新建用户】，绑定对应角色，设置初始密码，用户首次登录强制修改密码

核心功能实操流程

档案归档流程

• 档案录入员登录，进入【档案录入】-【新增档案】，选择对应分类，填写元数据，上传档案原件（支持PDF、JPG、DOCX等120+格式），提交审核
• 档案审核员登录，进入【档案审核】-【待我审核】，核对元数据和原件合规性，符合要求点击【通过归档】，不符合点击【驳回】并填写原因
• 归档后的档案自动进入档案库，系统自动完成OCR识别，支持全文检索档案内容，无需手动录入文本

档案借阅流程

• 普通用户登录，进入【档案利用】-【检索】，找到目标档案，点击【申请借阅】，填写借阅理由、时长，提交申请
• 管理员登录，进入【借阅审批】-【待审批】，同意后用户可在有效期内查看下载档案，到期自动回收权限

日常运维&问题排查

常见启动失败排查

• MySQL启动失败：执行`netstat -tunlp | grep 3306`查看3306端口是否被占用，kill占用进程后重新执行`docker compose up -d`即可
• 系统服务启动失败：检查.env配置文件密码是否包含&、空格等特殊字符，删除特殊字符后重启服务

日常运维操作

• 数据备份：执行以下命令自动生成数据库备份文件，建议设置crontab每天凌晨2点执行： ``` docker exec mysql mysqldump -u archives_user -p'你的数据库密码' archives_db > /mnt/data/backup/archives_db_$(date +%Y%m%d).sql ```
• 系统升级：进入项目目录执行`git pull`拉取最新代码，再执行`docker compose up -d --build`即可完成升级，数据不会丢失
• 日志排查：执行`docker compose logs -f archives-system`查看系统实时运行日志，定位报错问题