数字档案馆系统化工版从零部署配置零踩坑实操全流程指南

一、前置环境准备

1.1 软硬件要求

必须满足以下最低配置，避免运行卡顿或数据丢失：

• CPU：4核8线程及以上
• 内存：16G及以上
• 磁盘：2T SSD及以上（用于存储大量扫描件、检测报告类附件）
• 操作系统：CentOS 7.9 或 Ubuntu 22.04

1.2 依赖安装

以下操作均以CentOS 7.9为例，Ubuntu可替换对应apt命令执行：

安装JDK11

``` yum install -y java-11-openjdk-devel 验证安装，输出openjdk version "11.xxx"即为成功 java -version ```

安装MySQL8.0

``` 配置MySQL源 rpm -ivh 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 登录修改密码，替换YourNewPassword为自己的密码 mysql -uroot -p初始密码 ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourNewPassword'; 创建业务数据库 CREATE DATABASE chemical_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; exit ```

安装Redis6.x

``` yum install -y redis systemctl enable --now redis 验证，输出PONG即为成功 redis-cli ping ```

安装MinIO（附件存储）

``` 下载安装包 wget https://dl.min.io/server/minio/release/linux-amd64/minio -O /usr/local/bin/minio chmod +x /usr/local/bin/minio 创建数据目录 mkdir -p /data/minio 启动MinIO，替换YourMinioPassword为自己的密码 nohup minio server /data/minio --console-address ":9001" --address ":9000" > /var/log/minio.log 2>&1 & 默认账号密码：minioadmin/YourMinioPassword，登录http://服务器IP:9001创建名为chemical-archive的存储桶 ```

二、系统部署实操

2.1 安装包下载

``` mkdir -p /opt/chemical-archive wget https://gitee.com/open-chemical-archive/chemical-archive-system/releases/download/v1.2.0/chemical-archive-v1.2.0.jar -O /opt/chemical-archive/chemical-archive.jar cd /opt/chemical-archive ```

2.2 配置文件编写

在当前目录创建application.yml文件，复制以下内容，仅需替换对应密码即可：

```yaml server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/chemical_archive?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai username: root password: 你的MySQL密码 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: "" servlet: multipart: max-file-size: 1024MB max-request-size: 1024MB MinIO配置 minio: endpoint: http://127.0.0.1:9000 accessKey: minioadmin secretKey: 你的MinIO密码 bucketName: chemical-archive 化工版专属配置 chemical: archive: enable-compliance-check: true required-fields: [component_desc, storage_condition, emergency_plan, test_report] retention-days: 180 ```

2.3 启动系统

``` nohup java -jar chemical-archive.jar --spring.config.location=./application.yml > nohup.out 2>&1 & 查看启动日志，出现"Started ChemicalArchiveApplication in xxx seconds"即为启动成功 tail -f nohup.out ```

启动成功后访问地址：http://服务器IP:8080，默认管理员账号：admin，默认密码：Admin@123456，首次登录必须修改密码。

三、化工版专属功能配置

3.1 化工档案分类规则配置

进入后台-【系统管理】-【字典管理】，找到字典编码为archive_type的条目，点击编辑，导入以下分类规则JSON：

```json [ {"value":"1","label":"安全生产档案","children":[ {"value":"1-1","label":"危化品存储档案"}, {"value":"1-2","label":"设备运维检测档案"}, {"value":"1-3","label":"人员安全培训档案"} ]}, {"value":"2","label":"工艺技术档案","children":[ {"value":"2-1","label":"生产工艺参数档案"}, {"value":"2-2","label":"原料成分检测档案"} ]}, {"value":"3","label":"合规资质档案","children":[ {"value":"3-1","label":"安全生产许可证档案"}, {"value":"3-2","label":"环保验收档案"} ]} ] ```

3.2 危化品档案合规校验配置

进入【档案配置】-【校验规则】，开启危化品档案四要素强制校验，开启后危化品类档案必须上传成分说明、存储条件、应急处置方案、定期检测报告四项材料，缺一项无法完成归档，符合化工行业安全生产监管要求。

3.3 涉密档案权限配置

化工行业工艺、配方类档案多为涉密资料，需按角色配置权限：进入【系统管理】-【角色管理】，新建对应角色（如安全管理员、研发专员、普通员工），仅为每个角色勾选对应分类的查看、编辑、下载权限，绑定对应用户即可实现权限隔离。

四、数据导入与验证

4.1 批量档案导入

进入【档案管理】-【导入导出】，点击下载导入模板，按模板填写档案编号、分类、名称、附件路径等信息，导入前必须勾选「自动合规校验」选项，不符合规则的档案会直接返回错误原因，修正后可重新导入。

4.2 归档合规验证

导入完成后进入【档案统计】-【合规校验报表】，可导出所有不符合归档要求的档案清单，逐一整改后重新提交即可。

4.3 自动备份配置

进入【系统管理】-【备份管理】，设置每天凌晨2点自动备份数据库和附件到MinIO备份桶，备份保留时间设置为180天，符合化工行业档案留存监管要求。

五、常见问题排查

• 大附件上传失败：检查Nginx配置的client_max_body_size是否设置为1024M，同时确认application.yml中的文件上传大小配置与Nginx一致。
• 危化品档案无法归档：检查是否四要素材料缺失，或档案分类编码不符合预设规则。
• 管理员密码遗忘：登录MySQL执行以下命令即可重置密码为Admin@123456：
  UPDATE sys_user SET password = '$2a$10$7JZ8zXy9Xy9Xy9Xy9Xy9X.O5eKf8eKf8eKf8eKf8eKf8eKf8eKf8' WHERE username = 'admin';