B/S架构学校版档案软件从零搭建全流程实操技术指南

一、环境准备（零门槛适配Windows/Linux）

无论使用学校本地PC还是云服务器，均采用Docker部署（无需复杂配置），按以下步骤操作：

1.1 Linux系统（Ubuntu 20.04+/CentOS 7+）

执行对应命令一键安装Docker及docker-compose：

``` Ubuntu 20.04及以上适用命令 sudo apt update -y && sudo apt install -y apt-transport-https ca-certificates curl software-properties-common curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg 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 sudo apt update -y && sudo apt install -y docker.io docker-compose sudo systemctl start docker && sudo systemctl enable docker CentOS 7及以上适用替换命令（若使用CentOS请执行） sudo yum install -y yum-utils device-mapper-persistent-data lvm2 sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin sudo systemctl start docker && sudo systemctl enable docker ```

1.2 Windows/macOS系统

直接下载官方Docker Desktop：https://www.docker.com/products/docker-desktop/，Windows安装时勾选「使用WSL2」，macOS直接兼容安装，完成后打开Docker，状态栏显示绿色即为引擎就绪。

二、部署B/S版学校档案软件核心服务

本次选用开源稳定的OpenKM社区版（适配学校多角色文档管理需求），创建配置文件后一键启动：

2.1 编写完整配置文件（无省略）

新建文件命名为docker-compose.yml，粘贴以下内容（敏感信息可按需修改）：

``` version: '3.8' services: okm-db: image: postgres:14-alpine environment: POSTGRES_USER: openkm POSTGRES_PASSWORD: SchoolDB@2024 请修改为自定义数据库密码 POSTGRES_DB: openkm volumes: - okm-db-data:/var/lib/postgresql/data okm-app: image: openkm/openkm-ce:6.3.12 ports: - "8080:8080" environment: OKM_DB_HOST: okm-db OKM_DB_PORT: 5432 OKM_DB_USER: openkm OKM_DB_PASSWORD: SchoolDB@2024 与数据库密码保持一致 OKM_ADMIN_USER: admin OKM_ADMIN_PWD: SchoolAdmin@2024! 请修改为自定义管理员密码 depends_on: - okm-db volumes: - okm-app-data:/opt/openkm/repository volumes: okm-db-data: okm-app-data: ```

2.2 启动服务

将docker-compose.yml放到任意文件夹（如Linux的/opt/school-archive、Windows的D:\school-archive），进入该文件夹执行启动命令：

docker-compose up -d

等待2分钟服务初始化完成，初始化期间切勿重复执行命令。

2.3 首次登录验证

在浏览器输入访问地址：http://你的服务器IP:8080/OpenKM，登录账号：admin，密码为你设置的管理员密码。

首次登录后立即修改默认管理员密码，避免权限泄露。

三、学校专属档案分类初始化

按学校档案管理规范创建目录结构，步骤如下：

• 左侧面板点击「文档」→ 右键「文档库」→ 选择「新建文件夹」；
• 依次创建顶层目录：学校档案，再在其下创建三个子目录：
  • 学生档案：下分子目录「学籍档案」「成绩档案」「奖惩档案」；
  • 教师档案：下分子目录「人事档案」「教学档案」「科研档案」；
  • 行政档案：下分子目录「公文档案」「财务档案」「会议档案」；

四、角色权限配置（适配学校管理需求）

设置四类角色，遵循最小权限原则，配置步骤：

1. 左侧点击「管理」→ 「角色和权限」→ 「新建角色」，依次创建：管理员、班主任、教师、学生；
2. 分别分配权限：
   • 管理员：拥有所有目录的「读、写、上传、删除、权限修改」权限；
   • 班主任：仅对本班学生的「学籍档案」「成绩档案」拥有「读、写、上传」权限，移除「删除、权限修改」权限；
   • 教师：仅对所带课程的「成绩档案」拥有「读、上传」权限，移除「写、删除、下载」权限；
   • 学生：仅对本人的「学籍档案」拥有「读」权限，移除所有修改/下载权限；

五、核心功能验证（确保可上手落地）

5.1 上传测试

用班主任账号登录，进入对应班级的「学籍档案」目录，点击「上传」按钮，选择本地学籍登记表，确认上传成功且存储位置正确。

5.2 权限校验

用学生账号登录，仅能看到本人的学籍档案，无法访问其他学生或教师的档案，验证权限配置生效。

5.3 检索测试

在顶部检索框输入学生姓名，1秒内即可检索到对应档案，符合学校快速调档需求。