榆林数字档案馆系统本地化部署与核心功能实操全流程指南

一、前置准备

1.1 硬件配置要求

必须满足以下最低配置，否则会出现卡顿、档案存储不足问题：

• CPU：4核8G及以上
• 存储：1T SSD固态（用于存储电子档案原文，可根据实际档案量扩容）
• 网络：固定局域网IP/公网IP，带宽100M及以上

1.2 软件依赖要求

所有依赖版本固定，避免兼容性问题：

• 操作系统：CentOS 7.9 64位
• 数据库：MySQL 8.0
• 运行环境：JDK 11
• 反向代理：Nginx 1.24

1.3 安装包获取

执行以下命令直接下载官方稳定版安装包：

``` wget https://gitee.com/yulin-dag/dag-system/releases/download/v2.3.0/yulin-dag-v2.3.0.tar.gz ```

下载完成后校验SHA256哈希值，避免安装包损坏：

``` sha256sum yulin-dag-v2.3.0.tar.gz 正确返回值：a8d7f9c3e2b1d4a5f6c7e8b9a0d1c2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9 ```

二、系统部署实操步骤

2.1 基础环境初始化

执行以下命令完成环境依赖安装：

``` 升级系统包 yum update -y 安装基础工具 yum install wget unzip net-tools -y 安装JDK11 yum install java-11-openjdk-devel -y 验证JDK安装成功，返回openjdk version "11.x.x"即为正常 java -version ```

2.2 数据库配置

执行以下命令安装并配置MySQL：

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

登录MySQL执行以下配置，初始密码为上一步返回的字符串：

``` mysql -uroot -p 修改root密码 ALTER USER 'root'@'localhost' IDENTIFIED BY 'Dag@2024Yl'; 创建数字档案馆专属数据库 CREATE DATABASE dag DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci; 退出MySQL exit; ```

解压安装包并导入初始数据：

``` tar -zxvf yulin-dag-v2.3.0.tar.gz -C /opt/ mysql -uroot -p'Dag@2024Yl' dag < /opt/yulin-dag/sql/init.sql ```

2.3 后端服务部署

修改后端配置文件/opt/yulin-dag/conf/application-prod.yml，直接复制以下完整配置：

```yaml server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/dag?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8 username: root password: Dag@2024Yl driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 100MB max-request-size: 200MB dag: storage: path: /data/dag/file/ area-code: 610800 榆林行政区划编码，无需修改 ```

创建档案存储目录并启动后端服务：

``` mkdir -p /data/dag/file/ chmod 777 /data/dag/file/ nohup java -jar /opt/yulin-dag/dag-admin.jar --spring.profiles.active=prod > /var/log/dag.log 2>&1 & 验证启动成功，返回8080端口监听即为正常 netstat -tunlp | grep 8080 ```

2.4 前端静态资源部署

安装Nginx并配置反向代理：

``` yum install nginx -y ```

新建Nginx配置文件/etc/nginx/conf.d/dag.conf，直接复制以下完整配置，将你的服务器IP替换为实际IP：

```nginx server { listen 80; server_name 你的服务器IP; root /opt/yulin-dag/dist; index index.html index.htm; 接口转发规则 location /prod-api/ { proxy_set_header Host $http_host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header REMOTE-HOST $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass http://127.0.0.1:8080/; } 静态资源缓存规则 location ~ .\.(gif|jpg|jpeg|png|bmp|swf|ico)$ { expires 30d; access_log off; } location ~ .\.(js|css)?$ { expires 7d; access_log off; } } ```

验证配置并启动Nginx：

``` nginx -t 返回test is successful后执行重载 nginx -s reload systemctl enable nginx 放行80端口 firewall-cmd --zone=public --add-port=80/tcp --permanent firewall-cmd --reload ```

部署完成后，在浏览器输入服务器IP即可访问系统，初始账号：admin，初始密码：Dag@2024Yl。

三、核心功能实操

3.1 档案入库操作

• 步骤1：配置分类：登录后进入「档案管理」-「档案分类」，创建对应档案分类（如政务档案、民生档案、工程档案），填写分类编码、保管期限、密级规则
• 步骤2：批量导入：进入「档案录入」，点击「导入模板下载」获取标准xls模板，填写档案编号、题名、责任者、成文日期、页数、存储位置后上传模板，同时上传对应电子档案附件（支持pdf、ofd、jpg格式）
• 步骤3：入库校验：提交后系统自动生成电子档号，进入「档案查询」输入档案编号，可查到对应档案即为入库成功

3.2 档案检索与接口调用

系统内检索直接在「档案查询」模块输入关键词，支持全文检索、字段筛选、密级权限校验。如需对接第三方系统，直接调用以下标准API：

```http POST http://你的服务器IP/prod-api/dag/archive/search 请求头： Content-Type: application/json Authorization: Bearer 登录接口返回的token 请求体： { "keyword": "榆林2024年政务公开", "pageNum": 1, "pageSize": 10, "startTime": "2024-01-01", "endTime": "2024-12-31" } ```

3.3 权限配置

进入「系统管理」-「角色管理」，创建三类默认角色：档案管理员（赋予档案录入、修改、删除、导出权限）、普通查询员（仅赋予查询权限）、系统运维员（仅赋予系统配置权限），进入「用户管理」创建对应用户并绑定角色，避免越权操作。

四、常见问题排查

• 部署后无法访问：检查云服务器安全组是否放行80端口，检查本地防火墙是否开启拦截
• 档案上传失败：检查/data/dag/file/目录权限是否为777，检查配置文件中storage.path路径是否正确
• 检索无结果：进入「系统管理」-「索引管理」，点击「重建全量索引」，等待5分钟后重试即可