乌海档案软件从零开始部署与配置全流程实操指南

一、环境基础依赖安装

在部署乌海档案软件之前，必须确保服务器环境干净且依赖版本匹配。本指南基于CentOS 7.9操作系统进行演示，其他Linux发行版命令略有不同。我们需要安装JDK 1.8环境，这是档案系统运行的基础。

执行以下命令创建Java目录并下载JDK：

• 创建目录：mkdir -p /usr/java
• 下载安装包：wget --no-check-certificate --no-cookies --header "Cookie: oraclelicense=accept-securebackup-cookie" https://download.oracle.com/otn-pub/java/jdk/8u202-b08/1961070e7c544e438950f23f0e0b0b3c/jdk-8u202-linux-x64.tar.gz

下载完成后，解压并配置环境变量：

• 解压文件：tar -zxvf jdk-8u202-linux-x64.tar.gz -C /usr/java
• 配置全局变量：执行 vim /etc/profile，在文件末尾添加以下内容：

export JAVA_HOME=/usr/java/jdk1.8.0_202
export JRE_HOME=$JAVA_HOME/jre
export CLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib
export PATH=$JAVA_HOME/bin:$PATH

保存退出后，执行 source /etc/profile 使配置生效。输入 java -version，若显示版本信息则说明JDK安装成功。接着安装Nginx作为前端代理服务器：

• 安装Nginx：yum install -y nginx
• 启动Nginx：systemctl start nginx && systemctl enable nginx

二、数据库环境搭建与初始化

乌海档案软件通常采用MySQL 5.7作为数据存储引擎。为了保证数据一致性，严禁使用MariaDB或MySQL 8.0。首先下载并安装MySQL 5.7的Yum源仓库：

• 安装Yum源：yum localinstall -y https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm
• 安装服务：yum install -y mysql-community-server

启动数据库服务并设置开机自启：

• 启动服务：systemctl start mysqld && systemctl enable mysqld

MySQL 5.7首次启动会生成一个临时密码，我们需要获取它并修改密码。查看临时密码：

• 获取密码：grep 'temporary password' /var/log/mysqld.log

使用该密码登录MySQL：mysql -uroot -p。进入MySQL命令行后，立即修改root密码（注意密码策略必须包含大小写字母、数字和符号）：

ALTER USER 'root'@'localhost' IDENTIFIED BY 'Wuhai@2024Archive';

接下来创建档案软件专用的数据库和用户。执行以下SQL语句：

CREATE DATABASE wuhai_archive_db CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'archive_admin'@'%' IDENTIFIED BY 'Wuhai@Pass2024';
GRANT ALL PRIVILEGES ON wuhai_archive_db. TO 'archive_admin'@'%';
FLUSH PRIVILEGES;

退出数据库，使用新建的用户导入初始化SQL脚本。假设SQL脚本名为 init_schema.sql：

• 导入数据：mysql -uarchive_admin -p'Wuhai@Pass2024' wuhai_archive_db < init_schema.sql

三、后端服务部署与配置

将乌海档案软件的后端Jar包上传至服务器的 /opt/wuhai/application 目录。为了便于管理，我们需要创建Systemd服务文件来管理该服务的启动、停止和重启。

首先创建配置文件目录：

• 创建目录：mkdir -p /opt/w/wuhai/application/config

在 /opt/wuhai/application/config 目录下创建 application-prod.yml 配置文件。这是一个生产环境配置，必须包含数据库连接、文件存储路径等关键信息。完整配置内容如下：

server:
port: 8080
servlet:
context-path: /api
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/wuhai_archive_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
username: archive_admin
password: Wuhai@Pass2024
driver-class-name: com.mysql.jdbc.Driver
hikari:
minimum-idle: 5
maximum-pool-size: 20
file:
upload:
path: /data/wuhai/files
max-size: 500MB
logging:
file:
path: /opt/wuhai/logs
level:
root: INFO

创建Systemd服务文件，执行 vim /etc/systemd/system/wuhai-archive.service，写入以下内容：

[Unit]
Description=Wuhai Archive Application Service
After=syslog.target network.target mysql.service
[Service]
Type=simple
User=root
WorkingDirectory=/opt/wuhai/application
ExecStart=/usr/java/jdk1.8.0_202/bin/java -jar -Dspring.profiles.active=prod /opt/wuhai/application/wuhai-archive.jar
Restart=always
RestartSec=10
StandardOutput=append:/opt/wuhai/logs/stdout.log
StandardError=append:/opt/wuhai/logs/stderr.log
[Install]
WantedBy=multi-user.target

