梅州本地化档案管理系统从零搭建部署及日常运维实操指南

一、前期准备（适配梅州本地化规范要求）

1.1 硬件环境要求

满足梅州市政务档案管理等保2级要求，中小单位推荐配置：2核4G CPU/8G内存/1T以上SSD硬盘，可选用梅州政务云服务器或本地物理服务器，公网带宽不低于10M。

1.2 软件依赖清单

所有依赖均为稳定版，可直接复制链接下载或执行命令安装：

• JDK1.8：官方镜像下载地址
• MySQL8.0：官方下载地址
• Redis6.2：官方下载地址
• Nginx1.24：直接执行yum install -y nginx安装
• 系统适配包：梅州档案管理系统v1.0.0适配包

二、系统部署实操步骤

2.1 基础环境配置

以下操作均基于CentOS7系统，其他系统可对应调整命令：

① JDK安装

执行命令：yum install -y java-1.8.0-openjdk-devel，安装完成后执行java -version，返回版本号为1.8.x即为成功。

② MySQL安装与配置

```shell 配置MySQL源 rpm -ivh https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm 安装MySQL yum install -y mysql-community-server --nogpgcheck 启动服务并设置开机自启 systemctl start mysqld && systemctl enable mysqld 获取初始密码 grep 'temporary password' /var/log/mysqld.log ```

登录MySQL后执行以下命令修改密码并创建业务库：

```sql ALTER USER 'root'@'localhost' IDENTIFIED BY '自定义密码（需包含大小写、数字、特殊字符）'; CREATE DATABASE mz_dms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; FLUSH PRIVILEGES; ```

③ Redis安装与配置

```shell 安装编译依赖 yum install -y gcc make 下载解压安装包 wget https://download.redis.io/releases/redis-6.2.7.tar.gz && tar -zxvf redis-6.2.7.tar.gz && cd redis-6.2.7 编译安装 make && make install 修改配置文件：将daemonize改为yes，requirepass设置为自定义密码 vim redis.conf 启动Redis src/redis-server redis.conf ```

2.2 系统配置文件修改

创建/opt/mz-dms目录，将下载的mz-dms.jar上传到该目录，同时新建application.yml配置文件，内容可直接复制修改：

```yaml server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/mz_dms?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false username: root password: 你设置的MySQL密码 redis: host: 127.0.0.1 port: 6379 password: 你设置的Redis密码 梅州档案本地化配置 mz: archive: standard: 2023 固定为2023，适配梅州现行归档规范，禁止修改 auto-report: false 开启后审核通过的档案自动报送市档案馆 政务SSO配置（可选，需要对接统一身份认证时填写） sso: mz: enable: false url: https://sso.meizhou.gov.cn/auth client-id: 你单位向市政数局申请的客户端ID client-secret: 你单位向市政数局申请的客户端密钥 ```

注意：mz.archive.standard参数必须固定为2023，否则无法通过梅州市档案馆的归档校验。

2.3 服务启动与验证

执行启动命令：nohup java -jar /opt/mz-dms/mz-dms.jar > /opt/mz-dms/run.log 2>&1 &

等待1分钟后，访问http://服务器IP:8080，默认账号admin，默认密码MzDms@2024，登录成功即为部署完成。如需配置域名访问，在/etc/nginx/conf.d目录下新建mz-dms.conf，内容如下：

```nginx server { listen 80; server_name 你的域名; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } ```

执行nginx -t验证配置无误后，执行nginx -s reload生效。

三、日常操作实操指南

3.1 档案录入操作

登录系统后进入「档案录入」模块，选择对应档案分类（系统已内置梅州规范的文书、科技、人事、会计、专业5大类，无需自行配置），上传扫描件要求单张分辨率不低于300DPI，格式为PDF/A，单个文件大小不超过500M，录入必填字段后点击保存，自动进入待审核队列。

3.2 归档校验与报送

进入「归档校验」模块，选择要报送的批次，点击「本地校验」，系统会自动按照梅州市档案馆2023版规范校验，错误项会明确标注修改指引，修改完成后点击「报送」，直接同步到梅州市档案馆接收系统，无需线下提交材料。

3.3 日常运维备份

新建/opt/backup目录，创建自动备份脚本backup.sh，内容如下：

```shell !/bin/bash mysqldump -u root -p'你的MySQL密码' mz_dms > /opt/backup/mz_dms_$(date +%Y%m%d).sql 清理30天前的备份文件 find /opt/backup -mtime +30 -name ".sql" -delete ```

执行crontab -e添加定时任务：0 2 /opt/backup/backup.sh，实现每日凌晨2点自动备份。

四、常见问题排查

• 部署启动失败：查看/opt/mz-dms/run.log日志，90%的问题为数据库/Redis密码配置错误、端口被占用，对应修改配置文件重启即可。
• 归档校验不通过：点击错误提示中的「查看规范」，直接跳转到梅州市档案馆官方规范说明页面，对照修改即可，常见问题为档案分类错误、必填字段缺失。
• 政务SSO对接失败：首先检查client-id和client-secret是否正确，执行telnet sso.meizhou.gov.cn 443验证网络连通性，不通的话联系梅州政务云运维开通白名单即可。
• 扫描件上传失败：检查文件格式是否为PDF/A，大小是否超过500M，调整后重新上传即可。