海南藏族自治州档案管理系统本地化部署与日常操作实操指南

一、部署前置准备

1.1 硬件要求

针对海南州州县两级档案管理需求，服务器配置最低要求如下：

• CPU：8核16线程及以上
• 内存：32G及以上
• 存储：2T SSD及以上（用于存储档案扫描件、电子件）
• 操作系统：CentOS7.9 或 统信UOS服务器版V20（符合信创要求）

1.2 软件依赖清单

所有依赖均可以通过官方yum源直接安装，无需额外下载离线包：

• JDK 1.8
• MySQL 8.0
• Redis 6.x
• Nginx 1.20及以上

二、系统部署实操步骤

2.1 基础环境安装

依次执行以下命令安装所有依赖：

安装JDK1.8

``` yum install -y java-1.8.0-openjdk-devel 验证安装成功 java -version 输出openjdk version "1.8.0_xxx"即为成功 ```

安装MySQL8.0

``` 导入MySQL官方yum源 rpm -ivh https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm 安装服务 yum install -y mysql-community-server --nogpgcheck 启动并设置开机自启 systemctl start mysqld && systemctl enable mysqld 获取初始密码 grep 'temporary password' /var/log/mysqld.log 登录MySQL修改密码并创建业务库 mysql -uroot -p'初始密码' ALTER USER 'root'@'localhost' IDENTIFIED BY 'Hnzz@2024Archive'; CREATE DATABASE hnzz_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'archive_user'@'%' IDENTIFIED BY 'Archive@2024_Hnzz'; GRANT ALL PRIVILEGES ON hnzz_archive. TO 'archive_user'@'%'; FLUSH PRIVILEGES; exit; ```

安装Redis与Nginx

``` yum install -y redis nginx systemctl start redis && systemctl enable redis systemctl start nginx && systemctl enable nginx ```

2.2 系统包部署与配置

1. 下载系统安装包：登录http://hnzz.qinghai.gov.cn/xxgk/xzfw/ggxz/（海南州政务服务网公共下载板块），搜索「档案管理系统部署包V2.3」下载，上传至服务器/opt/archive目录

2. 解压安装包：

``` mkdir -p /opt/archive /data/archive_files chmod 755 /data/archive_files cd /opt/archive unzip archive-system-v2.3.zip ```

3. 修改后端配置文件application.yml，完整可复制配置如下：

``` server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/hnzz_archive?useUnicode=true&characterEncoding=utf8mb4&useSSL=false&serverTimezone=Asia/Shanghai username: archive_user password: Archive@2024_Hnzz driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 database: 0 servlet: multipart: max-file-size: 50MB max-request-size: 50MB archive: file-storage-path: /data/archive_files area-code: 632500 海南州行政区划编码 enable-tibetan-search: true 开启藏文检索 ```

4. 启动后端服务：

``` nohup java -jar archive-system.jar > /var/log/archive-system.log 2>&1 & 验证启动成功 tail -f /var/log/archive-system.log 输出「Started ArchiveSystemApplication in X seconds」即为启动成功 ```

5. 配置Nginx反向代理，编辑/etc/nginx/conf.d/archive.conf，完整配置如下：

``` server { listen 80; server_name 你的服务器IP或绑定的域名; root /opt/archive/dist; 前端静态文件目录 index index.html; client_max_body_size 50M; location /api { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ```

验证配置并生效：nginx -t && nginx -s reload

2.3 系统初始化配置

访问服务器IP或域名，初始登录账号密码：admin / hnzz@2024archive

• 第一步：立即修改管理员默认密码，路径：个人中心-修改密码
• 第二步：配置行政区划，路径：系统管理-行政区划管理，批量导入海南州下辖5县编码：共和632521、同德632522、贵德632523、兴海632524、贵南632525
• 第三步：配置档案分类，路径：档案管理-分类配置，除通用档案分类外，按需新增藏文档案、生态保护档案、宗教事务档案等海南州特色分类

三、日常操作实操指南

3.1 档案录入操作

• 强制要求：先上传档案扫描件，再填写元数据，扫描件要求分辨率300DPI，格式为PDF/JPG，单文件不超过50M
• 藏文档案需同时填写藏、汉双语元数据，涉密档案需标注密级，仅对应权限用户可查看
• 录入完成后提交审核，审核权限归属对应区县档案局管理员账号，审核通过后档案正式入库

3.2 档案查询操作

• 普通用户仅可查询公开级档案，涉密档案查询需提交用途说明，经管理员审批通过后方可查看
• 支持按档案编号、题名、归档年代、所属机构多维度筛选，藏文档案支持藏文关键词精准检索
• 查询到的电子档案可在线预览，如需下载需提交借阅申请

3.3 档案借阅操作

• 线上提交借阅申请，填写借阅用途、预计归还时间，实体档案需标注取件人身份证信息
• 管理员1个工作日内完成审批，审批通过后可下载电子档案或到指定库房领取实体档案
• 归还时需核验档案完整度，线上提交归还登记，超期未还系统自动发送提醒给借阅人

四、常见问题排查

• 系统无法登录：首先执行ps -ef | grep java查看后端服务是否运行，若进程不存在重新执行启动命令；其次检查MySQL、Redis服务是否正常运行，端口是否可访问
• 档案上传失败：检查/data/archive_files目录权限是否为755，单文件大小是否超过50M，Nginx配置中client_max_body_size参数是否设置为50M
• 藏文检索无结果：检查MySQL数据库hnzz_archive的字符集是否为utf8mb4，application.yml中enable-tibetan-search参数是否设置为true