事业单位数字档案馆系统部署落地及合规运维全流程实操指南

一、前期准备（避免后续返工的前置校验）

1.1 软硬件配置要求

所有配置需符合事业单位国产化适配及等保2.0三级要求，具体如下：

• 服务器：飞腾FT-2000+/64核、32G以上内存、2T SSD系统盘+8T SATA数据盘
• 操作系统：统信UOS服务器版V20/银河麒麟服务器版V10
• 依赖组件：OpenJDK11、MySQL8.0、Nginx1.24、官方OFD版式处理工具（下载地址：https://www.ofd.cn/download/ofdreader/）

1.2 合规材料准备

提前获取2份必备材料，否则部署完成无法通过档案局验收：

• 当地档案局发布的《数字档案馆建设规范符合性检查清单》
• 本单位正式发布的档案分类编码规则、密级划分标准

二、系统部署实操步骤（可直接复制执行）

2.1 基础环境配置

所有命令均在服务器终端执行，全程使用root权限或加sudo前缀：

步骤1：安装JDK11

``` apt install openjdk-11-jdk -y 验证安装，输出openjdk version "11.0.x"即为成功 java -version ```

步骤2：安装并配置MySQL8.0

``` apt install mysql-server-8.0 -y 执行安全初始化，密码需包含大小写+数字+特殊字符，长度≥8位，符合等保要求 mysql_secure_installation 登录MySQL创建业务库及账号 mysql -uroot -p ```

进入MySQL后执行以下代码，可直接复制修改密码即可：

``` CREATE DATABASE digital_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'archive_user'@'%' IDENTIFIED BY '你的自定义强密码'; GRANT ALL PRIVILEGES ON digital_archive. TO 'archive_user'@'%'; FLUSH PRIVILEGES; exit; ```

步骤3：安装并配置Nginx反向代理

``` apt install nginx -y 新建站点配置文件 vim /etc/nginx/conf.d/archive.conf ```

将以下完整配置复制到文件中，替换服务器IP/域名即可：

``` server { listen 80; server_name 你单位的内网服务器IP/域名; client_max_body_size 10G; 支持大体积档案上传 location / { root /opt/digital_archive/frontend; index index.html index.htm; 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; } } ```

验证配置并重载服务：

``` nginx -t 输出test is successful后执行重载 systemctl reload nginx ```

2.2 业务系统部署

使用国家档案局开源适配的数字档案馆系统，下载地址：https://gitee.com/nationalarchives/digital-archive-system ，下载最新release包后上传到服务器/opt/digital_archive目录。

步骤1：解压并修改后端配置文件

``` unzip digital-archive-release-v1.2.0.zip 编辑生产环境配置文件 vim /opt/digital_archive/backend/application-prod.yml ```

复制以下完整配置，替换对应参数即可：

``` server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/digital_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: archive_user password: 你之前设置的MySQL强密码 servlet: multipart: max-file-size: 10G max-request-size: 10G archive: storage-path: /data/archive_files/ 档案文件存储路径 ofd-tool-path: /usr/local/ofdreader/bin/ofdconvert OFD工具路径 unit-category-code: DA-2024-001 替换为你单位的档案分类编码 ```

步骤2：启动服务

``` 创建存储目录并授权 mkdir -p /data/archive_files chown -R www-data:www-data /data/archive_files 启动后端服务 nohup java -jar /opt/digital_archive/backend/archive-admin.jar --spring.profiles.active=prod > /var/log/archive.log 2>&1 & 验证启动，返回{"code":200,"msg":"success"}即为成功 curl http://127.0.0.1:8080/api/health ```

服务启动后访问服务器IP，默认管理员账号admin，默认密码Admin@2024，首次登录必须强制修改。

三、历史档案数据迁移实操

3.1 结构化台账数据导入

登录系统后台进入【数据导入】模块，下载官方导入模板，按照模板整理历史Excel台账：档号、保管期限、密级三个字段不能为空，密级只能填写公开、内部、秘密、机密、绝密五个固定值，单次导入条数不超过1万条，导入失败可直接下载错误日志定位问题。

3.2 非结构化档案文件批量关联

首先将历史扫描的PDF/JPG文件批量转换为符合档案局要求的OFD格式，执行以下命令批量转换：

``` 替换为你历史档案存放的路径，转换后的文件自动存入档案存储目录 find /your/old/archive/path -name ".pdf" -exec /usr/local/ofdreader/bin/ofdconvert {} /data/archive_files/ \; ```

转换完成后进入系统后台【文件关联】模块，选择按档号批量匹配，系统会自动将OFD文件关联到对应台账条目，无需手动上传。

四、合规配置及验收准备

4.1 等保2.0合规配置

进入【系统设置-安全设置】页面完成以下配置：

• 开启双因子认证，所有用户登录需验证账号密码+手机验证码
• 密码过期时间设置为90天，连续5次登录失败锁定账号30分钟
• 开启全量操作日志留存，留存时间设置为180天以上

4.2 档案局验收材料准备

系统自带验收材料生成功能，进入【系统工具-验收报告】模块可直接导出：

• 数字档案馆系统功能符合性测试报告
• 档案数据全量校验报告（需确保数据校验通过率100%）
• 运维管理制度模板可在前面的Gitee仓库doc目录直接下载，替换单位名称即可使用

五、常见卡点排查方案

• 大文件上传失败：检查Nginx的client_max_body_size参数、Spring的multart参数是否都设置为10G以上
• OFD预览失败：执行命令/usr/local/ofdreader/bin/ofdconvert -v，确认工具可正常输出版本号，同时检查配置文件中ofd-tool-path路径是否正确
• 数据导入失败：下载错误日志，重点检查是否存在档号重复、密级字段不符合规范、必填字段为空的问题