双河数字档案馆系统本地化部署与日常运维实操全流程指南

一、前置准备

本次实操基于v2.3.1稳定版本，所有资源和命令均经过实测可直接复用，提前准备以下环境：

• 硬件：4核8G以上云服务器/本地物理机，系统盘≥50G，数据盘≥1T（用于存储档案文件）
• 操作系统：CentOS7.9/Ubuntu22.04，推荐使用CentOS7.9兼容性最优
• 安装包下载地址：https://gitee.com/shuanghe-digital/archive-system/releases/download/v2.3.1/shuanghe-archive-v2.3.1.tar.gz

二、部署实操步骤

2.1 依赖环境安装

所有命令均在root权限下执行，依次运行以下命令安装依赖：

• 安装JDK1.8：
  yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel
  验证：java -version，返回openjdk version "1.8.0_xxx"即为成功
• 安装MySQL8.0：
  yum install -y https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
yum install -y mysql-community-server
  启动并设置开机自启：systemctl enable --now mysqld
  获取初始密码：grep 'temporary password' /var/log/mysqld.log
  登录后修改密码并创建数据库：
  mysql -uroot -p初始密码
ALTER USER 'root'@'localhost' IDENTIFIED BY '自定义MySQL密码';
create database shuanghe_archive default character set utf8mb4 collate utf8mb4_general_ci;
exit;
• 安装Redis6.2：
  yum install -y epel-release && yum install -y redis
  启动并设置开机自启：systemctl enable --now redis
• 安装Nginx1.20：
  yum install -y nginx
  启动并设置开机自启：systemctl enable --now nginx

2.2 系统包部署

• 下载并解压安装包：
  wget https://gitee.com/shuanghe-digital/archive-system/releases/download/v2.3.1/shuanghe-archive-v2.3.1.tar.gz
tar -zxvf shuanghe-archive-v2.3.1.tar.gz && cd shuanghe-archive-v2.3.1
• 创建档案存储目录：mkdir -p /data/shuanghe-archive/files
• 修改配置文件application.yml，直接复制以下内容替换，仅需修改MySQL密码和Redis密码（无密码留空）： ```yaml server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/shuanghe_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: 替换为你设置的MySQL密码 redis: host: 127.0.0.1 port: 6379 password: 无密码则删除本行 servlet: multipart: max-file-size: 1024MB max-request-size: 1024MB shuanghe: archive: storage-path: /data/shuanghe-archive/files ```
• 导入初始化数据库脚本：mysql -uroot -p你的MySQL密码 shuanghe_archive < sql/init.sql
• 后台启动系统：nohup java -jar shuanghe-archive.jar > /dev/null 2>&1 &
• 验证启动：curl 127.0.0.1:8080，返回HTML内容即为启动成功

2.3 反向代理配置

新建Nginx配置文件/etc/nginx/conf.d/shuanghe-archive.conf，复制以下内容，替换为你的服务器IP/域名：

```nginx server { listen 80; server_name 你的服务器公网IP或者绑定的域名; client_max_body_size 1024M; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ```

验证配置并重载：
nginx -t返回success后执行nginx -s reload

首次访问：浏览器输入服务器IP/域名，默认管理员账号admin，密码123456，登录后请立即修改默认密码

三、核心功能实操

3.1 档案录入

• 步骤1：进入【档案管理】-【档案分类】，创建对应分类（如文书档案、科技档案），设置分类编码、保管期限
• 步骤2：进入【档案录入】，选择对应分类，必填项为档案编号、题名、形成日期、保管期限，支持上传PDF、Word、扫描件等格式，单文件最大1G
• 步骤3：提交后自动进入审核流程，管理员可在【审核管理】中通过或驳回，审核通过的档案才会进入检索库

3.2 档案检索

支持三种检索模式，可按需选择：

• 全文检索：首页搜索框直接输入关键词，系统自动匹配档案附件、题名、摘要等所有字段，响应时间≤1秒
• 精准检索：点击高级搜索，选择对应字段（档案编号、形成日期范围、分类），精准定位目标档案
• 检索结果支持导出Excel清单、批量下载附件，仅管理员拥有批量下载权限

3.3 权限配置

• 步骤1：进入【系统管理】-【角色管理】，创建对应角色（普通用户、档案管理员、系统管理员），勾选对应权限（普通用户仅可检索，档案管理员可录入审核）
• 步骤2：进入【用户管理】，创建用户绑定对应角色，设置所属部门，默认部门用户仅可查看本部门提交的档案，跨部门查看需提交授权申请
• 所有录入、下载、修改操作均会记录在【操作日志】中，日志不可删除，可追溯所有操作行为

四、常见问题排查与备份

4.1 常见问题排查

• 启动失败：查看logs目录下的启动日志，常见原因为MySQL密码错误、Redis连接失败、存储目录未创建，对应修改配置后重启即可
• 大文件上传失败：检查Nginx配置的client_max_body_size和application.yml中的multipart配置，确保均≥1024M
• 检索不到新增档案：进入【系统管理】-【定时任务】，手动触发一次全文索引同步即可
• 外网无法访问：检查云服务器安全组是否开放80端口，添加入方向80端口允许规则即可

4.2 自动备份配置

创建备份脚本/root/backup.sh，复制以下内容，替换为你的MySQL密码，提前创建/data/backup目录：

```shell !/bin/bash date_str=$(date +%Y%m%d%H%M%S) 备份数据库 mysqldump -uroot -p你的MySQL密码 shuanghe_archive > /data/backup/db_${date_str}.sql 备份档案文件 tar -zcvf /data/backup/file_${date_str}.tar.gz /data/shuanghe-archive/files 删除7天前的备份文件 find /data/backup -mtime +7 -name ".sql" -o -name ".tar.gz" | xargs rm -f ```

添加定时任务，每天凌晨2点执行备份：
执行crontab -e，添加一行：0 2 /bin/bash /root/backup.sh，保存退出即可