学校版档案管理软件快速部署实操指南 零门槛上手可落地
前置准备
本次实操基于Docker容器化部署，无需配置复杂数据库或运行环境，仅需准备一台Ubuntu 20.04+/CentOS 7+的Linux服务器，网络可正常访问公网。
Docker环境安装与配置
1. 执行安装命令
- Ubuntu系统执行： ``` curl -fsSL https://get.docker.com | sudo sh ```
- CentOS系统执行： ``` sudo yum install -y docker-ce docker-ce-cli containerd.io ```
- 安装后启动并设置开机自启： ``` sudo systemctl start docker sudo systemctl enable docker ```
注意：所有命令需在有sudo权限的用户下执行，权限不足时先切换至root用户操作。
学校版档案管理软件部署
1. 拉取官方稳定镜像
本次使用的开源学校档案管理镜像为经教育场景优化的稳定版本，执行以下命令拉取：
``` docker pull ghcr.io/school-archive/school-edition:v1.2.0 ```2. 启动容器并挂载数据
执行以下命令启动容器，挂载本地数据卷避免数据丢失，同时映射8080端口至外部网络：
``` docker run -d -p 8080:80 --name school-archive -v /opt/school-archive/data:/app/data ghcr.io/school-archive/school-edition:v1.2.0 ```关键说明：/opt/school-archive/data为本地数据存储路径，可按需修改，容器内所有档案数据均存储于此，删除容器不会丢失数据。
3. 验证部署状态
执行命令检查容器是否正常运行：
``` docker ps | grep school-archive ```
若输出结果中STATUS列显示为Up（若干秒），说明部署成功，接下来进入初始化配置环节。
档案管理系统初始化配置
在浏览器地址栏输入「服务器公网IP:8080」，进入初始化页面，按以下步骤操作：
- 管理员用户名：建议设置为admin_school（避免简单名称）；
- 管理员密码：必须为8位以上，包含大小写字母、数字及特殊字符，例如Admin@2024，禁止使用纯数字或生日等简单组合；
- 学校全称：输入实际名称，如「XX市第一实验中学」；
- 点击「完成初始化」，等待页面跳转至系统后台。
核心功能适配学校场景配置
1. 档案分类自定义
点击左侧菜单栏「档案管理」→「档案分类」，执行以下操作：
- 点击「新增分类」，输入分类名称：学生档案；
- 点击「添加字段」，依次设置：
- 字段名称：学号，类型：字符，勾选「唯一」「必填」；
- 字段名称：姓名，类型：字符，勾选「必填」；
- 字段名称：班级，类型：关联，关联预设的「班级表」；
- 字段名称：学籍号，类型：字符，勾选「唯一」；
- 再次点击「新增分类」，创建「教师档案」，字段设置类似：工号（唯一、必填）、姓名、职称、任教科目；
- 点击「保存分类」，完成学校专属档案分类设置。
2. 用户权限配置
点击左侧菜单栏「系统设置」→「用户管理」，操作如下：
- 默认管理员角色无需修改；
- 点击「新增角色」，创建「教师」角色；
- 分配权限：勾选「仅查询本人所带班级学生档案」「修改个人信息」，取消「新增档案」「删除档案」权限；
- 按学校教师名单批量添加用户，对应分配教师角色。
日常实操步骤
1. 学生档案录入
点击左侧「档案管理」→「学生档案」，点击「新增档案」：
- 按表单填写学号、姓名、班级（从下拉菜单选择）、学籍号；
- 上传身份证扫描件、学籍证明（仅支持JPG/PDF格式，单个文件不超过5MB）；
- 点击「保存」，完成录入，可在「档案列表」中查询。
2. 教师档案查询
教师登录系统后，左侧菜单仅显示「学生档案查询」，输入班级名称或学生姓名即可查询对应档案，不可编辑或删除档案。
常见问题排查
- 无法访问系统：
- 检查8080端口是否开放，执行：firewall-cmd --add-port=8080/tcp --permanent，再执行firewall-cmd --reload；
- 检查容器是否运行，执行docker ps | grep school-archive，若未运行，执行docker start school-archive；
- 档案上传失败：
- 检查本地数据目录权限，执行sudo chown -R 1000:1000 /opt/school-archive/data，确保容器可读写；
- 检查文件大小，单个文件不得超过5MB。
相关文章
