桂林数字档案馆系统本地部署、核心功能配置与数据迁移实操指南

前置环境准备

所有操作均基于CentOS7.9系统，如需适配其他系统可直接替换对应包管理命令，硬件最低要求2核4G内存、1T机械硬盘，如需支撑100人以上同时访问需升级到4核8G配置。

依赖软件安装

依次执行以下命令完成基础依赖安装，所有版本均为官方验证适配版，不要自行替换高版本避免兼容性问题：

• JDK1.8安装：yum install -y java-1.8.0-openjdk-devel
• MySQL8.0安装：yum install -y mysql-server && systemctl enable --now mysqld
• Redis6.x安装：yum install -y redis && systemctl enable --now redis
• Nginx1.24安装：yum install -y nginx && systemctl enable --now nginx

系统安装包获取

直接下载官方适配的稳定版安装包：wget https://gui-lin-da.gov.cn/soft/archive-system-v2.3.1.tar.gz

系统部署实操步骤

步骤1：解压安装包

执行命令解压到指定目录：tar -zxvf archive-system-v2.3.1.tar.gz -C /opt/

步骤2：配置数据库

登录MySQL执行以下语句，完成库表创建和授权，密码需替换为自定义强密码：

```sql CREATE DATABASE archive_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER 'archive_user'@'%' IDENTIFIED BY 'Archive@2024GL'; GRANT ALL PRIVILEGES ON archive_db. TO 'archive_user'@'%'; FLUSH PRIVILEGES; -- 导入初始库表结构 source /opt/archive-system/sql/init.sql; ```

步骤3：修改应用配置文件

打开/opt/archive-system/config/application.yml文件，替换以下内容，可直接复制使用：

```yaml server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/archive_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: archive_user password: Archive@2024GL 和上文设置的数据库密码保持一致 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: "" 如有设置Redis密码请填写 servlet: multipart: max-file-size: 10GB 支持大体积档案上传 max-request-size: 10GB file: storage-path: /data/archive-files/ 档案文件存储路径，需提前创建该目录 ```

执行命令创建文件存储目录：mkdir -p /data/archive-files && chmod 755 /data/archive-files

步骤4：启动服务并配置反向代理

• 启动系统服务：cd /opt/archive-system/bin && chmod +x startup.sh && ./startup.sh
• 验证启动状态：执行curl http://localhost:8080/actuator/health，返回{"status":"UP"}即为启动成功
• 配置Nginx反向代理，将以下内容写入/etc/nginx/conf.d/archive.conf文件：

```nginx server { listen 80; server_name 你的服务器公网IP或绑定域名; client_max_body_size 10G; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } location /static { alias /opt/archive-system/static; expires 7d; } } ```

执行nginx -s reload重载配置，访问对应IP/域名即可进入系统，默认管理员账号admin、密码Admin@123456，登录后必须第一时间修改管理员密码，避免未授权访问。

核心功能配置实操

档案分类规则配置

登录后台进入【系统管理-基础配置-档案分类】，按照桂林本地档案管理规范添加4大类分类：文书档案、科技档案、城建档案、民生档案，每个分类按需配置元数据字段，比如民生档案需添加身份证号、业务办理时间、办结状态字段，必须开启“元数据强制校验”开关，避免不符合规范的档案入库。

OCR识别功能配置

进入【系统设置-接口配置-OCR服务】，填入桂林政务云官方OCR接口地址：https://api.glzwfw.gov.cn/ocr/v1/identify，接口密钥需提前在桂林政务服务开放平台提交系统应用申请，3个工作日内会下发。配置完成后上传一张JPG格式的纸质档案扫描件测试，识别准确率达99%以上即为配置成功。

权限分级配置

进入【系统管理-角色管理】，创建4类标准角色，按以下规则分配权限：

• 系统管理员：全权限，仅分配给2名核心运维人员
• 档案录入员：仅可上传、编辑未审核的档案
• 档案审核员：仅可审核、归档已提交的档案，不可修改档案内容
• 公众查询员：仅可查看脱敏后的档案摘要，必须禁止下载、导出原始档案权限，避免数据泄露

存量档案数据迁移实操

步骤1：旧数据清洗

旧系统导出的Excel档案数据需先清洗，可直接使用以下Python脚本完成标准化处理，执行前需安装pandas依赖：pip3 install pandas openpyxl

```python import pandas as pd 读取旧档案数据 df = pd.read_excel("old_archive.xlsx") 统一日期格式为YYYY-MM-DD df["form_date"] = pd.to_datetime(df["form_date"], errors="coerce").dt.strftime("%Y-%m-%d") 身份证号18位校验 df["id_card_valid"] = df["id_card"].apply(lambda x: len(str(x).strip()) == 18 if pd.notna(x) else True) 去重：同一档案号+同一形成时间视为重复，保留最新版本 df = df.drop_duplicates(subset=["archive_no", "form_date"], keep="last") 导出清洗后数据 df.to_excel("cleaned_archive.xlsx", index=False) ```

清洗完成后删除校验不通过的数据，修改后再重新校验。

步骤2：批量导入

进入【档案管理-批量导入】，选择清洗后的Excel文件，必须先勾选“导入前数据校验”选项，校验通过率100%后再点击正式导入，如有错误可导出错误清单，修改后重新上传校验。

步骤3：迁移校验

导入完成后随机抽取1%的档案，核对元数据信息、附件内容是否匹配，确保迁移零错误。

常见问题排查

• 服务启动失败：查看/opt/archive-system/logs/application.log文件，搜索ERROR关键词即可定位问题，90%以上是配置文件参数填写错误导致
• OCR识别失败：查看接口返回码，401为密钥错误，429为调用频率超限，将系统OCR调用频率调整为每秒5次即可
• 大文件上传失败：检查Nginx和应用配置的上传大小限制是否一致，且不小于上传文件体积

安全操作注意事项

• 涉密档案全流程必须在涉密内网操作，禁止上传至公网服务器
• 所有操作日志系统默认保留180天，符合档案管理规范，不要自行修改日志保留时长
• 每周执行一次全量数据备份，备份文件需存储到异地离线介质，避免数据丢失