任务数字档案馆系统从零部署到功能落地全流程实操指南

一、前置环境准备

1. 服务器要求

最低配置2核4G云服务器，操作系统CentOS7.9及以上，提前在安全组开放80（WEB访问）、3306（MySQL）、9200（ElasticSearch）端口。

2. 依赖组件安装

所有依赖组件安装命令可直接复制执行：

（1）JDK1.8安装

``` yum install -y java-1.8.0-openjdk-devel 验证安装，正常返回openjdk version "1.8.0_xxx"即安装成功 java -version ```

（2）MySQL5.7安装

``` 下载MySQL官方源 wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm 安装源 rpm -ivh mysql57-community-release-el7-11.noarch.rpm 安装MySQL服务 yum install -y mysql-community-server --nogpgcheck 启动服务并设置开机自启 systemctl start mysqld systemctl enable mysqld 获取初始登录密码 grep 'temporary password' /var/log/mysqld.log 登录数据库修改密码，替换下方的初始密码和自定义密码 mysql -uroot -p'你获取的初始密码' ALTER USER 'root'@'localhost' IDENTIFIED BY '自定义密码（需包含大小写、数字、特殊符号）'; 创建系统专用数据库 create database task_archive default charset utf8mb4; exit; ```

（3）ElasticSearch7.6.2安装（用于全文检索）

``` 下载安装包 wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.6.2-linux-x86_64.tar.gz 解压 tar -zxvf elasticsearch-7.6.2-linux-x86_64.tar.gz 创建普通运行用户（ES禁止root账号启动） useradd es chown -R es:es elasticsearch-7.6.2 修改核心配置 vim elasticsearch-7.6.2/config/elasticsearch.yml 找到对应配置项修改为如下内容 network.host: 0.0.0.0 discovery.seed_hosts: ["127.0.0.1"] 切换用户启动ES su es cd elasticsearch-7.6.2/bin ./elasticsearch -d 验证启动成功，返回JSON格式版本信息即为正常 curl 127.0.0.1:9200 ```

二、系统部署实操

1. 安装包下载

直接执行以下命令下载官方稳定版安装包：

``` wget https://github.com/opensource-task-archive/task-archive-system/releases/download/v1.2.0/task-archive-v1.2.0.jar ```

2. 配置文件编写

在安装包同级目录创建application.yml文件，内容如下，仅需修改MySQL密码为你自己设置的密码即可：

```yaml server: port: 80 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/task_archive?useUnicode=true&characterEncoding=utf8mb4&useSSL=false&serverTimezone=GMT%2B8 username: root password: 你的MySQL自定义密码 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 100MB max-request-size: 100MB elasticsearch: rest: uris: http://127.0.0.1:9200 file: save-path: /data/task-archive/files ```

执行以下命令创建文件存储目录：

``` mkdir -p /data/task-archive/files chmod 755 /data/task-archive/files ```

3. 启动系统

执行后台启动命令：

``` nohup java -jar task-archive-v1.2.0.jar --spring.config.location=./application.yml & ```

执行`tail -f nohup.out`查看启动日志，出现`Started TaskArchiveApplication in xx seconds`即为启动成功，在浏览器输入服务器公网IP即可访问系统。

三、核心功能初始化配置

1. 账号初始化

默认管理员账号：admin，默认密码：123456，首次登录必须修改强密码，避免数据泄露。

2. 档案分类配置

登录后依次进入【系统管理】-【档案分类】，点击「新增」，填写分类编码、分类名称、存储期限，例如任务执行档案编码设置为TASK-001，存储期限设置为3年，勾选「启用」后保存即可，可根据业务需求新增多个分类。

3. 扫描件OCR识别配置（可选）

如果需要自动提取扫描件、图片中的文字内容，访问https://cloud.baidu.com/product/ocr_general 开通通用文字识别服务，获取API Key和Secret Key，依次进入【系统设置】-【第三方接口】填入对应参数并保存即可。

四、常见问题排查

1. 系统启动失败报数据库连接错误

优先排查3个点：①服务器安全组是否开放3306端口；②配置文件中MySQL账号密码是否正确；③是否已创建utf8mb4编码的task_archive数据库。

2. 档案上传失败

优先排查2个点：①`/data/task-archive/files`目录权限是否为755；②服务器磁盘剩余空间是否足够，若需要上传大于100M的文件，修改配置文件中`spring.servlet.multipart.max-file-size`参数后重启系统即可。

3. 全文检索无结果

首次启动系统需要手动执行索引重建，依次进入【系统管理】-【索引重建】，等待重建完成（10万条数据约需5分钟）后再执行检索操作即可。

五、数据备份方案

1. 数据库自动备份

创建备份目录：`mkdir -p /data/backup`，执行`crontab -e`添加定时任务，每天凌晨1点自动备份数据库：

``` 0 1 mysqldump -uroot -p'你的MySQL密码' task_archive > /data/backup/task_archive_$(date +\%Y\%m\%d).sql ```

2. 附件自动备份

同样在crontab中添加以下定时任务，每天凌晨2点自动备份档案附件：

``` 0 2 rsync -av /data/task-archive/files /data/backup/files_$(date +\%Y\%m\%d) ```

建议定期将备份文件同步到异地存储，避免服务器故障导致数据丢失。