易操作数字档案馆系统零基础部署、配置与日常运维实操全指南

一、前期准备

本次使用轻量开源版数字档案馆系统，无需复杂配置，普通办公电脑即可运行，所需资源如下：

1. 软硬件要求

• 硬件：2核4G配置的Windows10+/CentOS7+电脑/云服务器均可，存储空间≥50G
• 软件：JDK1.8、MySQL5.7，均提供直链下载，无需自行搜索

2. 安装包直链下载

系统安装包直链：https://gitee.com/zyfworks/archives/releases/download/v1.0.0/archives-admin-v1.0.0.zip，复制到浏览器地址栏直接下载即可

二、系统部署实操步骤

1. 基础环境安装

Windows环境操作：

• JDK1.8直链下载：https://repo.huaweicloud.com/java/jdk/8u202-b08/jdk-8u202-windows-x64.exe，双击安装默认路径即可
• 配置环境变量：右键此电脑→属性→高级系统设置→环境变量，系统变量新建【JAVA_HOME】，值填C:\Program Files\Java\jdk1.8.0_202，编辑Path变量新增%JAVA_HOME%\bin，保存后cmd输入java -version，出现1.8.x版本号即为安装成功
• MySQL5.7直链下载：https://cdn.mysql.com/archives/mysql-5.7/mysql-5.7.40-winx64.zip，解压后运行安装程序，设置root账号密码为123456，安装完成后新建名为digital_archive的数据库，字符集选utf8mb4，排序规则选utf8mb4_general_ci

CentOS环境操作：

• 安装JDK1.8：执行命令yum install -y java-1.8.0-openjdk-devel，安装完成后输入java -version验证
• 安装MySQL5.7：依次执行以下命令

  
  wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm
  rpm -ivh mysql57-community-release-el7-11.noarch.rpm
  yum install -y mysql-community-server
  systemctl start mysqld
  systemctl enable mysqld
  
  

  安装完成后设置root密码为123456，新建digital_archive数据库，字符集设置同上

2. 系统配置与启动

• 将下载的系统安装包解压到Windows的D盘根目录，或CentOS的/opt目录下
• 找到解压目录下的config/application.yml文件，替换为以下完整配置，可直接复制：

  ```yaml
  server:
  port: 8080
  spring:
  datasource:
  url: jdbc:mysql://127.0.0.1:3306/digital_archive?useUnicode=true&characterEncoding=utf8mb4&useSSL=false&serverTimezone=GMT%2B8
  username: root
  password: 123456
  driver-class-name: com.mysql.jdbc.Driver
  servlet:
  multipart:
  max-file-size: 100MB
  max-request-size: 100MB
  archive:
  Windows环境填D:/digital-archive/storage，CentOS环境填/opt/digital-archive/storage
  storage-path: D:/digital-archive/storage
  ```
  

• 手动创建配置文件中storage-path对应的文件夹，避免上传失败
• 启动系统：Windows环境双击bin目录下的start.bat，CentOS环境执行命令chmod +x bin/start.sh && ./bin/start.sh
• 启动完成后，浏览器访问http://localhost:8080，默认账号admin，密码123456，登录成功即部署完成。不要关闭启动时弹出的cmd/终端窗口，否则系统会停止运行

三、核心功能易操作实操

1. 档案入库操作

• 登录后点击左侧菜单栏【档案管理】→【新增档案】
• 选择档案分类，系统自带文书、科技、财务、人事等国标分类，也可在【分类管理】中自定义新增
• 上传档案原件，支持PDF、Word、Excel、图片、扫描件格式，单文件最大支持100MB
• 填写带号的必填元数据：题名、形成日期、保管期限、文号，其余字段可选填
• 点击【提交入库】，系统自动生成唯一档案编号，自动OCR识别图片、扫描件的文字内容，无需手动录入即可支持全文检索

2. 档案检索与调阅

• 顶部搜索框直接输入关键词，可检索档案元数据和OCR识别的文件内容，也可点击【高级检索】按档案编号、分类、日期精准筛选
• 搜索结果点击【预览】可直接在线查看原件，有权限的账号可点击【下载】获取源文件，所有调阅、下载操作系统自动留痕，无需手动登记
• 权限配置：点击左侧【系统管理】→【角色管理】，给对应角色勾选档案新增、预览、下载、删除权限即可，普通用户默认只有预览权限

3. 档案统计与导出

点击左侧【统计报表】，可按档案分类、入库时间、保管期限自动生成符合国标的统计报表，支持一键导出Excel；所有档案元数据支持批量导出，无需手动整理。

四、常见问题排查与日常运维

1. 常见问题排查

• 访问8080端口无响应：首先检查启动窗口是否显示“启动成功”字样，若已启动则执行命令netstat -ano | findstr 8080（Windows）或netstat -tunlp | grep 8080（CentOS）检查端口是否被占用，若被占用可修改application.yml中的port为8081后重启系统
• 上传档案失败：检查文件大小是否超过100MB，再确认storage-path对应的文件夹是否已创建
• 管理员密码遗忘：执行MySQL命令update digital_archive.sys_user set password = 'e10adc3949ba59abbe56e057f20f883e' where user_name = 'admin';，即可重置密码为123456

2. 日常运维注意事项

• 每周备份1次数据库和存储文件，数据库备份命令：mysqldump -u root -p123456 digital_archive > D:/backup/archive_$(date +%Y%m%d).sql（Windows修改对应路径），同时复制storage目录的所有文件到备份盘
• 系统升级时，下载新版安装包后，覆盖除config/application.yml和storage目录外的所有文件，重启即可完成升级，不会丢失现有数据