Intelligent Agent 實作研習 / 多頁教材版
Chapter 8｜GB10 教學環境設計
以多使用者、共用 Ollama、安全與可重建環境為主軸，說明如何準備 20 人研習工作站。
教師研習
理論 + 架構 + 實作
RWD + 深色模式
Mermaid + 程式碼範例
學習目標
- 理解單機多使用者的 GB10 教學架構。
- 知道如何共用 Ollama 而避免使用者互相干擾。
- 能設計安全、可控、可重建的研習環境。
Linux 多使用者架構
teacher
user01
user02
...
user20每位學員各自擁有
- 獨立 Home Directory
- SSH 登入
- Git 設定
- Claude Code / OpenClaw 設定
- API Keys
- Python Environment
- Node Environment
flowchart TD
T[teacher] --> G[GB10 Linux Host]
U1[user01] --> G
U2[user02] --> G
U20[user20] --> G
G --> H1[/home/teacher]
G --> H2[/home/user01]
G --> H3[/home/user02]
G --> H4[/home/user20]
G --> O[Ollama :11434 共用服務]
Ollama 共用原則
- 所有使用者共用
localhost:11434。 - 模型只下載一次。
- 所有學員共用同一份模型檔。
- 不必為每位學員重複安裝模型。
安全性建議
學員不可 sudo
避免誤改系統、降低環境失控風險。
Docker 僅教師可用
避免容器資源競爭與權限擴張。
只管理自己的 Home
降低互相覆蓋設定、刪檔與環境污染。
Node / Python 建議
- Node：使用 nvm 或 mise，不要直接綁系統 Node。
- Python：使用 uv + venv，避免所有人共用套件。
Golden Image 與 /etc/skel
可將 aliases、Git、uv、nvm、VS Code CLI、Ollama Client、OpenClaw Template、Claude Code Template、範例專案放在 /etc/skel，讓每位新學員帳號建立時都擁有相同起始環境。
實作練習
請學員描述：若你要管理 20 位學員的帳號，哪些設定該由教師預先處理？哪些設定應保留給學員自己完成？
教師部署檢查清單
課前一週
- 建立 teacher 與 user01-user20 帳號。
- 完成 /etc/skel 與範例專案準備。
- 下載 workshop 需要的 Ollama 模型。
- 測試 SSH、Git、Node、Python 是否正常。
上課前一天
- 逐一登入抽測 2-3 個學員帳號。
- 確認 localhost:11434 可被所有帳號呼叫。
- 確認磁碟空間、GPU / RAM、網路與投影環境。
- 準備 API Key 配發策略與備援方案。
常見錯誤
- 所有人共用同一組 Python site-packages，導致套件版本互相污染。
- 直接使用系統 Node，造成不同 CLI 工具版本衝突。
- 沒有先 pull 好本地模型，上課時 20 人一起下載塞爆頻寬。
- 未限制 sudo / docker，導致學員能改動整台工作站環境。