学生学籍数字档案馆系统从零部署到功能落地实操全流程指南

一、前置环境准备

1.1 硬件最低要求

云服务器/本地服务器均可，配置要求：2核4G内存、50G以上云硬盘，操作系统选择Ubuntu 22.04 LTS。

1.2 软件依赖安装

登录服务器后依次执行以下命令完成依赖安装，所有命令可直接复制执行：

``` 更新系统源 sudo apt update -y 安装JDK17 sudo apt install openjdk-17-jdk -y 安装MySQL8.0 sudo apt install mysql-server-8.0 -y 初始化MySQL root密码（把下方的your_pwd替换为自定义数据库密码，记牢后续要用） sudo mysql -e "ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_pwd';" 安装Redis sudo apt install redis-server -y 安装maven、git、nginx sudo apt install maven git nginx -y ```

执行完成后依次输入java -version、mysql --version、redis-cli -v，三个命令都返回版本号即为安装成功。

二、系统源码获取与配置

直接拉取开源稳定版源码，执行命令：

``` git clone https://gitee.com/opensource-edv/student-archive-system.git /home/archive ```

2.1 配置文件修改

进入后端配置文件目录，编辑application-prod.yml，完整配置内容如下，仅需替换标注为需要修改的内容，其余配置可直接保留：

``` server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/student_archive?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8 username: root password: your_pwd 替换为刚才设置的MySQL密码 redis: host: 127.0.0.1 port: 6379 database: 0 servlet: multipart: max-file-size: 100MB max-request-size: 100MB 文件存储配置 file: upload-path: /home/archive/files 替换为服务器上的实际存储路径，后续要给这个路径开权限 domain: http://你的服务器公网IP 替换为服务器公网IP或绑定的域名 ```

修改完成后保存，执行以下命令创建文件存储目录并开放权限：

``` sudo mkdir -p /home/archive/files && sudo chmod 777 /home/archive/files ```

三、数据库初始化

依次执行以下命令完成数据库表结构和基础数据导入：

``` 登录MySQL，输入刚才设置的密码 mysql -u root -p 创建业务数据库 create database student_archive default charset utf8mb4; 进入目标数据库 use student_archive; 导入初始化SQL文件 source /home/archive/sql/init.sql; 退出MySQL exit; ```

四、系统打包与启动

4.1 后端启动

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

``` cd /home/archive/admin mvn clean package -DskipTests 打包完成后后台启动后端服务 nohup java -jar target/student-archive-admin.jar --spring.profiles.active=prod & ```

执行后输入tail -f nohup.out查看日志，出现“启动成功”字样即为后端运行正常。

4.2 前端部署

进入前端代码目录，执行编译命令：

``` cd /home/archive/ui npm install npm run build ```

编译完成后会生成dist目录，修改nginx配置文件/etc/nginx/sites-available/default，完整配置如下，替换对应的IP/域名即可：

``` server { listen 80; server_name 你的公网IP或域名; root /home/archive/ui/dist; index 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; } 前端路由适配 location / { try_files $uri $uri/ /index.html; } } ```

保存后执行sudo nginx -t验证配置正确，再执行sudo nginx -s reload重载配置。

4.3 功能验证

打开浏览器输入你的服务器IP，进入登录页，默认管理员账号：admin，默认密码：123456，登录后依次验证以下核心功能：

• 学籍录入：手动录入单个学生学籍信息，或批量导入Excel表格
• 档案查询：按学号、姓名、学院等维度筛选查询学生档案
• 档案导出：批量导出选中学生的档案为PDF/Excel格式
• 操作日志：查看所有账号的操作记录，满足审计要求

五、核心业务配置

5.1 权限分级配置

进入【系统管理-角色管理】页面，可按需创建3类核心角色：

• 超级管理员：拥有系统所有权限，仅分配给学籍管理负责人
• 学院管理员：仅可管理本院学生的学籍档案，不可跨学院操作
• 学生账号：仅可查看本人的学籍档案，不可修改

5.2 自动备份配置

创建备份脚本/home/archive/backup.sh，内容如下，替换对应数据库密码：

``` !/bin/bash mkdir -p /home/archive/backup 备份数据库 mysqldump -u root -p'你的MySQL密码' student_archive > /home/archive/backup/db_$(date +%Y%m%d).sql 备份档案附件 tar -zcf /home/archive/backup/file_$(date +%Y%m%d).tar.gz /home/archive/files 删除7天前的备份，避免占用空间 find /home/archive/backup -mtime +7 -name ".sql" -o -name ".tar.gz" | xargs rm -f ```

执行以下命令添加定时任务，每天凌晨2点自动执行备份：

``` chmod +x /home/archive/backup.sh (crontab -l ; echo "0 2 /bin/bash /home/archive/backup.sh") | crontab ```

六、常见问题排查

• 后端启动报错数据库连接失败：检查application-prod.yml中的MySQL密码是否正确，执行systemctl status mysql查看MySQL服务是否正常运行
• 上传档案附件失败：检查配置文件中的upload-path路径是否存在，是否已执行chmod 777开放权限
• 前端访问404：检查nginx配置中的root路径是否指向正确的dist目录，执行sudo nginx -t验证配置合法性
• 批量导入Excel报错：下载系统提供的导入模板，严格按照模板格式填写，不可修改表头字段