Scholarsome本地部署教程：在Ubuntu服务器上搭建私人学习平台

【免费下载链接】scholarsomeWeb-based interactive flashcard learning software项目地址: https://gitcode.com/gh_mirrors/sc/scholarsome

Scholarsome是一款基于Web的交互式闪卡学习软件，通过本地部署可以搭建专属的私人学习平台。本文将详细介绍如何在Ubuntu服务器上通过Docker Compose快速部署Scholarsome，让你拥有一个功能完整的个人学习系统。

📋 准备工作：部署前的必要检查

在开始部署Scholarsome之前，需要确保你的Ubuntu服务器满足以下条件：

• Ubuntu 20.04或更高版本的操作系统
• 至少2GB内存和20GB可用磁盘空间
• 已安装Docker和Docker Compose

Docker是Scholarsome官方推荐的部署方式，也是唯一的必要依赖。如果你的服务器尚未安装Docker，可以通过以下命令快速安装：

# 更新软件包索引 sudo apt update # 安装Docker依赖 sudo apt install -y apt-transport-https ca-certificates curl software-properties-common # 添加Docker官方GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - # 添加Docker软件源 sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" # 安装Docker和Docker Compose sudo apt update sudo apt install -y docker-ce docker-compose-plugin # 将当前用户添加到docker组（避免每次使用sudo） sudo usermod -aG docker $USER

安装完成后，建议注销并重新登录，使Docker用户组设置生效。

🚀 快速部署：使用Docker Compose一键搭建

Docker Compose是官方推荐的部署方式，它不需要额外配置数据库，所有依赖都通过容器化方式管理。以下是详细步骤：

1. 创建专用目录

首先创建一个用于存放Scholarsome配置和数据的目录：

mkdir ~/scholarsome && cd ~/scholarsome

2. 下载配置文件

获取官方提供的Docker Compose配置文件：

wget https://raw.githubusercontent.com/hwgilbert16/scholarsome/release/compose.yml

3. 配置环境变量

下载环境变量示例文件并创建正式配置：

wget https://raw.githubusercontent.com/hwgilbert16/scholarsome/release/.env.compose.example && cp .env.compose.example .env

使用文本编辑器打开.env文件进行配置：

nano .env

需要重点配置的核心参数如下：

配置完成后保存并退出编辑器。

4. 启动服务

使用以下命令在后台启动Scholarsome服务：

docker compose --env-file .env up -d

首次启动会自动下载所需镜像，可能需要几分钟时间。启动成功后，可以通过以下命令检查容器状态：

docker compose ps

如果所有服务状态都显示为"Up"，说明部署成功！

图1：Scholarsome闪卡学习界面展示 - 在Ubuntu服务器上部署后即可获得的交互式学习体验

🔧 进阶配置：SSL证书与外部访问

如果需要通过HTTPS访问Scholarsome或从外部网络访问，还需要进行以下额外配置：

配置SSL证书

1. 打开compose.yml文件：

nano compose.yml

2. 找到并取消注释以下行（大约在第29行）：

# - "(your ssl port):8443"

3. 将"(your ssl port)"替换为你想要使用的SSL端口（通常是443）：

- "443:8443"

4. 在.env文件中添加SSL证书的Base64编码内容：

SSL_KEY_BASE64=你的SSL私钥Base64编码 SSL_CERT_BASE64=你的SSL证书Base64编码

防火墙设置

如果服务器启用了防火墙，需要开放相应端口：

# 开放HTTP端口 sudo ufw allow 80/tcp # 开放HTTPS端口（如果配置了SSL） sudo ufw allow 443/tcp

✨ 开始使用：访问与初始设置

部署完成后，通过浏览器访问服务器的IP地址或域名（根据.env文件中的HOST配置）：

• 如果使用默认HTTP端口：http://你的服务器IP或域名
• 如果配置了HTTPS：https://你的服务器IP或域名

首次访问时，系统会引导你创建管理员账户。创建完成后，你可以开始使用Scholarsome的全部功能，包括：

• 创建和管理学习集
• 使用闪卡进行记忆练习
• 组织学习内容到文件夹
• 导入/导出学习材料

图2：Scholarsome学习集管理界面 - 部署后可立即创建和管理你的学习内容

📚 官方文档与资源

Scholarsome提供了详细的官方文档，可帮助你深入了解更多功能和配置选项：

• 完整安装指南：apps/docs/docs/installation/installing.md
• 开发指南：apps/docs/docs/development/development-guide.md
• 使用教程：apps/docs/docs/usage/overview.md

🛠️ 常见问题解决

服务无法启动怎么办？

检查容器日志以获取详细错误信息：

docker compose logs

如何更新Scholarsome？

进入部署目录并执行以下命令：

docker compose pull docker compose down docker compose --env-file .env up -d

数据存储在何处？

使用Docker Compose部署时，所有数据（包括数据库和媒体文件）都存储在Docker卷中，位于/var/lib/docker/volumes/目录下。

🎯 总结

通过Docker Compose在Ubuntu服务器上部署Scholarsome是一个简单高效的过程，只需几个步骤就能搭建起功能完善的私人学习平台。无论是学生、教师还是终身学习者，Scholarsome都能帮助你更高效地组织和记忆知识。现在就开始你的本地部署之旅，打造专属的学习空间吧！

【免费下载链接】scholarsomeWeb-based interactive flashcard learning software项目地址: https://gitcode.com/gh_mirrors/sc/scholarsome