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）防止数据丢失