鄂尔多斯档案管理系统本地化部署及日常运维全流程实操指南

一、前置环境准备

部署前需提前完成以下环境配置，所有版本为官方适配稳定版，不要随意更换版本避免兼容性问题：

• 服务器配置：最低2核4G CPU、100G SSD存储，操作系统支持CentOS7.9+/Ubuntu20.04+/Windows Server2019+，政务对接必须使用鄂尔多斯政务外网IP
• 软件依赖：JDK1.8、MySQL8.0、Nginx1.20+

1.1 CentOS环境依赖一键安装命令

直接复制执行以下命令完成依赖安装：

``` 安装JDK1.8 yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel 安装MySQL8.0 yum install -y https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm yum install -y mysql-community-server systemctl start mysqld && systemctl enable mysqld 安装Nginx yum install -y nginx systemctl start nginx && systemctl enable nginx ```

1.2 MySQL核心配置

修改/etc/my.cnf文件，完整配置如下，必须开启lower_case_table_names=1，否则会出现表名大小写不兼容报错：

``` [mysqld] datadir=/var/lib/mysql socket=/var/lib/mysql/mysql.sock log-error=/var/log/mysqld.log pid-file=/var/run/mysqld/mysqld.pid lower_case_table_names=1 character-set-server=utf8mb4 max_allowed_packet=100M ```

修改完成后执行重启命令生效：systemctl restart mysqld

二、系统部署实操

2.1 安装包获取

执行以下命令直接下载官方适配的鄂尔多斯档案管理系统稳定版安装包：

``` wget http://da.ordos.gov.cn/soft/ordos_archive_v2.4.1.tar.gz tar -zxvf ordos_archive_v2.4.1.tar.gz -C /opt/ ```

2.2 数据库初始化

依次执行以下命令完成数据库配置：

``` 登录MySQL，初始密码在/var/log/mysqld.log中搜索temporary password获取 mysql -u root -p 创建专属数据库 CREATE DATABASE ordos_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; 创建专属用户并授权 GRANT ALL ON ordos_archive. TO 'archive_user'@'%' IDENTIFIED BY 'Archive@2024OrdOS'; FLUSH PRIVILEGES; 导入初始表结构 use ordos_archive; source /opt/ordos_archive_v2.4.1/sql/init.sql; exit; ```

2.3 系统配置修改

编辑/opt/ordos_archive_v2.4.1/config/application.yml文件，完整可复制配置如下，加粗部分根据实际情况修改：

```yaml server: port: 8080 servlet: context-path: /ordos_archive spring: datasource: url: jdbc:mysql://你的服务器IP:3306/ordos_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: archive_user password: 你设置的数据库用户密码 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 100MB max-request-size: 100MB 档案文件存储路径 archive: file: storage-path: /data/ordos_archive/files/ 鄂尔多斯政务对接密钥，找当地档案局申请获取 gov: secret: 你单位专属对接密钥 ```

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

``` mkdir -p /data/ordos_archive/files/ chmod 755 /data/ordos_archive/files/ ```

2.4 启动与访问配置

执行启动命令运行系统：

``` cd /opt/ordos_archive_v2.4.1/ nohup java -jar ordos-archive.jar > /var/log/ordos_archive.log 2>&1 & ```

执行tail -f /var/log/ordos_archive.log查看启动日志，出现“启动成功”字样后配置Nginx反向代理，编辑/etc/nginx/conf.d/archive.conf文件，完整配置如下：

``` server { listen 80; server_name 你的服务器IP或域名; location /ordos_archive { proxy_pass http://127.0.0.1:8080/ordos_archive; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ```

执行systemctl restart nginx重启Nginx，访问http://你的IP/ordos_archive即可进入系统，默认账号admin，密码Admin@123456，首次登录必须强制修改密码，复杂度要求8位以上含数字、字母、特殊字符。

三、核心业务实操流程

3.1 档案归档实操

• 登录后进入【档案管理】-【新增档案】，选择系统内置的鄂尔多斯统一档案分类，不要私自创建分类
• 填写档案元数据，全宗号、目录号、案卷号、题名、责任者、成文日期为必填项，全宗号必须和当地档案局分配的一致，否则无法同步到政务平台
• 上传档案附件，支持PDF、JPG、OFD格式，单个文件不超过100MB，扫描件分辨率不低于300DPI
• 点击【提交归档】，系统自动校验元数据合规性，校验通过后进入待审核状态，管理员审核通过后完成归档

3.2 档案调阅实操

• 进入【查询中心】，支持按全宗号、题名、日期、责任者多维度模糊检索，涉密档案仅授权用户可查看检索结果
• 点击目标档案的【调阅申请】，填写调阅原因、预计归还日期，提交后等待档案管理员审批
• 审批通过后可在线查看或下载档案，下载的文件自动添加调阅人姓名、单位、调阅时间水印，不可篡改

3.3 政务同步实操

• 进入【政务对接】-【连通性测试】，确认服务器已接入鄂尔多斯政务外网、对接密钥填写正确，测试连通成功后再进行同步
• 进入【同步管理】，选择要同步的档案批次，点击【批量同步】，系统自动校验档案合规性，不合规的会返回具体错误原因，修改后可重新同步
• 同步完成后可在【同步日志】中查看同步状态，同步成功的档案可在鄂尔多斯全市档案共享平台被授权单位查询调阅

四、常见问题排查

• 启动失败报数据库连接错误：检查3306端口是否开放、数据库用户名密码是否正确、lower_case_table_names参数是否配置为1
• 档案上传失败：检查存储目录是否有写入权限、文件大小是否超过100MB、文件格式是否在支持范围内
• 政务同步失败：检查服务器是否接入政务外网、对接密钥是否正确、档案全宗号是否和分配的一致、必填元数据是否缺失
• 系统访问卡顿：执行top命令查看CPU内存占用，确认服务器配置满足要求，定期清理系统日志和临时文件