白山档案管理系统本地部署、全功能配置与数据迁移零门槛实操指南

一、前置准备

1. 硬件要求

最低配置：2核4G云服务器，50G系统盘+100G数据盘，操作系统优先选择CentOS7.9。

2. 软件要求

• JDK 1.8
• MySQL 5.7+
• Redis 5.0+
• Nginx 1.18+
• Maven 3.6+
• Node.js 14.x

3. 安装包获取

执行以下命令直接克隆官方开源代码仓库：

``` git clone https://gitee.com/baishancloud/bs-archives.git ```

二、服务端部署实操

1. 基础环境安装

逐行执行以下命令安装所有依赖环境，所有命令可直接复制运行：

``` 安装JDK1.8 yum install -y java-1.8.0-openjdk-devel 验证JDK安装成功 java -version 安装MySQL5.7 yum install -y https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm yum install -y mysql-community-server --nogpgcheck systemctl start mysqld systemctl enable mysqld 获取MySQL初始密码 grep 'temporary password' /var/log/mysqld.log | awk '{print $NF}' 登录MySQL修改初始密码（将YourNewPass@123替换为你设置的root密码） mysql -uroot -p刚才获取的初始密码 ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourNewPass@123'; 创建系统专用数据库与账号 create database bs_archives default character set utf8mb4 collate utf8mb4_general_ci; grant all on bs_archives. to 'bs_user'@'%' identified by 'Bs@2024_archives'; flush privileges; exit; 安装Redis yum install -y redis systemctl start redis systemctl enable redis 安装Maven yum install -y maven ```

2. 后端代码编译与启动配置

首先进入后端代码目录，执行打包命令：

``` cd bs-archives/bs-admin mvn clean package -Dmaven.test.skip=true ```

打包完成后创建程序运行目录，将jar包移动到对应位置：

``` mkdir -p /usr/local/bs-archives cp target/bs-admin.jar /usr/local/bs-archives/ ```

在/usr/local/bs-archives/目录下创建启动脚本start.sh，内容如下可直接复制：

``` !/bin/bash APP_NAME=bs-admin.jar APP_PATH=/usr/local/bs-archives/$APP_NAME LOG_PATH=/var/log/bs-archives/ mkdir -p $LOG_PATH nohup java -jar -Xms1G -Xmx2G $APP_PATH --spring.profiles.active=prod > $LOG_PATH/run.log 2>&1 & echo $! > $LOG_PATH/pid echo "服务启动成功，PID：$(cat $LOG_PATH/pid)" ```

3. 生产配置文件编写

在/usr/local/bs-archives/目录下创建config文件夹，新建application-prod.yml配置文件，完整内容如下：

``` spring: datasource: url: jdbc:mysql://127.0.0.1:3306/bs_archives?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: bs_user password: Bs@2024_archives driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: '' servlet: multipart: max-file-size: 100MB max-request-size: 100MB server: port: 8080 servlet: context-path: /api bs: storage: path: /data/bs-archives/storage/ security: jwtSecret: Df23sD98fSd32kLp09xZc76vBn45mKj jwtExpireTime: 86400000 ```

创建文件存储目录并赋予权限，之后启动服务：

``` mkdir -p /data/bs-archives/storage/ chmod 755 /data/bs-archives/storage/ sh /usr/local/bs-archives/start.sh ```

执行以下命令验证服务启动成功，正常会返回swagger接口文档页面源码：

``` curl http://127.0.0.1:8080/api/doc.html ```

三、前端部署实操

1. 前端代码编译

先安装Node.js14版本，之后进入前端目录编译代码：

``` 安装Node.js14 curl -sL https://rpm.nodesource.com/setup_14.x | bash - && yum install -y nodejs 验证安装成功 node -v 进入前端目录 cd ../bs-ui 安装依赖 npm install --registry=https://registry.npmmirror.com 编译打包 npm run build ```

编译完成后将dist目录移动到程序运行目录：

``` cp -r dist /usr/local/bs-archives/ ```

2. Nginx配置

在/etc/nginx/conf.d/目录下新建bs-archives.conf配置文件，完整内容如下，需将server_name替换为你的服务器IP或域名：

``` server { listen 80; server_name 192.168.1.100 example.com; root /usr/local/bs-archives/dist; index index.html index.htm; 前端路由重写 location / { try_files $uri $uri/ /index.html; } 接口转发 location /api/ { proxy_pass http://127.0.0.1:8080/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } 静态资源缓存 location ~ \.(js|css|png|jpg|jpeg|gif|ico|svg)$ { expires 7d; add_header Cache-Control "public, no-transform"; } } ```

验证配置无误后重载Nginx：

``` nginx -t nginx -s reload ```

此时直接访问服务器IP或域名即可进入系统，默认账号为admin，默认密码为123456，登录后请立即修改密码。

四、核心功能配置与数据迁移

1. 基础功能配置

• 档案分类配置：登录后进入系统管理-档案分类，点击新增支持多级分类，可按需添加文书档案、科技档案、人事档案等类别，每个分类可自定义字段，比如给文书档案添加文号、密级、保管期限等专属字段。
• 权限配置：进入系统管理-角色管理，新增档案管理员、普通查阅员等角色，档案管理员开放所有权限，查阅员仅开放查阅、下载权限，之后在用户管理页面给对应员工绑定对应角色即可。
• 存储配置：若需对接对象存储，进入系统设置-存储设置，选择对应OSS厂商，填入AK、SK、桶名、Endpoint信息保存，系统会自动切换存储路径。

2. 历史数据迁移

第一步进入档案管理-档案导入页面，选择对应档案分类，点击下载导入模板，按照模板格式填写历史档案数据，必填项不能为空，附件可填本地绝对路径或公网可访问的URL。

第二步上传填写完成的模板，系统会自动校验数据，校验失败会返回具体错误明细，修改后重新上传即可，校验通过后点击确认导入，大批次数据建议按1000条/批次拆分导入，导入过程不要关闭页面。

第三步导入完成后进入档案管理-档案列表，搜索导入的档案编号，核对信息、附件是否正常显示，访问权限是否匹配角色配置。

五、常见问题排查

• 服务启动失败：查看/var/log/bs-archives/run.log日志，常见错误为MySQL账号密码权限错误、Redis未启动，核对配置文件对应信息即可。
• 前端访问404：检查Nginx配置的root路径是否与dist目录实际路径一致，确认Nginx已重载配置。
• 附件上传失败：执行chmod 755 /data/bs-archives/storage/给存储目录开写入权限，若对接OSS检查AK、SK权限是否正常。
• 导入数据失败：检查模板格式是否与下载的模板一致，必填项是否为空，附件大小是否超过100MB限制。