吐鲁番数字档案馆系统本地化部署与基础配置实操全指南

一、前置环境准备

1.1 硬件与系统要求

最低配置：CPU≥4核，内存≥8G，系统盘≥100G SSD，数据盘≥500G SSD（单独挂载到/data目录）。推荐操作系统为CentOS7.9（本文所有命令基于CentOS7.9编写，若使用Ubuntu22.04，安装命令替换为apt install 对应包名，防火墙使用ufw管理即可）。

1.2 依赖软件安装

所有依赖均使用官方稳定版，执行以下命令逐一安装：

安装JDK11：

``` yum install -y java-11-openjdk-devel 验证安装结果，输出openjdk version "11.0.xx"即为成功 java -version ```

安装MySQL8.0：

``` 配置MySQL源 rpm -ivh https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm yum install -y mysql-community-server 启动并设置开机自启 systemctl enable --now mysqld 获取初始密码 grep 'temporary password' /var/log/mysqld.log 登录后修改root密码，执行以下SQL语句 ALTER USER 'root'@'localhost' IDENTIFIED BY 'Root@turpan2024'; 创建系统专用库与用户 create database turpan_archives default character set utf8mb4 collate utf8mb4_general_ci; create user 'archives_user'@'%' identified by 'Turpan@2024_archives'; grant all on turpan_archives. to 'archives_user'@'%'; flush privileges; ```

安装Redis6.x：

``` yum install -y epel-release yum install -y redis 编辑/etc/redis.conf，设置密码：requirepass Turpan_redis@2024 systemctl enable --now redis ```

安装Nginx1.24：

``` yum install -y nginx systemctl enable --now nginx ```

二、系统部署实操步骤

2.1 安装包获取与解压

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

``` wget https://archives-release.oss-cn-beijing.aliyuncs.com/turpan-archives-v1.2.0.tar.gz tar -zxvf turpan-archives-v1.2.0.tar.gz cd turpan-archives-v1.2.0 创建日志与存储目录 mkdir -p logs /data/archives/storage/ chmod 755 /data/archives/storage/ ```

2.2 后端配置与启动

编辑config目录下的application.yml文件，完整配置内容如下，可直接复制替换：

```yaml server: port: 8080 servlet: context-path: /archives spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/turpan_archives?useUnicode=true&characterEncoding=utf8mb4&useSSL=false&serverTimezone=Asia/Shanghai username: archives_user password: Turpan@2024_archives redis: host: 127.0.0.1 port: 6379 password: Turpan_redis@2024 database: 1 servlet: multipart: max-file-size: 10GB max-request-size: 10GB 档案文件存储路径 file: storage-path: /data/archives/storage/ ```

执行数据库初始化：

``` mysql -uarchives_user -p'Turpan@2024_archives' turpan_archives < ./init.sql ```

启动后端服务，查看日志确认启动成功：

``` nohup java -jar turpan-archives.jar > ./logs/start.log 2>&1 & 查看日志，出现Started TurpanArchivesApplication in xx seconds即为启动成功 tail -f ./logs/start.log ```

2.3 前端部署与Nginx配置

复制前端文件到Nginx站点目录：

``` mkdir -p /usr/share/nginx/html/archives cp -r ./dist/ /usr/share/nginx/html/archives/ ```

在/etc/nginx/conf.d/目录下新建archives.conf，完整配置如下：

```nginx server { listen 80; server_name 你的服务器公网IP; client_max_body_size 10G; location /archives { root /usr/share/nginx/html; index index.html index.htm; try_files $uri $uri/ /archives/index.html; } location /archives/api/ { proxy_pass http://127.0.0.1:8080/archives/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ```

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

三、基础功能配置

3.1 账号初始化

访问http://你的服务器IP/archives，默认管理员账号：admin，默认密码：Admin@turpan2024，第一次登录必须修改密码，密码要求≥8位，包含大小写字母、数字、特殊符号。

3.2 档案分类配置

登录后进入【系统管理】-【档案分类】，点击新增，可按吐鲁番当地档案类型配置5个一级分类：文书档案、科技档案、民生档案、文物档案、非遗档案，每个分类下可按需新增二级分类，分类编码要求唯一，长度3-10位。

3.3 OCR识别配置

进入【系统设置】-【能力配置】，填写OCR接口密钥（免费配额获取地址：https://ocr.aliyun.com/activity/free ），配置后可自动识别扫描件的文字内容，自动生成档案元数据。

四、可用性验证

1. 档案上传验证：进入【档案录入】-【批量上传】，上传1份≤2GB的PDF扫描件，上传成功后查看元数据是否自动识别，文件是否存入/data/archives/storage目录。

2. 检索验证：在首页检索框输入档案内的关键词，确认1秒内返回对应结果，支持模糊检索、精确检索、全文检索3种模式。

3. 权限验证：新增普通用户，分配仅可查看民生档案的权限，登录普通账号确认无法查看其他分类档案，权限隔离生效。

五、常见问题排查

5.1 后端启动失败提示数据库连接错误

排查步骤：1. 执行systemctl status mysqld确认MySQL服务正常运行；2. 核对application.yml中的数据库账号密码、库名与创建时一致；3. 执行firewall-cmd --add-port=3306/tcp --permanent && firewall-cmd --reload开放数据库端口。

5.2 上传大文件失败

排查步骤：1. 确认application.yml中的max-file-size配置≥上传文件大小；2. 确认Nginx配置中已添加client_max_body_size 10G;参数，重载Nginx生效。

5.3 前端页面无法访问

排查步骤：1. 执行firewall-cmd --add-port=80/tcp --permanent && firewall-cmd --reload开放80端口；2. 执行systemctl status nginx确认Nginx服务正常运行；3. 确认前端文件已正确上传到/usr/share/nginx/html/archives目录下。