仲裁档案管理软件本地化部署实操指南 从安装到配置全流程落地

一、部署前置准备

所有操作均基于CentOS7.9操作系统执行，服务器最低配置要求：2核4G内存、50G以上SSD云硬盘、开放80端口公网访问权限。

• 依赖软件版本固定为：JDK11、MySQL8.0、Redis6.2、Nginx1.20，避免版本兼容问题
• 提前记录服务器公网IP，后续配置需直接使用

二、基础环境部署

2.1 安装JDK11

执行以下命令安装，全程无需手动选择参数：

``` yum install -y java-11-openjdk java-11-openjdk-devel ```

验证安装结果，执行java -version，输出包含openjdk version "11.0.x"即为成功。

2.2 安装配置MySQL8.0

依次执行以下命令完成安装和初始化：

``` 导入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后执行以下命令创建业务库和账号：

``` 修改root密码（将下方的YourRoot@2024替换为自己的密码） ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourRoot@2024'; 创建仲裁档案专属库 create database arbitration_archives default character set utf8mb4 collate utf8mb4_unicode_ci; 创建业务账号并授权 grant all on arbitration_archives. to 'arb_user'@'%' identified by 'Arb@2024_File'; flush privileges; exit ```

2.3 安装配置Redis6.2

执行以下命令安装：

``` yum install -y epel-release yum install -y redis systemctl start redis systemctl enable redis ```

编辑/etc/redis.conf文件，找到requirepass配置项，修改为requirepass Redis@Arb2024，保存后执行systemctl restart redis生效。

2.4 安装Nginx

执行命令：yum install -y nginx && systemctl start nginx && systemctl enable nginx即可完成安装。

三、仲裁档案管理软件部署

3.1 下载并解压安装包

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

``` wget https://github.com/arbitration-admin/archives-system/releases/download/v1.2.0/arb-archives-v1.2.0.tar.gz tar -zxvf arb-archives-v1.2.0.tar.gz -C /opt/ ```

3.2 修改核心配置文件

打开/opt/arb-archives/conf/application-prod.yml文件，直接替换为以下完整配置（无需修改其他参数）：

``` server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/arbitration_archives?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: arb_user password: Arb@2024_File redis: host: 127.0.0.1 port: 6379 password: Redis@Arb2024 database: 1 file: storage-path: /opt/arb-archives/upload/ max-size: 100MB ```

创建文件上传目录并赋权：mkdir -p /opt/arb-archives/upload && chmod 755 /opt/arb-archives/upload。

3.3 启动后端服务

执行启动命令：cd /opt/arb-archives/bin && chmod +x startup.sh && ./startup.sh，查看日志tail -f /opt/arb-archives/logs/arb-archives.log，出现「服务启动成功」字样即为后端部署完成。

3.4 配置Nginx反向代理

在/etc/nginx/conf.d目录下创建arb.conf文件，写入以下配置（将your_server_ip替换为服务器实际公网IP）：

``` server { listen 80; server_name your_server_ip; client_max_body_size 100M; location / { root /opt/arb-archives/dist; 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验证配置，出现success提示后执行nginx -s reload重载配置，此时直接访问服务器公网IP即可进入系统登录页，默认管理员账号：admin，默认密码：Admin@123456。

四、核心业务配置实操

4.1 档案元数据配置

登录后台后进入「系统设置-元数据管理」，点击「新增元数据组」，命名为「仲裁案件档案」，依次添加字段：案件编号、仲裁员姓名、申请人信息、被申请人信息、裁决日期、档案密级、保管期限，所有字段设置为必填项，保存后绑定到「档案上传」模块，后续上传档案时将自动带出这些字段。

4.2 权限体系配置

进入「权限管理-角色管理」，新增「档案管理员」角色，勾选档案上传、审核、借阅审批、永久删除权限；新增「普通仲裁员」角色，仅勾选档案查询、借阅申请权限，保存后进入「用户管理」模块，对应添加人员账号并分配对应角色即可。

4.3 自动归档规则配置

进入「档案设置-归档规则」，设置自动归档触发条件：裁决作出后7个工作日未上传档案自动发送站内信提醒给案件承办人，超过30天未归档自动冻结案件编辑权限，保存后规则即时生效，无需重启服务。

五、上线验证与故障排查

5.1 功能验证流程

• 用管理员账号上传一份测试仲裁档案，填写所有必填元数据，上传10MB以内的PDF扫描件，提交后查看档案库是否正常展示对应记录
• 用普通仲裁员账号登录，验证是否只能看到授权范围内的档案，提交借阅申请后管理员账号是否收到提醒
• 测试全文检索功能，输入案件编号、当事人姓名等关键词，验证是否1秒内匹配到对应档案

5.2 常见故障排查

• 访问页面404：检查Nginx配置中root路径是否为/opt/arb-archives/dist，确认该目录下存在index.html文件
• 上传档案失败：检查/opt/arb-archives/upload目录权限是否为755，确认Nginx配置中client_max_body_size参数大于上传文件大小
• 登录提示账号密码错误：检查MySQL中arb_user账号是否拥有arbitration_archives库的所有权限，确认application-prod.yml中的数据库密码和实际设置一致