创建文件存储目录并授权：

• 创建目录：mkdir -p /data/wuhai/files && mkdir -p /opt/wuhai/logs
• 授权：chmod -R 755 /data/wuhai/files

重载Systemd并启动服务：

• 重载服务：systemctl daemon-reload
• 启动服务：systemctl start wuhai-archive
• 查看状态：systemctl status wuhai-archive

若状态显示为 active (running)，则后端启动成功。可以使用 tail -f /opt/wuhai/logs/stdout.log 查看实时日志。

四、前端Nginx反向代理配置

前端静态资源通常打包为Dist包。将前端代码解压至 /usr/share/nginx/html/wuhai 目录。接下来修改Nginx配置以支持前端路由和后端API接口转发。

编辑Nginx主配置文件，执行 vim /etc/nginx/nginx.conf，在 http 块中添加以下 server 配置：

server {
listen 80;
server_name archive.wuhai.local;  替换为实际域名或IP
前端静态资源
location / {
root /usr/share/nginx/html/wuhai;
index index.html;
try_files $uri $uri/ /index.html;
}
后端接口代理
location /api {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_connect_timeout 300s;
proxy_send_timeout 300s;
proxy_read_timeout 300s;
}
文件下载代理
location /files {
alias /data/wuhai/files;
autoindex on;
}
}

配置修改完成后，检查Nginx配置语法并重启服务：

• 检查语法：nginx -t
• 重启服务：systemctl restart nginx

五、核心功能模块配置

乌海档案软件的核心在于档案的OCR识别和元数据提取。系统默认集成了Tesseract OCR引擎，需要安装相应的语言包以保证中文识别率。

安装OCR依赖：

• 安装工具：yum install -y tesseract tesseract-langpack-chi-sim

进入系统后台管理界面（通常地址为 http://IP/api/system/login），登录后进入“系统配置”->“参数设置”。在“OCR服务配置”栏中填写以下信息：

• OCR引擎路径：/usr/bin/tesseract
• 语言包代码：chi_sim+eng
• 识别线程数：4

配置文件存储策略。为了防止服务器磁盘爆满，需要配置自动清理回收站。在“存储管理”->“生命周期策略”中设置：

• 回收站保留天数：30
• 临时文件清理间隔：24

必须配置档案的条目规则。在“元数据管理”中导入乌海市标准的档案分类XML文件（通常由上级主管部门提供）。点击“导入元数据模板”，选择XML文件并点击解析，系统会自动生成文书、科技、会计等分类树。

六、系统运维与自动备份

为了保证数据安全，必须配置定时备份脚本。创建一个Shell脚本 /opt/scripts/backup_wuhai.sh：

!/bin/bash
定义变量
BACKUP_DIR="/data/backup"
DATE=$(date +%Y%m%d_%H%M%S)
DB_USER="archive_admin"
DB_PASS="Wuhai@Pass2024"
DB_NAME="wuhai_archive_db"
FILE_DIR="/data/wuhai/files"
创建备份目录
mkdir -p $BACKUP_DIR
备份数据库
mysqldump -u$DB_USER -p$DB_PASS $DB_NAME | gzip > $BACKUP_DIR/db_$DATE.sql.gz
备份文件（仅备份新增和变更，使用rsync）
rsync -avz --delete $FILE_DIR $BACKUP_DIR/files_backup_$DATE
删除7天前的备份
find $BACKUP_DIR -name "db_.sql.gz" -mtime +7 -exec rm -rf {} \;
find $BACKUP_DIR -type d -name "files_backup_" -mtime +7 -exec rm -rf {} \;
echo "Backup completed at $DATE"

赋予脚本执行权限并设置定时任务：

• 赋予权限：chmod +x /opt/scripts/backup_wuhai.sh

编辑Crontab：crontab -e，添加每天凌晨2点执行备份：

0 2    /opt/scripts/backup_wuhai.sh >> /var/log/backup.log 2>&1

配置防火墙规则开放必要端口（80和8080，若仅对内网开放可忽略）：

• 开放端口：firewall-cmd --zone=public --add-port=80/tcp --permanent
• 重载防火墙：firewall-cmd --reload

至此，乌海档案软件已完全部署完毕，且具备自动备份和OCR识别能力，可直接投入使用。