# openlearnsite
**Repository Path**: yjcf/openlearnsite
## Basic Information
- **Project Name**: openlearnsite
- **Description**: 信息科技学习平台LearnSite2.0
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 9
- **Created**: 2026-05-04
- **Last Updated**: 2026-05-04
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# LearnSite 信息技术学习平台
[](https://gitee.com/nylon26/openlearnsite/releases)
## 项目介绍
[LearnSite](https://www.openlearnsite.com) 是一个专为中小学信息技术课堂设计的**开源教学辅助平台**。它通过整合新课教学、作业提交、作品互评、课堂测验及资源管理等功能，将教师从繁重的批改与统计中解放出来，让教学更聚焦于课堂本身。
平台支持**高度定制**：教师可按需开关功能模块、调整界面，甚至绑定学生IP实现精细化管理。同时，活跃的社区持续推动其进化——2026年初的更新已加入**网页课件活动、物联网/人工智能体验（如人脸识别、AI绘画）及在线协作工具**，紧跟技术前沿。
## 开发协作
- 团队协作规范：[`CONTRIBUTING.md`](CONTRIBUTING.md)
- 持续变更记录：[`CHANGELOG.md`](CHANGELOG.md)
- 单次版本发布说明：`RELEASE_NOTES_YYYY-MM-DD.md`
## 功能结构
### 平台架构
- **学生平台**：网站首页、我的课程、我的作品、常识测验、打字练习、资源下载
- **教师平台**：上课、备课、作品、签到、学生、测验、打字、资源、信息、状态
- **系统后台**：系统设置、班级设置、教师管理、新生导入、空间生成、学年升班、系统退出
### 核心特色
- **多平台支持**：Docker、Linux、Windows 全平台部署
- **丰富的教学工具**：编程学习、AI 体验、Scratch 积木编程、在线协作表格等
- **完整的评价体系**：作业互评、课堂表现、测验排行
- **智能管理**：学生 IP 绑定、自动签到、成绩统计
## 多平台部署指南
### Docker 部署
OpenLearnSite信息科技学习平台Docker部署文件
- OpenLearnSite运行环境：
[](https://hub.docker.com/r/orzg/learnsite-web)
**快速部署**
```yaml
version: '3.8'
services:
mssql:
image: mcr.microsoft.com/mssql/server:2022-latest
container_name: mssql_server
restart: unless-stopped
environment:
- ACCEPT_EULA=Y
- MSSQL_SA_PASSWORD=YourStrong@Passw0rd123
- MSSQL_PID=Express
- TZ=Asia/Shanghai
- MSSQL_COLLATION=Chinese_PRC_CI_AS
ports:
- "1433:1433" # 暴露 SQL Server 端口到宿主机（可选）
volumes:
- mssql_data:/var/opt/mssql
networks:
- learnsite_net
healthcheck:
test: ["CMD-SHELL", "/opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P 'YourStrong@Passw0rd123' -C -Q 'SELECT 1' || exit 1"]
interval: 30s
timeout: 10s
retries: 5
start_period: 60s
command: >
sh -c "
/opt/mssql/bin/sqlservr &
sleep 30 &&
/opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P 'YourStrong@Passw0rd123' -C -Q \"
EXEC sp_configure 'show advanced options', 1;
RECONFIGURE;
EXEC sp_configure 'remote login timeout', 30;
RECONFIGURE;
EXEC sp_configure 'remote query timeout', 600;
RECONFIGURE;
EXEC sp_configure 'remote proc trans', 0;
RECONFIGURE;
\"
wait
"
learnsite:
image: orzg/learnsite-web:dev
container_name: learnsite
restart: always
ports:
- "8080:8080" # 宿主端口9000映射到容器8080
volumes:
- ./app:/app
environment:
- MONO_IOMAP=all
- DB_HOST=mssql # 使用服务名连接，自动解析到 mssql 容器
- DB_NAME=learnsite
- DB_USER=sa
- DB_PASSWORD=YourStrong@Passw0rd123
- AUTO_UPDATE_SOURCE=true
- PRIMARY_REPO_URL=https://gitee.com/nylon26/openlearnsite
- BRANCH=dev
networks:
- learnsite_net
depends_on:
mssql:
condition: service_healthy # 等待 mssql 健康后再启动 learnsite
volumes:
mssql_data:
name: mssql_server_data
networks:
learnsite_net:
name: learnsite_network
driver: bridge
```
**启动命令**
```bash
docker-compose up -d
```
**停止命令**
```bash
docker-compose down
```
### Linux 部署
**1. 安装依赖**
```bash
# Ubuntu/Debian
sudo apt-get update
sudo apt-get install -y mono-complete mono-xsp4
# CentOS/RHEL
sudo yum install -y mono-complete mono-xsp4
```
**2. 部署步骤**
1. **下载发布包**
```bash
git clone https://gitee.com/nylon26/openlearnsite /var/www/openlearnsite
```
2. **配置权限**
```bash
sudo chown -R www-data:www-data /var/www/openlearnsite
sudo chmod +x /var/www/openlearnsite
```
3. **启动 XSP4 服务器**
```bash
cd /var/www/openlearnsite
xsp4 --port 8080 --address 0.0.0.0 --nonstop
```
4. **设置为系统服务** (可选)
创建 `learnsite.service` 文件：
```ini
[Unit]
Description=LearnSite Web Application
After=network.target
[Service]
WorkingDirectory=/var/www/openlearnsite
ExecStart=/usr/bin/xsp4 --port 8080 --address 0.0.0.0 --nonstop
Restart=always
User=www-data
[Install]
WantedBy=multi-user.target
```
```bash
sudo systemctl enable learnsite.service
sudo systemctl start learnsite.service
```
### Windows 部署
**1. 安装依赖**
- **.NET Framework 4.8** (Windows 10/11 已内置)
- **IIS** (Internet Information Services)
- **SQL Server** (Express 版本即可)
**2. 部署步骤**
1. **下载发布包**
从 Gitee Releases 下载最新的 `latest-v2.0.x_xxx.zip`
2. **解压到 IIS 目录**
解压到 `C:\inetpub\wwwroot\openlearnsite`
3. **配置 IIS**
- 打开 IIS 管理器
- 创建新网站，指向 `C:\inetpub\wwwroot\openlearnsite`
- 端口设置为 80 或其他可用端口
- 应用池设置为 `.NET Framework v4.0`
4. **配置数据库**
- 运行 `sql/learnsite.sql` 创建数据库
- 修改 `web.config` 中的连接字符串
5. **启动网站**
在 IIS 管理器中启动网站
### 数据库配置
**MSSQL 连接字符串**
```xml
```
**首次运行**
1. 访问 `http://localhost:8080` (Docker/Linux) 或 `http://localhost/learnsite` (Windows)
2. 系统会自动重定向到 `upgrade.aspx` 进行初始化
3. 按照提示完成数据库配置
## 相关资源
- **LearnSite 学习平台讨论 QQ 群**：5847120
- **官方网站**：[OpenLearnSite](https://www.openlearnsite.com/)
- **原作者**：[温州水乡 Github](https://github.com/WaterCountry/Learnsite)
- **代码仓库**：
- [Gitee: LearnSite2.0](https://gitee.com/nylon26/openlearnsite)
- [下一代LearnSite（规划中）](https://gitee.com/aymwoo/OpenLearn-Next)
- [Gitee：LearnSite 1.x 主仓库源码](https://gitee.com/jnschool/learnsite-wz)
- [Gitee：LearnSite 1.x 成都版分支源码](https://gitee.com/jnschool/game/tree/master/LearnSite_ChengDu)
- [Github：learnsite-docker](https://github.com/RealKiro/learnsite-docker)
- [Gitee：learnsite-docker (同步 Github 镜像)](https://gitee.com/realiy/learnsite-docker)
- **Docker 仓库**：
- [learnsite-web](https://hub.docker.com/r/orzg/learnsite-web)
## 未来规划 TODO
- [ ] Github Actions/Gitee流水线 自动化编译与发布测试流 (Release latest稳定版/alpha预览测试版)
- [ ] Github Actions/Gitee流水线 自动化Windows运行环境测试流
- [ ] Github Actions/Gitee流水线 自动化Linux运行环境测试流
- [x] Github Actions/Gitee流水线 自动化Docker运行环境测试流
- [ ] 数据库备份增强与优化
- [ ] 适配MySQL数据库
- [ ] 适配SQLite数据库
- [ ] 适配PostgreSQL数据库
- [ ] 适配Redis
- [ ] 适配插件中心（方便外挂自建服务如easyvoice、peinture、飞象老师课件等）
- [ ] 代码精简与屎山优化（移除过时服务如kindeditor）
- [ ] 使用现代化技术栈前后端重构
## 核心贡献者
感谢所有为 LearnSite 项目做出贡献的开发者！
---
** LearnSite - 让信息技术教学更简单、更高效！**
