—— AI 平台的一站式安装、更新与维护
受众：集团内小学—初中—高中信息与人工智能教师
时长：30 分钟
主旨：让老师具备在 Ubuntu 上独立搭建一套完整的「校园大模型平台」的能力。
内容包含：OnePanel 安装 → Ollama 安装 → OpenWebUI 部署 → 更新与备份策略。
🎯 本课你将学到
如何在 Ubuntu 上安装 OnePanel（可视化部署平台）
如何在 OnePanel 中安装并运行 Ollama（本地大模型后端）
如何部署 OpenWebUI（用户访问界面）
如何更新 Ollama、OpenWebUI 与模型
如何做备份、迁移、恢复（适用于校园环境）
如何制定「学校 AI 服务」的日常维护策略
🧩 01 部署前准备：Ubuntu 环境检查
在终端执行三条命令确保系统状态良好：
✔️ 更新系统
sudo apt update && sudo apt upgrade -y
✔️ 确认 Docker 未占用端口（如有冲突可提前处理）
sudo systemctl status docker
✔️ 安装基础工具（推荐）
sudo apt install curl git -y
🧱 02 安装 OnePanel（最适合学校的可视化部署面板）
OnePanel 是一款轻量级、支持 Docker 容器管理的图形化面板，非常适合没有专职运维的学校使用。
🚀 第 1 步：下载安装脚本
curl -fsSL https://get.onepanel.cn/install.sh -o install.sh
sudo bash install.sh
安装完成后，你会看到类似：
Panel URL: http://<你的服务器IP>:3000
默认用户：admin
默认密码：onepanel
在浏览器访问：
http://服务器IP:3000
首次登录后建议立即修改密码。
🐳 03 在 OnePanel 中安装 Docker 环境（如果系统未安装）
OnePanel 检测到系统没有 Docker 时，会提示你安装：
点击「安装 Docker」
等待 1–3 分钟自动完成
完成后，就可以使用「软件商店」与「容器管理」。
🧠 04 安装 Ollama（本地大模型后端）
Ollama 是学校环境最适合的本地模型运行框架，支持 Llama / Qwen / Gemma / Mistral 等轻量模型。
🚀 第 1 步：在服务器直接安装 Ollama
在 Ubuntu 执行：
curl -fsSL https://ollama.com/install.sh | sh
完成后输入：
ollama --version
确认安装成功。
🚀 第 2 步：运行一个测试模型
ollama pull llama3
ollama run llama3
如果能正常对话，说明后端运行正常。
🖥️ 05 在 OnePanel 中部署 OpenWebUI（大模型 Web 界面）
OpenWebUI 是一个浏览器访问的大模型界面，老师与学生最容易使用。
🚀 第 1 步：进入 OnePanel →「软件商店」
搜索：OpenWebUI
点击「安装」，设置端口（推荐 3000）：
3000:8080
左边是对外访问端口，右边是容器内部端口。
安装后访问：
http://服务器IP:3000
首次登录会要求创建管理员账号。
🚀 第 2 步：将 OpenWebUI 连接到 Ollama
进入 OpenWebUI → Settings → Providers → Ollama：
将地址填入：
http://服务器IP:11434
这是 Ollama 默认的 API 端口。
刷新一下，你就可以在 OpenWebUI 中看到所有已经安装的模型。
🔄 06 更新与维护（学校环境尤为重要）
✔️ 更新 OnePanel
在面板右上角会提示「有更新」，点击升级即可。
✔️ 更新 Ollama
在终端执行：
curl -fsSL https://ollama.com/install.sh | sh
重新安装即覆盖升级，不会影响已下载模型。
✔️ 更新已安装的模型
例如更新 Llama3：
ollama pull llama3
✔️ 更新 OpenWebUI
在 OnePanel 中：
打开 OpenWebUI 应用
点击「更新镜像」
点击「重新部署」
所有用户会自动使用新版界面。
📦 07 备份策略（学校必须掌握）
“备份”是学校 AI 平台能否长期稳定运行的关键。
📁 一、备份模型（Ollama）
模型存储路径：
/usr/share/ollama/
备份方式：
sudo cp -r /usr/share/ollama /mnt/backup/
📁 二、备份 OpenWebUI 配置
容器化部署时，你会配置类似：
-v openwebui_data:/app/backend/data
备份数据卷：
docker volume inspect openwebui_data
找到真实路径后复制即可。
📁 三、OnePanel 备份策略
OnePanel 提供：
配置备份
应用镜像备份
自动导出应用配置
你可以将备份下载至：
NAS
校内文件服务器
外接移动硬盘（加密）
🔁 08 迁移与恢复（服务器更换时必用）
当学校服务器换新机器，只需：
安装最新 Ubuntu
安装 OnePanel
拷回备份文件
恢复应用与数据卷
拉起 OpenWebUI + Ollama
整个迁移过程 < 30 分钟。
🧭 09 如何维持稳定运行？（给学校的运营建议）
✔️ 1. 给这台机器固定 IP
避免重启后变化。
✔️ 2. 给每个应用固定端口
如：
3000 → OpenWebUI
11434 → Ollama
✔️ 3. 控制可访问范围（建议只在校内网开放）
✔️ 4. 每月定期更新一次模型与镜像
✔️ 5. 做一个备份日（例如每月 1 号）
📌 第 5 课课后任务
在个人或学校 Ubuntu 机器完成：
安装 OnePanel
安装 Ollama
在 OnePanel 中安装 OpenWebUI
成功运行一个本地大模型
将 OpenWebUI 与 Ollama 进行连接
测试是否可从其他电脑访问
http://服务器IP:3000完成一次模型备份与一次恢复演练
