LearnSite部署指南

一。LearnSite介绍

关于 LearnSite 信息技术学习平台

LearnSite 是一个专为中小学信息技术课堂设计的开源教学辅助平台。它通过整合新课教学、作业提交、作品互评、课堂测验及资源管理等功能，将教师从繁重的批改与统计中解放出来，让教学更聚焦于课堂本身。

平台支持高度定制：教师可按需开关功能模块、调整界面，甚至绑定学生IP实现精细化管理。同时，活跃的社区持续推动其进化——2026年初的更新已加入网页课件活动、物联网/人工智能体验（如人脸识别、AI绘画）及在线协作工具，紧跟技术前沿。

本文记录了 LearnSite 的 Docker 部署实践与常见问题排查，希望能帮助更多教育工作者快速搭建属于自己的教学环境。

二。部署环境

• PVE
  • Windows Server 2022（可选）
    • SQL Server Express 2022
    • SSMS数据库管理工具
    • 宝塔Windows面板
  • 群晖NAS：Docker（推荐）
    • SQL Server Express 2022：Docker
    • Learnsite：Docker
      

三。部署步骤

(一) Windows Server环境部署（可选）

1。 准备工作

1. 官网下载learnsite压缩包后解压待用
2. 服务器管理器--添加角色和功能--Web服务器(IIS)--勾选 .NET3.5 Framework 和 .NET Framework4.8下面的 ASP .NET4.8

2。 安装

1. 浏览器搜索SQL Server 2022 Express下载并安装，安装完成后最后一步点击SSMS自动跳转sql server management studio网站，下载并安装SSMS 2022
   提示1：自动安装的SQL不带密码，需使用SSMS工具开启sa（管理员账号）并设置密码登录
   提示2：服务器名称：你的电脑名\SQLEXPRESS
2. 浏览器搜索宝塔面板下载并安装，按照提示输入默认的账号密码登录，跳过推荐的安装选项只安装IIS
   提示：登录异常请将IP改为127.0.0.1或本机IP地址
3. 宝塔面板--数据库--远程服务器，使用管理员账号sa输入从SSMS设置好的密码登录（服务器名称填127.0.0.1或本机IP地址）
4. 宝塔面板--网站--添加站点，数据库选择SQL Server，数据库名称：learnsite，账号和密码填sa管理员账号密码，选择ASP、远程数据库
5. 将解压好的learnsite文件夹下的所有文件拷贝到C盘--wwwroot--本机IP地址 路径下，从宝塔面板--网站--网站名--配置文件 按要求更改对应的配置
   提示1：Data Source = 电脑名\SQLEXPRESS
6. 宝塔面板--数据库--导入拷贝（learnsite）后的sql路径下的 learnsite.sql 数据库文件并覆盖
   提示：也可以在Windows环境下安装SSMS数据库管理工具，使用sa登录后选择 learnsite 数据库--打开文件，找到解压后的learnsite文件夹里面的sql路径下的 learnsite.sql 数据库文件，点击 执行 即可
7. 至此，你可以打开浏览器输入 127.0.0.1 或 本机IP地址 访问 了

（二）Docker环境部署（推荐）

• 提示：强烈建议新手小白在飞牛Fnos或群晖环境下以Docker方式进行部署
• 提示：此方法只需简单三步便能成功部署：创建宿主机映射路径，存放docker-compose部署文件 --> 构建并运行mssql数据库 --> 构建并运行learnsite

1. 文件路径参考：

• 假设是群晖NAS环境，绝对路径参考如下：

  	- /volume1/docker/
  		- learnsite
  		    - docker-compose.learnsite.yml
  		    + app
  		- mssql
  		    - docker-compose.mssql.yml
  		    + data
  

• 假设是Linux（Debian、Ubuntu等）环境安装的Docker

  • 可新建docker_data文件夹统一管理映射路径

    mkdir -p /docker_data/{learnsite/app,mssql/data}
    

  • 绝对路径参考如下：

    	- /docker_data/
    		- learnsite
    		    - docker-compose.learnsite.yml
    		    + app
    		- mssql
    		    - docker-compose.mssql.yml
    		    + data
    

  • 提示：宿主机映射或挂载卷建议使用相对路径不容易出错（参考仓库中的几个docker-compose文件）

• 提示：本站为learnsite和数据库分开部署，如需一起部署请参考learnsite-docker仓库的docker-compose.yml

2. 合并部署【可选】

2.1 创建的文件夹路径

sudo -i
cd /path/to/learnsite-dir  #这里的绝对路径改成你自己的

2.2 下载 docker-compose.yml
wget https://raw.giteeusercontent.com/realiy/learnsite-docker/raw/main/docker-compose.yml
或者
curl -O https://raw.giteeusercontent.com/realiy/learnsite-docker/raw/main/docker-compose.yml
2.3 输入命令部署
docker compose -f docker-compose.yml up -d

3. 分开部署【可选】

部署MSSQL服务 docker-compose.mssql.yml

• 提醒：docker-compose.mssql.yml是为了适应群晖设备环境和基于习惯做出的修改。

• Linux环境下启动命令 ：

  # 先启动 mssql
  cd /path/to/mssql-dir  #这里的绝对路径改成你自己的
  docker compose -f docker-compose.mssql.yml up -d
  

• 群晖或飞牛FnOS

  • 新建项目
  • 复制粘贴docker-compose中的内容并修改环境变量
  • 构建该项目
    

4. 部署LearnSite服务 docker-compose.learnsite.yml

   • 提醒：docker-compose.learnsite.yml是为了适应群晖设备环境和基于习惯做出的修改。

   • Linux环境下启动命令 ：

     # 再启动 learnsite
     cd /path/to/learnsite-dir  #这里的绝对路径改成你自己的
     docker compose -f docker-compose.learnsite.yml up -d
     

   • 群晖或飞牛FnOS

     • 新建项目
     • 复制粘贴docker-compose中的内容并修改环境变量
     • 构建该项目
       

5. 至此，你可以打开浏览器输入 宿主机IP:8080 访问了

四。使用

• 进入教师管理界面
  • 默认用户名：admin
  • 默认密码：12345

五。参考及链接

• OpenLearnSite
• 原作者：温州水乡 Github
• Gitee：Learnsite2.0
• Gitee：LearnSite1.0 源码
• Gitee：LearnSite1.0 成都版分支源码
• Github：learnsite2.0 docker
• Gitee：learnsite2.0 docker (同步Github镜像)
• Docker仓库：learnsite2.0
• Docker仓库：mssql-learnsite
• Windows环境部署参考：
  • 新手配learnsite
  • PC教师机上windows7或10操作系统上的learnsite开源信息技术教学平台搭建与配置简易培训视频
  • SQL Server Management Studio (SSMS)