gridsuite/study-server

Study Server 镜像文档

镜像概述

Study Server 是一款专为学习场景设计的轻量级资源管理服务器，旨在为个人学习者和小型学习小组提供便捷的学习资源管理解决方案。该镜像集成了Web服务、文件存储和基础用户管理功能，支持通过浏览器访问和管理学习材料，无需复杂配置即可快速搭建个人或协作学习平台。

核心功能特性

• 学习资源集中管理：支持文档（PDF、Word）、视频、音频、代码文件等多种学习材料的上传、分类和检索
• Web可视化界面：提供直观的Web管理界面，支持资源预览、搜索和批量操作
• 用户权限控制：基础用户管理功能，可设置管理员和普通用户权限，控制资源访问范围
• 资源共享功能：生成加密共享链接，支持限时或永久分享学习材料给其他用户
• 轻量级部署：基于Alpine Linux构建，镜像体积小（<200MB），资源占用低，支持在个人电脑、树莓派等设备运行

使用场景

• 个人学习资源库：集中管理课程笔记、参考资料和学习项目，实现跨设备（电脑、平板、手机）访问
• 小组协作学习：3-10人小型学习小组共享学习材料、协作编辑笔记和项目成果
• 课程资料分发：教师或培训师向学生分发课程讲义、作业模板和补充学习资源
• 自学环境搭建：为在线课程学习构建专属资源服务器，整理学习过程中的视频、文档和练习代码

使用方法

基本运行

通过以下命令快速启动Study Server容器：

bash
docker run -d -p 8080:8080 --name study-server study-server:latest

容器启动后，通过浏览器访问 http://localhost:8080 即可打开Web管理界面，默认管理员账号：admin，密码：study123。

配置参数

可通过环境变量自定义服务器配置，常用参数说明：

示例：自定义管理员账号和上传限制

bash
docker run -d -p 8888:8888 \
  -e ADMIN_USER="learner" \
  -e ADMIN_PASSWORD="Learn@2024" \
  -e PORT=8888 \
  -e MAX_UPLOAD_SIZE=200 \
  --name study-server study-server:latest

持久化数据存储

为避免容器重启导致学习资源丢失，需挂载宿主机目录持久化存储数据：

bash
# 在宿主机创建数据目录
mkdir -p /opt/study-server/data

# 启动容器并挂载数据卷
docker run -d -p 8080:8080 \
  -v /opt/study-server/data:/app/data \
  --name study-server study-server:latest

挂载后，所有上传的学习资源将保存在宿主机 /opt/study-server/data 目录，容器重建后数据可恢复。

Docker Compose 部署示例

创建 docker-compose.yml 文件简化部署和配置管理：

yaml
version: '3.8'
services:
  study-server:
    image: study-server:latest
    container_name: study-server
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - ADMIN_USER=studyadmin
      - ADMIN_PASSWORD=SecurePass123!
      - MAX_UPLOAD_SIZE=300
      - LANGUAGE=zh-CN
    volumes:
      - ./study-data:/app/data  # 当前目录下study-data文件夹存储资源
    networks:
      - study-network

networks:
  study-network:
    driver: bridge

使用以下命令启动服务：

bash
# 创建数据目录
mkdir study-data

# 启动服务
docker-compose up -d

# 查看运行状态
docker-compose ps

访问与基础操作

1. 登录系统：访问 http://<服务器IP>:8080，使用配置的管理员账号密码登录
2. 资源管理：通过"上传文件"按钮添加学习材料，支持创建文件夹分类管理
3. 用户管理：管理员可在"设置-用户管理"中添加普通用户，分配资源访问权限
4. 资源共享：选中资源文件点击"生成共享链接"，设置有效期和访问密码后分享给其他用户
5. 数据备份：定期备份宿主机挂载目录（如 /opt/study-server/data）防止数据丢失