从零搭建轻量开源教师档案管理软件 30分钟完成部署落地全流程

一、前置准备

本次部署采用容器化方案，无需复杂环境配置，仅需满足以下要求：

• 服务器配置：1核2G以上云服务器/本地虚拟机，操作系统支持CentOS7.6+、Ubuntu20.04+
• 端口要求：开放服务器8080端口（可自定义修改）

1.1 安装Docker与Docker Compose

对应操作系统执行以下命令，全程复制粘贴即可：

CentOS系统安装命令：

```bash 安装Docker yum install -y yum-utils yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo yum install -y docker-ce docker-ce-cli containerd.io systemctl start docker systemctl enable docker 安装Docker Compose curl -L https://mirrors.aliyun.com/docker-toolbox/linux/compose/v2.20.3/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose ```

Ubuntu系统安装命令：

```bash 安装Docker apt update apt install -y apt-transport-https ca-certificates curl gnupg-agent software-properties-common curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | apt-key add - add-apt-repository "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" apt install -y docker-ce docker-ce-cli containerd.io systemctl start docker systemctl enable docker 安装Docker Compose curl -L https://mirrors.aliyun.com/docker-toolbox/linux/compose/v2.20.3/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose ```

执行docker -v和docker-compose -v确认安装成功，返回版本号即为正常。

二、系统部署步骤

本次使用的开源教师档案管理系统支持自定义字段、批量导入、异动记录、权限分级等核心功能，全程无收费功能。

1. 新建部署目录：执行mkdir -p /root/teacher_archive && cd /root/teacher_archive
2. 新建docker-compose.yml配置文件，直接复制以下完整内容：

```yaml version: '3.8' services: mysql: image: mysql:8.0 container_name: teacher_archive_mysql restart: always environment: MYSQL_ROOT_PASSWORD: teacher_archive_2024 MYSQL_DATABASE: teacher_archive volumes: - ./mysql/data:/var/lib/mysql command: --default-authentication-plugin=mysql_native_password redis: image: redis:6.2 container_name: teacher_archive_redis restart: always volumes: - ./redis/data:/data web: image: registry.cn-hangzhou.aliyuncs.com/opensource_edu/edu-teacher-archive:v1.2.0 container_name: teacher_archive_web restart: always ports: - "8080:8080" depends_on: - mysql - redis environment: MYSQL_HOST: mysql MYSQL_PORT: 3306 MYSQL_USER: root MYSQL_PASSWORD: teacher_archive_2024 MYSQL_DATABASE: teacher_archive REDIS_HOST: redis REDIS_PORT: 6379 volumes: - ./upload:/app/upload ```

3. 执行启动命令：docker-compose up -d
4. 等待3分钟（首次启动需要初始化数据库），访问http://你的服务器IP:8080即可进入系统登录页。

若访问失败，先执行端口开放命令：
CentOS：firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --reload
Ubuntu：ufw allow 8080/tcp

三、首次启动初始化配置

• 默认管理员账号：admin，默认密码：123456，首次登录必须修改默认密码，避免数据泄露。
• 配置学校基础信息：点击左侧菜单栏【系统设置】-【基础配置】，填写学校名称、LOGO、地址等信息，保存后全局生效。
• 自定义档案字段：点击【系统设置】-【字段配置】，点击【新增字段】，可根据学校需求添加字段（比如教师资格证编号、职称评定时间、教研成果等），支持文本、日期、附件三种类型，勾选【必填】则录入档案时必须填写该字段，保存后即可在档案录入页显示。
• 角色权限配置：点击【系统设置】-【角色管理】，可新增子管理员角色，比如年级管理员仅能查看对应年级教师档案、不能修改删除，普通教师仅能查看自己的档案，按需勾选权限即可。

四、核心功能实操

4.1 教师档案批量录入

1. 点击左侧【档案管理】-【批量导入】，点击【下载导入模板】
2. 不要修改模板列名，按照模板提示填写所有必填字段，附件列填写对应附件的完整文件名（包括后缀）
3. 将所有附件（比如身份证扫描件、职称证明等）打包为zip压缩包，和填写完成的excel文件一起上传
4. 点击【开始导入】，导入成功后可在档案列表查看所有数据，若存在错误数据，系统会自动导出错误报告，按照提示修改后重新上传即可。

4.2 档案异动管理

教师调岗、职称变动、离职等操作需要留存记录的，执行以下步骤：

1. 在档案列表找到对应教师，点击【详情】-【异动记录】
2. 点击【新增异动】，选择异动类型、填写异动时间、备注，上传证明材料
3. 所有异动记录永久留存、不可删除，可追溯操作人、操作时间，满足档案管理合规要求。

4.3 查询与导出

• 点击【档案管理】-【档案列表】，支持按部门、职称、入职时间、学历等多条件组合筛选
• 勾选需要导出的档案，点击【批量导出】，可生成excel表格和附件压缩包，导出数据默认加密，仅管理员有权限查看。

五、日常维护与数据备份

5.1 自动定时备份配置

在部署目录新建backup.sh文件，复制以下完整内容：

```bash !/bin/bash BACKUP_DIR=/data/backup/teacher_archive DATE=`date +%Y%m%d%H%M` mkdir -p $BACKUP_DIR 备份数据库 docker exec teacher_archive_mysql mysqldump -uroot -pteacher_archive_2024 teacher_archive > $BACKUP_DIR/db_$DATE.sql 备份附件 tar -zcf $BACKUP_DIR/upload_$DATE.tar.gz ./upload 删除7天前的旧备份，避免占用磁盘 find $BACKUP_DIR -mtime +7 -name ".sql" -o -name ".tar.gz" | xargs rm -f ```

执行chmod +x backup.sh赋予执行权限，然后执行crontab -e，添加以下内容实现每天凌晨2点自动备份：
0 2 /bin/bash /root/teacher_archive/backup.sh

5.2 常见问题排查

• 页面访问失败：执行docker-compose ps查看容器状态，若web容器未启动，执行docker-compose logs web查看报错日志，多数为端口被占用，修改docker-compose.yml中8080为其他端口后重启即可。
• 导入失败：检查excel是否为xlsx格式，附件大小是否超过10M，附件文件名是否和excel中填写的完全一致。
• 数据恢复：将备份的sql文件导入mysql容器，替换upload目录的文件，执行docker-compose restart web即可恢复。