零基础快速搭建学校管理档案软件的实操全流程
前置准备
需安装Docker工具，跨Windows/macOS/Linux平台，无额外环境依赖。从官方下载地址直接安装：https://www.docker.com/products/docker-desktop/，安装完成后打开Docker，确认状态栏显示「运行中」（Windows需勾选“使用WSL2后端”，macOS默认即可）。
核心部署步骤
步骤1：创建专属档案存储目录
打开终端：Windows用PowerShell，macOS/Linux用终端，执行命令创建目录并进入：
``` mkdir school-archive && cd school-archive ```该目录用于存放所有档案数据，避免容器删除后数据丢失。
步骤2：拉取预配置镜像
执行命令拉取针对教育场景的开源学校档案管理镜像（预配置学生、教师、学籍模块，零代码修改）：
``` docker pull ghcr.io/schooldev/archive-manager:latest ```步骤3：启动容器并映射端口
执行启动命令，映射宿主机端口并挂载数据目录：
``` docker run -d \ --name school-archive \ -p 8080:80 \ -v $(pwd)/data:/app/data \ ghcr.io/schooldev/archive-manager:latest ```关键细节：Windows PowerShell用户需将命令中$(pwd)替换为${PWD}，否则路径挂载失败；Linux/macOS直接复制即可。执行后等待30秒，容器启动完成。
步骤4：初始化系统账号
打开浏览器，输入http://localhost:8080进入初始化页面，填写以下必填项：
- 管理员用户名：自定义（如admin）
- 管理员密码：设置8位以上，含数字、字母的密码，务必记录（无找回功能）
- 学校名称：填写学校全称
点击「提交初始化」，等待系统自动部署完成，进入系统首页。
核心功能实操
1. 录入学生档案
点击左侧菜单栏「学生档案」→「新增学生」，填写必填项：
- 姓名：必填
- 学号：必填，唯一标识（可自定义规则，如2024001）
- 年级班级：必填（如高一2班）
- 入学时间：必填，格式为YYYY-MM-DD
选填项：联系电话、家庭住址，填写完成后点击「保存」，系统自动生成唯一档案编号，可在「学生档案列表」检索。
2. 录入教师档案
点击左侧菜单栏「教师档案」→「新增教师」，必填项：
- 姓名：必填
- 教师编号：必填，唯一标识
- 任教科目：必填（如数学）
- 入职时间：必填，格式为YYYY-MM-DD
选填项：所属部门、联系电话，保存后自动归档。
3. 档案检索与导出
检索：在对应档案列表的顶部搜索框，输入学号/姓名/年级班级，1秒内定位目标档案；
导出：点击列表右上角「导出」按钮，选择Excel格式，文件将自动保存到宿主机的school-archive/data目录下，无需额外操作。
维护与故障排查
数据备份
每日执行备份命令，在school-archive目录下生成带日期的备份包：
Linux/macOS执行：
``` docker exec school-archive tar -czf /app/backup/$(date +%Y%m%d).tar.gz /app/data ```Windows PowerShell执行（替换日期变量）：
``` docker exec school-archive tar -czf /app/backup/$(Get-Date -Format "yyyyMMdd").tar.gz /app/data ```备份包存放于容器内的/app/backup目录，可自行挂载到本地目录。
常见故障修复
- 无法访问页面：执行docker ps命令，确认school-archive容器状态为「Up」；若状态异常，执行docker start school-archive重启；
- 数据丢失：删除旧容器后重新执行步骤3的启动命令，挂载的data目录会自动恢复所有档案；
- 端口被占用：修改步骤3启动命令中的-p 8080:80为-p 8081:80，将端口改为未被占用的，浏览器访问http://localhost:8081即可。
可选扩展设置
如需上传学籍证明、教师资格证书等文件，执行命令开启文件上传权限：
``` docker exec school-archive mkdir -p /app/uploads && chmod 755 /app/uploads ```登录系统后，在「系统设置」→「功能开关」中开启「文件上传」，即可在档案录入时添加附件。
相关文章
