档案数字化电子系统本地部署全流程实操指南 附可直接复用配置

一、前置准备

1.1 硬件&工具准备

硬件要求：2核4G服务器（本地虚拟机也可，安装CentOS7.9系统），剩余存储不低于100G（根据档案存量调整）。

工具下载地址：

• Xshell7（服务器远程连接工具）：https://www.netsarang.com/zh/xshell-download/
• Xftp7（文件传输工具）：https://www.netsarang.com/zh/xftp-download/

1.2 软件版本&安装包

统一使用以下稳定版本，避免兼容性问题：JDK1.8、MySQL8.0、Redis6.2，档案系统安装包直接下载：https://gitee.com/RainyGao/DocSys/releases/download/v2.3.0/DocSys-v2.3.0.tar.gz

二、基础环境部署

2.1 JDK安装

用Xshell连接服务器后依次执行以下命令：

• 安装：yum install -y java-1.8.0-openjdk-devel
• 验证：java -version，输出openjdk version "1.8.0_xxx"即为成功

2.2 MySQL安装配置

依次执行以下命令：

• 导入MySQL yum源：rpm -ivh https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
• 安装：yum install -y mysql-community-server --nogpgcheck
• 启动服务：systemctl start mysqld && systemctl enable mysqld
• 获取初始密码：grep 'temporary password' /var/log/mysqld.log，复制输出的末尾密码
• 登录MySQL：mysql -uroot -p，粘贴刚才的初始密码回车
• 修改root密码并创建系统库，依次执行以下SQL语句：

  ALTER USER 'root'@'localhost' IDENTIFIED BY 'DocSys@2024';
  CREATE DATABASE docsys DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
  exit;
  

2.3 Redis安装配置

依次执行以下命令：

• 安装：yum install -y redis
• 启动服务：systemctl start redis && systemctl enable redis
• 设置Redis密码：redis-cli config set requirepass DocRedis@2024

三、档案系统部署

3.1 安装包下载&解压

依次执行以下命令：

• 下载安装包：wget https://gitee.com/RainyGao/DocSys/releases/download/v2.3.0/DocSys-v2.3.0.tar.gz
• 解压：tar -zxvf DocSys-v2.3.0.tar.gz
• 创建文件存储目录并赋权：mkdir -p /opt/docsys/files && chmod 777 /opt/docsys/files

3.2 配置文件修改

进入解压后的目录，编辑application.yml配置文件，直接复制以下完整配置，仅需替换百度OCR的AK/SK（可在https://cloud.baidu.com/product/ocr.html免费申请，每日1000次识别额度足够中小团队使用）： ```yaml server: port: 8080 servlet: context-path: /docsys spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/docsys?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: DocSys@2024 redis: host: 127.0.0.1 port: 6379 password: DocRedis@2024 servlet: multipart: max-file-size: 1024MB max-request-size: 1024MB docsys: file-path: /opt/docsys/files/ ocr: enable: true baidu-ak: 替换为你的百度OCR AK baidu-sk: 替换为你的百度OCR SK watermark: enable: true content: "{username} {time}" ```

3.3 系统启动&登录

依次执行以下命令：

• 后台启动系统：nohup java -jar DocSys.jar > start.log 2>&1 &
• 查看启动日志：tail -f start.log，出现Started DocSysApplication in X seconds即为启动成功
• 访问地址：http://你的服务器IP:8080/docsys，默认账号admin，密码123456

四、核心功能实操

4.1 档案数字化录入流程

• 第一步：创建档案分类，登录后进入【档案管理】-【分类配置】，点击新增分类，填写分类名称（如人事档案、工程档案），设置对应操作权限，勾选允许上传扫描件
• 第二步：批量上传扫描件，进入【档案录入】模块，选择对应分类，点击批量上传，支持JPG/PDF/TIFF格式，单文件最大支持1G，上传时系统自动生成缩略图和OCR识别结果
• 第三步：档案著录归档，点击对应档案的【著录】按钮，系统会自动提取OCR结果填充档案编号、题名、责任者等元数据，校验无误后点击提交即可完成归档

4.2 权限配置

进入【系统管理】-【用户管理】，点击新增用户，填写账号密码后，分配对应档案分类的查看/编辑/下载权限，敏感档案可开启水印权限，用户预览、下载时自动添加用户名+时间的半透明水印，防止泄露。

4.3 定期备份操作

每周固定执行2项备份操作，避免数据丢失：

• 数据库备份：mysqldump -uroot -p'DocSys@2024' docsys > /opt/backup/docsys_db_`date +%Y%m%d`.sql
• 档案文件备份：tar -zcvf /opt/backup/docsys_files_`date +%Y%m%d`.tar.gz /opt/docsys/files

五、常见问题排查

• 启动失败：查看start.log日志，若提示端口被占用，执行netstat -tunlp | grep 8080找到占用进程ID，执行kill -9 进程ID后重新启动即可
• 上传失败：检查/opt/docsys/files目录权限是否为777，配置文件中的存储路径是否配置正确
• OCR识别失败：检查百度OCR的AK/SK是否填写正确，服务器是否可正常访问外网
• 无法访问系统：检查服务器防火墙是否开放8080端口，执行firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --reload开放端口即可