学校卫生数字档案馆系统落地实操：从搭建到使用的完整步骤

所有操作均基于Linux系统（推荐Ubuntu 22.04 LTS，Windows用户可安装WSL2，全程复制命令即可执行）。

一、环境准备

1. 安装Docker与Docker Compose

执行以下命令，自动安装Docker及对应版本的Docker Compose：

``` 更新软件源 sudo apt update && sudo apt upgrade -y 安装Docker依赖包 sudo apt install apt-transport-https ca-certificates curl software-properties-common -y 添加Docker官方GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg 添加Docker源 echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null 安装Docker sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io -y 安装Docker Compose（v2.20.2稳定版） sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose ```

验证安装，执行以下命令，出现对应版本号即成功：

``` docker --version docker-compose --version ```

二、系统部署

1. 获取项目核心文件

执行命令创建项目目录并下载Docker Compose配置与环境变量文件：

``` 创建项目目录 mkdir -p ~/school-health-archive && cd ~/school-health-archive 下载Docker Compose配置文件 wget https://raw.githubusercontent.com/health-archive/school-system/main/docker-compose.yml 下载环境变量配置文件 wget https://raw.githubusercontent.com/health-archive/school-system/main/.env ```

2. 修改关键配置

用nano编辑器打开.env文件，修改以下带必填修改标识的参数：

``` 数据库管理员密码，必须设为8位以上复杂密码 DB_PASSWORD=your_8+_char_complex_password 系统管理员邮箱，推荐使用学校官方邮箱 ADMIN_EMAIL=admin@your-school.edu.cn 系统管理员密码，必须设为8位以上复杂密码 ADMIN_PASSWORD=your_admin_8+_char_password ```

修改完成后，按Ctrl+O回车保存，再按Ctrl+X退出编辑器。

3. 启动系统服务

执行命令，后台启动数据库、Web服务、文件存储服务：

``` docker-compose up -d ```

等待1-2分钟后，执行以下命令验证服务状态：

``` docker-compose ps ```

若所有服务的「状态」列均显示为「Up」，说明部署成功。

三、系统初始配置

部署完成后，在浏览器输入「服务器IP:8000」（本地部署则输入「127.0.0.1:8000」），进入登录页面。

使用你在.env中设置的管理员账号密码登录，首次登录需完成3项必填配置：

• 设置学校基础信息：进入「系统设置-学校信息」，填写学校名称、地址、联系人电话，点击保存。
• 配置档案分类：进入「档案管理-分类设置」，添加「学生健康档案」「教师健康档案」「疫情防控档案」三类核心分类，每个分类可设置公开权限与存储期限。
• 初始化档案字段：进入「档案管理-字段设置」，确认学生档案包含「体温记录」「疫苗接种情况」「年度体检报告」字段，缺失则点击「添加字段」补充。

四、日常使用流程

1. 新增单个学生档案

进入「档案管理-学生档案-新增」，填写学生姓名、学号、班级，上传体温记录、体检表等附件，点击「提交」，系统自动完成归档。

2. 批量导入新生档案

新生批量档案可通过Excel导入，步骤如下：

• 进入「档案管理-学生档案-批量导入」，点击「下载模板」获取标准格式Excel。
• 按模板填写，注意学号必须唯一，班级编码需与系统内已有的班级一致。
• 上传填充后的Excel，点击「导入」，等待系统处理，完成后查看「导入日志」确认成功数量。

3. 档案查询与导出

进入「档案查询」页面，可按学号、班级、时间范围筛选档案，点击「导出」可生成Excel或PDF格式的报表，导出文件默认存储在「~/school-health-archive/export」目录下。

五、常见问题修复

1. 服务启动失败

执行命令查看服务日志定位问题：

``` docker-compose logs web ```

常见原因是8000端口被占用，执行命令查看端口占用情况：

``` sudo lsof -i :8000 ```

若有进程占用，修改docker-compose.yml中的端口映射，将「8000:80」改为「8080:80」，保存后重新执行「docker-compose up -d」。

2. 附件上传失败

原因是文件存储目录无读写权限，执行命令修复：

``` sudo chmod -R 777 ~/school-health-archive/upload ```

修复后重新上传附件即可。