安康数字档案馆系统本地化部署、功能配置与日常运维实操全指南

一、部署前环境准备

1. 硬件配置要求

最低配置：2核4G CPU、500G SSD存储、10M公网带宽；推荐配置：4核8G CPU、2T SSD存储、20M公网带宽，满足100人同时访问、100万份档案存储需求。

2. 软件环境安装

操作系统优先选择CentOS7.9或Ubuntu22.04，以下为CentOS7.9环境下依赖安装命令，可直接复制执行：

``` 升级系统源 yum update -y 安装基础工具 yum install wget vim net-tools -y 安装MySQL8.0 yum install https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm -y yum install mysql-community-server -y systemctl start mysqld && systemctl enable mysqld 安装JDK11 yum install java-11-openjdk -y 安装MinIO文件存储 wget https://dl.min.io/server/minio/release/linux-amd64/minio -P /usr/local/bin/ chmod +x /usr/local/bin/minio 安装LibreOffice用于档案预览 yum install libreoffice -y ```

依赖安装完成后需开放服务器端口：8080（系统访问）、9000（MinIO文件存储）、3306（数据库，仅内网开放即可）

二、系统部署实操步骤

1. 安装包获取与解压

执行以下命令获取官方稳定版安装包：

``` wget https://gitee.com/ankang-digital-archive/archive-system/releases/download/v1.2.0/archive-system-v1.2.0.tar.gz -P /opt/ cd /opt && tar zxvf archive-system-v1.2.0.tar.gz ```

2. 数据库初始化

登录MySQL执行以下命令创建库并导入初始数据：

``` 登录MySQL（初始密码可通过grep 'temporary password' /var/log/mysqld.log查看） mysql -uroot -p 执行建库命令 CREATE DATABASE archive_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE archive_db; 导入初始表结构与数据 source /opt/archive-system/sql/init.sql; exit; ```

3. 配置文件修改

进入配置文件目录`cd /opt/archive-system/config`，编辑application.yml文件，完整可复制配置如下，仅需修改标注的自定义参数即可：

``` server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/archive_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 替换为你的MySQL密码 servlet: multipart: max-file-size: 100MB max-request-size: 100MB minio: endpoint: http://替换为你的服务器IP:9000 accessKey: minioadmin secretKey: 替换为你设置的MinIO密码 bucketName: archive-file ocr: baidu: appId: 替换为百度OCR的AppID apiKey: 替换为百度OCR的APIKey secretKey: 替换为百度OCR的SecretKey openoffice: path: /usr/lib64/libreoffice/program/soffice ```

4. 服务启动与验证

先启动MinIO服务：

``` mkdir -p /opt/minio/data nohup minio server /opt/minio/data --console-address ":9001" > /opt/minio/minio.log 2>&1 & ```

访问http://服务器IP:9001，用默认账号minioadmin/minioadmin登录，创建名为archive-file的存储桶，设置桶权限为私有。

再启动数字档案馆系统：

``` cd /opt/archive-system mkdir logs nohup java -jar archive-system.jar > logs/start.log 2>&1 & ```

执行`curl http://127.0.0.1:8080/actuator/health`返回UP即为启动成功，访问http://服务器IP:8080即可进入系统，默认管理员账号：admin，默认密码：Admin@123456，登录后请立即修改密码。

三、核心功能配置实操

1. 档案分类配置

登录系统后进入【系统管理-档案类目管理】，点击新增按钮，填写类目编码（全局唯一）、类目名称、保管期限（永久/30年/10年）、归档范围描述，必须勾选“启用”状态后保存，否则无法上传对应类目档案，支持多级类目配置，最多支持5级分类。

2. 权限规则配置

进入【系统管理-角色管理】，可新增普通用户、档案管理员、系统管理员三类角色，给对应角色分配权限：普通用户仅分配“档案预览、档案检索”权限，档案管理员分配“档案上传、档案审核、档案借阅审批”权限，涉密档案权限需单独勾选“涉密档案访问”权限，普通用户默认无访问权限。

3. OCR识别配置

如需自动识别扫描件文字生成全文检索标签，可到https://ai.baidu.com/tech/ocr/general申请免费OCR额度，获取AppID、APIKey、SecretKey后填入之前的配置文件，重启系统即可生效，支持JPG、PNG、PDF格式扫描件的文字识别。

四、日常运维与常见问题解决

1. 定期备份操作

创建数据库自动备份脚本`vim /opt/backup/db_backup.sh`，内容如下：

``` !/bin/bash 备份数据库 mysqldump -uroot -p你的MySQL密码 archive_db > /opt/backup/archive_db_$(date +%Y%m%d).sql 删除30天前的备份文件 find /opt/backup -mtime +30 -name ".sql" -delete 备份MinIO文件 rsync -av /opt/minio/data/archive-file /opt/backup/file_$(date +%Y%m%d)/ ```

执行`chmod +x /opt/backup/db_backup.sh`，然后添加定时任务：执行`crontab -e`，添加`0 2 /opt/backup/db_backup.sh`，即可每天凌晨2点自动备份数据。

2. 常见问题排查

• 档案上传失败：首先检查MinIO服务是否正常运行，其次检查文件大小是否超过配置的100M上限，修改application.yml中的max-file-size参数即可；
• Office档案预览失败：检查LibreOffice是否安装成功，确认配置文件中openoffice.path路径正确；
• 系统访问卡顿：执行`top`命令查看内存占用，超过80%的话调整系统启动命令为`nohup java -Xms2G -Xmx2G -jar archive-system.jar > logs/start.log 2>&1 &`重启即可。