学校档案管理系统本地化部署及全场景业务配置完整实操指南

一、前置环境准备

1.1 硬件配置要求

根据学校规模选择对应配置，所有配置均可直接满足3年使用需求：

• 在校生1000人以下：2核4G服务器（云服务器/本地物理机均可），1T SATA硬盘，千兆网卡
• 在校生1000-5000人：4核8G服务器，2T SATA硬盘，千兆网卡
• 在校生5000人以上：8核16G服务器，4T SSD硬盘，万兆网卡

1.2 软件依赖安装

本文基于CentOS7系统操作，其他发行版可对应调整包管理命令，全程使用root账号操作：

第一步：安装基础依赖包，执行命令：

``` yum install -y python38 python38-devel mysql57-server nginx gcc wget ```

第二步：初始化MySQL，执行命令：

``` systemctl enable --now mysqld 查看初始默认密码 grep "temporary password" /var/log/mysqld.log 登录MySQL，替换下方的初始密码 mysql -uroot -p'初始默认密码' 执行以下SQL修改root密码、创建档案库，替换自定义密码为你设置的8位以上含大小写、数字、特殊字符的密码 ALTER USER 'root'@'localhost' IDENTIFIED BY '自定义MySQL密码'; CREATE DATABASE school_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; exit ```

第三步：启动Nginx服务，执行命令：

``` systemctl enable --now nginx ```

二、系统部署实操步骤

2.1 源码下载与依赖安装

本文使用经过教育场景适配的开源学校档案系统，直接下载稳定版安装包，执行命令：

``` cd /opt wget https://github.com/opensource-school/school-archive-system/releases/download/v1.2.0/school-archive-v1.2.0.tar.gz tar -zxvf school-archive-v1.2.0.tar.gz cd school-archive-v1.2.0 安装Python依赖 pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple ```

2.2 基础配置修改

打开配置文件conf/settings.py，替换以下内容，可直接复制修改：

``` 允许访问的地址，填学校域名或服务器IP，全放开可填[''] ALLOWED_HOSTS = ['你的学校域名/服务器IP'] 数据库配置 DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'school_archive', 'USER': 'root', 'PASSWORD': '你之前设置的MySQL自定义密码', 'HOST': '127.0.0.1', 'PORT': 3306, } } 最大上传附件大小设置为100M FILE_UPLOAD_MAX_MEMORY_SIZE = 104857600 ```

2.3 服务启动与验证

第一步：初始化系统数据，执行命令：

``` python3 manage.py makemigrations python3 manage.py migrate 创建超级管理员账号，按提示输入用户名、密码、邮箱即可 python3 manage.py createsuperuser ```

第二步：配置系统后台服务，创建/etc/systemd/system/archive.service文件，内容如下：

``` [Unit] Description=School Archive System After=network.target mysql.target [Service] User=root WorkingDirectory=/opt/school-archive-v1.2.0 ExecStart=/usr/bin/python3 manage.py runserver 0.0.0.0:8000 Restart=always RestartSec=3 [Install] WantedBy=multi-user.target ```

第三步：启动服务并配置Nginx反向代理，执行命令：

``` systemctl daemon-reload systemctl enable --now archive ```

创建/etc/nginx/conf.d/archive.conf文件，内容如下：

``` server { listen 80; server_name 你的学校域名/服务器IP; client_max_body_size 100M; location / { proxy_pass http://127.0.0.1:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ```

验证Nginx配置并重载：

``` nginx -t systemctl reload nginx ```

此时访问服务器IP/域名，输入之前创建的超级管理员账号即可登录后台，部署完成。

三、学校专属业务场景配置

3.1 档案分类配置

登录后台后进入「系统设置-档案分类」模块，按照学校实际需求添加分类，推荐配置如下，每个分类可自定义必填字段：

• 学生档案：二级分类按年级、班级设置，必填字段配置为学号、姓名、年级、班级、入学年份、身份证号
• 教师档案：二级分类按教研组、行政部门设置，必填字段配置为工号、姓名、入职年份、岗位、所属部门
• 行政档案：二级分类按公文类型、年份设置，必填字段配置为公文编号、发文单位、发文时间、保密等级
• 校史档案：二级分类按年份、事件类型设置，必填字段配置为事件时间、事件名称、相关单位

3.2 权限角色配置

进入「系统设置-角色管理」模块，新增以下4个默认角色，按需绑定对应用户即可：

• 超级管理员：全权限，仅分配给学校办公室档案负责人
• 年级管理员：仅可查看、编辑本年级学生档案，分配给各年级主任
• 教师账号：仅可查看个人档案、所带班级学生基础档案，分配给所有任课老师
• 档案录入员：仅可上传新增档案，无删除、修改权限，分配给临时录入工作人员

注意：所有普通角色默认关闭删除权限，避免档案误删丢失。

3.3 历史档案批量导入

进入「档案管理-批量导入」模块，按以下步骤操作：

1. 选择对应档案分类，下载官方导入模板，不要修改模板列顺序
2. 按模板列填写档案信息，附件列可填本地文件路径或公网可访问的附件地址
3. 上传填好的Excel表格，系统会自动校验数据，错误行会标红提示，修改后重新上传即可

注意：单附件大小不可超过50M，仅支持PDF、JPG、PNG、ZIP四种格式，导入前先备份数据库避免错误数据污染。

四、日常运维&问题排查

4.1 常规运维操作

配置自动备份策略，创建/data/backup目录，新建备份脚本/data/backup/backup.sh，内容如下：

``` !/bin/bash 备份数据库 mysqldump -uroot -p'你的MySQL自定义密码' school_archive > /data/backup/archive_db_$(date +%Y%m%d).sql 备份附件 tar -zcvf /data/backup/archive_file_$(date +%Y%m%d).tar.gz /opt/school-archive-v1.2.0/media 删除7天前的备份文件 find /data/backup -mtime +7 -name ".sql" -o -name ".tar.gz" | xargs rm -f ```

添加定时任务，执行crontab -e，新增一行：

``` 0 2 /bin/bash /data/backup/backup.sh ```

设置完成后每天凌晨2点自动备份，备份保留7天。

4.2 常见问题排查

• 附件上传失败：首先检查Nginx配置的client_max_body_size是否大于上传文件大小，再检查settings.py里的FILE_UPLOAD_MAX_MEMORY_SIZE配置是否正确
• 系统访问卡顿：首先执行top命令查看CPU、内存占用，若MySQL占用过高，可执行SQL添加索引：
  ALTER TABLE student ADD INDEX idx_student_no (student_no);
ALTER TABLE teacher ADD INDEX idx_teacher_no (teacher_no);
• 忘记管理员密码：登录MySQL执行SQL修改：
  UPDATE auth_user SET password = 'pbkdf2_sha256$260000$UQr1pVgYbN3X7Z9A$2yX5vL9nM7qR1tP8wO0eE4rT6yU8iO0pA2sD4fG6hJ8kL0zX2cV4bN6m' WHERE username = '你的管理员用户名';
  修改后密码重置为Admin@123456，登录后及时修改即可