33
位學員 · 兩個場地同步
23
個網域 · 必需 10–14（視 CLI 路線）
4
個本機監聽埠
9/18
上機日（五）
! 先看這三件事
每一件都會造成「看起來都開了、實際還是不能用」。它們是這份清單裡最容易被跳過、後果卻最大的三項。
① 登入端點與 API 端點是兩回事。
只放行
只放行
api.* 會讓學員卡在登入畫面，連 API 都還沒開始用。詳見第 4 節網域表第 2、3、4、11 項。
② 受管電腦若設有強制 VPN／Proxy 回程，現場網路開得再完整都沒用。
流量會先繞回企業網路再出去，所以網域清單在企業那一側也必須成立。詳見 3.5。
流量會先繞回企業網路再出去，所以網域清單在企業那一側也必須成立。詳見 3.5。
③ 端點防護（EDR）的攔截是靜默的。
通常不會跳警告，只會「指令跑了沒反應」或「執行到一半中斷」。詳見 3.4。
通常不會跳警告，只會「指令跑了沒反應」或「執行到一半中斷」。詳見 3.4。
1 一頁摘要
本梯課程共 33 位學員，分在兩個上課場地同步進行。以下是全部需求的濃縮版。
| 類別 | 需求 |
|---|---|
| 權限 | 安裝階段需本機系統管理員權限 —— 並非每一項都需要，分項見 3.1 |
| 要安裝的軟體 | Python 3.11+、git、編輯器（建議 VS Code）、Node.js 22.15+、Claude Code CLI 或 Codex CLI（二擇一，不必兩套都裝）、Ollama、Docker Desktop（選配） |
| 虛擬化 | WSL2 或 Hyper-V 已啟用，且 BIOS 的虛擬化（VT-x／AMD-V）已開啟 |
| 網路 | 23 個網域的 TCP 443 出向。必需項因 CLI 二擇一而不同：共用 8 個 ＋ 所選路線 4 或 2 個 → 全班統一一套時 10–12 個，兩套都有人用則 14 個。另有 1 項可能需允許 WebSocket 升級。軟體安裝來源的網域另計，見 3.2 |
| 連線行為 | ① Proxy 不可對回應做 buffering ② TLS 解密需 CA 信任 ③ 不支援 SOCKS Proxy |
| 硬體 | 可用磁碟 ≥ 50 GB SSD、記憶體最低 8 GB／建議 16 GB、不需要獨立顯示卡 |
| 本機服務 | 允許執行本機子行程，並允許監聽 11434、1455、8000、8080 |
| 課前準備 | 地端模型檔約 4.3 GB，務必在 9/18 之前下載完成 |
2 技術上的依賴順序
這不是優先權建議，是技術依賴關係。後面那層沒開，前面那層仍然可用；前面那層沒開，課就進行不下去。時間不夠時，只做第一層。
第一層沒有它 → 完全無法進行
共用 8 個必需網域（第 5、12–18 項） ＋ 所選路線的必需網域（🅰 第 1–4 項／🅱 第 10、11 項） ＋ 軟體裝得起來（權限與安裝來源，見 3.1／3.2） ＋ TLS 解密之 CA 信任 ＋ 允許本機子行程 ＋ 本機埠
失敗形態：登入不了、裝不起來，或連上了卻被切斷。
11434（🅱 路線另需 1455）失敗形態：登入不了、裝不起來，或連上了卻被切斷。
第二層不影響上課本身
網域表第 6–9 項。缺了會讓安裝方式受限、文件查詢與版本說明拿不到。
例外：若走 🅰 路線且採原生安裝器（非 npm）安裝，第 6 項即為該路徑的必要端點。
例外：若走 🅰 路線且採原生安裝器（非 npm）安裝，第 6 項即為該路徑的必要端點。
第三層僅影響容器部署段與瀏覽器工作台
網域表第 19–23 項 ＋ WSL2／Hyper-V ＋ BIOS 虛擬化 ＋ 本機埠
8000／8080。課程原始需求單載明此段有替代路徑（容器部署改用簡化示範）。不需要無影響
網域表 E 組全部 —— 列出來是為了避免過度放行。
關於「地端模型」的定位：課程單載明地端軌與遠端軌都是課程功能、兩軌都要實際接通，遠端軌不是單純的備援。因此第 17、18 項（地端模型網域）列在第一層；能否啟用 WSL2／容器才是第三層。
把必需網域直接複製到防火牆規則
兩套 AI CLI 是二擇一 —— 下面依路線分成三段。共用那 8 個一定要開；🅰 與 🅱 依實際使用的工具擇一開，或在混用時兩段都開。
# ── 共用必需（8）· 不論選哪套 CLI 都要 ── registry.npmjs.org pypi.org files.pythonhosted.org github.com codeload.github.com objects.githubusercontent.com ollama.com registry.ollama.ai # ── 🅰 Claude Code 路線（4）· 選 🅱 者不需要 ── api.anthropic.com claude.ai claude.com platform.claude.com # ── 🅱 Codex CLI 路線（2）· 選 🅰 者不需要 ── api.openai.com chatgpt.com
3 這些電腦分成兩種情況
學員帶來上課的電腦，有的是公司配發（受設備政策管控），有的是個人自備。兩種情況要確認的事差很多。
| 需求項 | 公司配發 | 個人自備 |
|---|---|---|
| 本機系統管理員權限 | 主要關卡 | 通常本來就有 |
| 軟體安裝白名單 | 主要關卡 | 不適用 |
| 允許本機服務與子行程 | 主要關卡 | 視個人防毒設定 |
| 端點防護（EDR）攔截 | 主要關卡 | 視個人設定 |
| 強制 VPN／Proxy 回程 | 最易忽略 | 通常不適用 |
| WSL2／Hyper-V 已啟用 | 常被政策鎖住 | 通常可 |
| BIOS 虛擬化已開啟 | 可能被鎖 | 通常可 |
| 23 個網域出向放行 | 有強制隧道則適用 | 依現場網路 |
| 磁碟 ≥50GB／RAM ≥8GB | 兩者皆適用 | 兩者皆適用 |
| 不需獨立顯示卡 | 兩者皆適用 | 兩者皆適用 |
第一件事是先分辨這兩類各有幾台。若全為個人自備，第 4 節大半可以跳過；只要有一台是公司配發，第 4 節就是重點。
一個常見誤判：「個人自備」不等於「沒有管理代理」。自備但已納入 MDM／EDR 管理的機器，第 4 節仍然適用 —— 判準是「這台機器是否受集中管理」，不是「誰買的」。
4 受管電腦要確認的五件事
這一節每一項都寫成「會不會擋」而不是「要做什麼」，因為實際的設備政策長什麼樣，只有管理這些機器的人查得到。
安裝階段需要管理員權限，但不是每一項都需要：
| 軟體／動作 | 是否一定需要管理員 |
|---|---|
| WSL2／Hyper-V 功能啟用 | 一定需要 Windows 系統功能，非軟體安裝 |
| Docker Desktop | 視安裝模式 官方提供 per-user 模式，安裝與更新不需管理員（代價：不安裝特權助手服務，Hyper-V backend 與 Windows 容器不可用，WSL 2 backend 可用）；all-users 模式則需要 |
| Ollama | 不需要 官方明載，預設裝在使用者目錄 |
| Python 3.11+ | 不需要 可安裝於使用者目錄（per-user install） |
| git／編輯器 | 不需要 兩者皆有 per-user 安裝版 |
| Node.js | 視方式 MSI 安裝需提權；官方另提供免安裝 zip，解壓至使用者目錄則不需要 |
| AI CLI（二擇一） | 不需要 以 npm 安裝於使用者目錄即可（npm 本身需先有 Node.js） |
建議確認兩件事
- 是安裝當下臨時提權即可，還是課程期間的日常操作也需要？（後者權限面大得多，本課程不需要）
- 若群組原則統一收回管理員權限，需要的是例外清單或臨時提權流程，不是永久授權
若有「可安裝軟體清單」機制（AppLocker、WDAC、受管派送等），以下多半不在既有清單內。
注意：兩套 AI CLI 是二擇一 —— 每位同仁只需要其中一套（依帳號取得情況決定），不必兩套都放行。
| 軟體 | 用途 | 安裝來源 |
|---|---|---|
| Python 3.11 以上 | 課程主要語言、測試與跑台 | python.org 或 Microsoft Store |
| git | 取得課程教材與範例程式 | git-scm.com |
| 編輯器（課程建議 VS Code，非強制） | 開發編輯器 | code.visualstudio.com |
| Node.js 22.15 以上 | 下方 AI CLI 若以 npm 安裝則需要 | nodejs.org |
| 🅰 Claude Code CLI | AI 開發工具 —— 與下一列二擇一 | npm 套件 @anthropic-ai/claude-code；亦有原生安裝器 |
| 🅱 Codex CLI | AI 開發工具 —— 與上一列二擇一 | npm 套件 @openai/codex |
| Ollama | 地端小模型執行環境 | ollama.com/download |
| Docker Desktop | 容器化部署段（選配） | docker.com |
Node.js 的版本下限不是隨手寫的：🅰 Claude Code 需要 Node 22.15 以上才讀得到作業系統憑證庫（該版本起提供對應 API）。低於此版本、且環境有 TLS 解密檢查時，需改以
此門檻只涵蓋 🅰 這條路線的 CLI 本身，
NODE_EXTRA_CA_CERTS 指定企業根憑證。此門檻只涵蓋 🅰 這條路線的 CLI 本身，
npm／pip／git 等工具在 TLS 解密環境下有各自的憑證設定，需分別確認；🅱 Codex CLI 走的是另一組變數（見 5.2 第 2 項）。上表的「安裝來源」本身也要連得到。若採直接下載安裝，
這幾個網域不在第 5 節那 23 項清單內 —— 那份清單是「工具裝好之後要連的」，這幾個是「裝得起來要連的」，兩者不同。
python.org、git-scm.com、code.visualstudio.com、nodejs.org、docker.com、ollama.com 這些網域同樣需要放行；若採受管派送或預先提供安裝包，則不需要。這幾個網域不在第 5 節那 23 項清單內 —— 那份清單是「工具裝好之後要連的」，這幾個是「裝得起來要連的」，兩者不同。
這一項最常被漏，因為它不在任何網域清單上。
課程會在學員的機器上：
- 啟動本機監聽服務（地端模型服務、簡易 HTTP 伺服器、容器服務）
- 由 AI CLI 大量派生子行程（shell、Python 直譯器、套件管理器）
需確認
- 允許本機（loopback）監聽埠
11434（地端模型服務）、1455（登入回呼，擋住會卡登入）、8000（課程自檢頁面）、8080（容器部署段） - 允許應用程式派生子行程，未被軟體限制政策（SRP／AppLocker script rules）阻擋
- 跨來源設定（選配）：地端模型服務預設已允許
127.0.0.1與0.0.0.0來源；僅當課堂頁面以其他 origin（例如http://localhost:8000）直接呼叫它時，才需要以OLLAMA_ORIGINS加入該 origin。實際需要的值需在課堂當下確認
以上皆為本機連線、不對外開放，不需要防火牆入向規則。
這一項的失敗方式最難察覺。AI CLI 執行時會大量建立子行程、頻繁對外連線、讀寫工作目錄，這組行為特徵與部分惡意程式相近，容易被判為可疑而靜默阻擋。
- 症狀通常不是跳出警告，而是指令跑了沒反應、或執行到一半中斷（實際行為視各家防護產品而異）
- 若有集中管理的 EDR，建議事先確認是否需要加例外
會被觀察到的執行檔／行程名（Windows，供建立精準例外用）
| 行程 | 來自 |
|---|---|
| claude（或 claude.exe） | 🅰 Claude Code 路線（擇一） |
| codex（或 codex.exe） | 🅱 Codex CLI 路線（擇一） |
| node.exe | 上述 CLI 以 npm 安裝時的執行環境 |
| python.exe／pip.exe | 課程跑台與套件安裝 |
| ollama.exe／ollama app.exe | 地端模型服務 |
| git.exe／bash.exe | 取得教材、CLI 派生的 shell |
| Docker Desktop.exe／com.docker.* | 容器部署段（選配） |
例外範圍建議收斂：以代理執行檔及其子行程為 key 建立例外是常見做法，但這會使同樣的行為由被放行的進程執行時也一併通過。建議依實際攔截事件逐案處理。
如果受管電腦設有強制 VPN 或強制 Proxy（forced tunnel／always-on VPN／SASE 代理），那麼即使人在上課現場、接的是現場的網路，流量仍然會先繞回企業網路再出去，這代表網域清單在企業這一側也必須成立。
建議確認三件事
- 受管電腦是否有強制隧道？課程期間是否可關閉或走分流（split tunnel）？
- 若不可關閉 → 第 2 節「第一層」的必需網域需在企業的出向政策上放行
- 企業 Proxy 是否對 HTTPS 做解密檢查？（若有，見第 5 節「連線行為」第 2 項）
5 網路需求
5.1 網域白名單（TCP 443 出向）
先讀這段，否則會多開一整組網域。兩套 AI CLI 是二擇一，所以必需網域分成三塊：共用 8 個（第 5、12–18 項，不論選哪套都要）＋ 🅰 Claude Code 路線 4 個（第 1–4 項）或 🅱 Codex CLI 路線 2 個（第 10、11 項）。
→ 全班統一 🅰 ＝ 12 個｜統一 🅱 ＝ 10 個｜兩套都有人用 ＝ 14 個。
→ 全班統一 🅰 ＝ 12 個｜統一 🅱 ＝ 10 個｜兩套都有人用 ＝ 14 個。
registry.npmjs.org（第 5 項）列在共用，因為兩套 CLI 都是用 npm 安裝。| # | 網域 | 用途 | 必要性 | 來源 |
|---|---|---|---|---|
| A · 🅰 Claude Code 路線（選 🅱 者不需要） | ||||
| 1 | api.anthropic.com | API 請求、網域安全檢查 | 必需 | 課程單＋官方文件 |
| 2 | claude.ai | 帳號認證 | 必需 | 官方文件 |
| 3 | claude.com | 登入時瀏覽器開啟的頁面（再轉向 claude.ai） | 必需 | 官方文件 |
| 4 | platform.claude.com | OAuth token 交換／刷新／撤銷 | 必需 | 官方文件 |
| 5 | registry.npmjs.org | npm 安裝 CLI 本體（兩套路線共用） | 必需 | 官方文件 |
| 6 | downloads.claude.ai | 原生安裝器與自動更新（以 npm 安裝者可不放行） | 建議 | 官方文件 |
| 7 | raw.githubusercontent.com | 版本說明擷取 | 建議 | 官方文件 |
| 8 | code.claude.com | 內建文件查詢（擋掉只影響文件查詢） | 建議 | 官方文件 |
| 9 | storage.googleapis.com | plugin 中繼資料 | 建議 | 官方文件 |
| B · 🅱 Codex CLI 路線（選 🅰 者不需要） | ||||
| 10 | api.openai.com | API 端點（串流回應亦走此） | 必需 | 課程單＋官方文件 |
| 11 | chatgpt.com | 以帳號登入所需（非 API 金鑰路徑） | 必需 | 官方文件 |
| C · 套件與教材來源（共用，兩條路線都需要） | ||||
| 12 | pypi.org | Python 套件索引 | 必需 | 課程單 |
| 13 | files.pythonhosted.org | pip 實際下載套件檔案的 CDN | 必需 | 課程單 |
| 14 | github.com | 課程教材與範例程式 | 必需 | 課程單 |
| 15 | codeload.github.com | 原始碼壓縮檔下載 | 必需 | 課程單 |
| 16 | objects.githubusercontent.com | 檔案內容下載 | 必需 | 課程單 |
| D · 地端模型與容器（共用，兩條路線都需要） | ||||
| 17 | ollama.com | 地端模型執行環境本體下載 | 必需 | 課程單 |
| 18 | registry.ollama.ai | 模型檔實際下載來源（約 4.3 GB） | 必需 | 課程單 |
| 19 | registry-1.docker.io、auth.docker.io | 容器映像的 registry 與 token 認證（課程單另寫 *.docker.io 萬用字元，但實際只需這兩台） | 建議 | 課程單＋實測 |
| 20 | production.cloudfront.docker.com | 映像層（blob）實體下載 CDN —— 前一項通了但這項沒通，docker pull 會在下載階段失敗 | 建議 | Docker 官方 allowlist |
| 21 | hub.docker.com | Docker Hub 網站與 API（不參與 docker pull 協定，課程單有列故保留） | 建議 | 課程單 |
| 22 | huggingface.co | 模型替代載點（選配） | 建議 | 課程單 |
| 23 | ai.google.dev | 模型說明與授權頁（選配） | 建議 | 課程單 §7 參考連結 |
E · 明確不需要（列出來是為了避免過度放行）
| 網域 | 用途 | 判定 |
|---|---|---|
| http-intake.logs.us5.datadoghq.com、browser-intake-us5-datadoghq.com | 🅰 路線工具的選用運作遙測 | 選填 官方標示可停用 |
| bridge.claudeusercontent.com、*.frame.claudeusercontent.com | 瀏覽器擴充功能的 WebSocket bridge | 本課程不使用 |
| mcp-proxy.anthropic.com | 從網頁版帶入的外掛連接器代理 | 不需放行 |
① 第 2、3、4、11 項是登入端點，第 5 項是安裝來源 —— 這五項不在課程原始需求單上，是依兩家廠商的官方網路設定文件補上的。只放行原始單上的項目，學員會卡在登入畫面、或根本裝不起來。這是最容易漏、也最致命的一組。
② 第 13、15、16、18、20 項是實際下載檔案的來源。只放行
pypi.org／github.com／ollama.com／registry-1.docker.io 而未放行它們，安裝或下載會在取檔階段失敗。③ 必需項總數視 CLI 路線而定：共用 8（第 5、12–18 項）＋ 🅰 4（第 1–4 項）或 🅱 2（第 10、11 項） → 統一 🅰 ＝ 12｜統一 🅱 ＝ 10｜混用 ＝ 14。建議 9 項（第 6–9、19–23 項）不受路線影響，全表合計 23 項。
④ 這 23 項是「工具裝好之後要連的」；軟體安裝來源的網域另見 3.2，若採受管派送則不需要。
④ 這 23 項是「工具裝好之後要連的」；軟體安裝來源的網域另見 3.2，若採受管派送則不需要。
5.2 連線行為（這三項比白名單更容易出事）
| # | 項目 | 適用 | 說明 |
|---|---|---|---|
| 1 | Proxy 不可對回應做 buffering | 🅰 路線 | 以 Server-Sent Events 串流回應。官方明載其 watchdog 判準為「線路上沒有 bytes 抵達，含 SSE keep-alive ping」（180–300 秒）。「緩衝式 Proxy 吞掉 keep-alive → 觸發 watchdog」是依該機制所做的推論，官方未明述。 |
| 2 | TLS 解密檢查（若有） | 兩條路線 處理方式不同 | 🅰 Claude Code：根憑證已裝於 OS 信任區、且執行環境讀得到時無需額外設定（npm 安裝者需 Node 22.15 以上）；不成立時才需以 NODE_EXTRA_CA_CERTS 指定。🅱 Codex CLI：另有自己的變數 CODEX_CA_CERTIFICATE，未設定時才回退 SSL_CERT_FILE。依所選路線處理對應那一組即可；若同一批機器兩套都有人用，兩組都要設。 |
| 3 | WebSocket 升級（可能需要） | 🅱 路線 | 該工具的 Responses API 支援 WebSocket 傳輸，若採用則需允許 HTTP 101 Switching Protocols（對第 10 項 api.openai.com）。被擋時不會報錯，只會卡住不動。此項為可配置傳輸方式，是否實際啟用未經本地實測，列出是因為它被擋時最難當場排除。 |
補充一 🅰 Claude Code 官方明載不支援 SOCKS Proxy；🅱 Codex CLI 依社群回報會讀 ALL_PROXY，無官方文件佐證。
補充二 若以環境變數配置 Proxy，HTTP_PROXY／HTTPS_PROXY 的值必須含完整 scheme（http://proxy:8080，不能只寫 proxy:8080）。官方明載這是啟動時唯一會驗證的設定，格式錯誤會直接中止啟動。
補充三 🅰 Claude Code 官方明載 WebSocket 連線不經 Proxy 送往 localhost／127.0.0.0/8。該保證只涵蓋 WebSocket —— 3.3 那幾個本機埠走的是一般 HTTP，不在保證範圍內。
6 硬體、虛擬化與本機服務
6.1 硬體
| 項目 | 需求 |
|---|---|
| 可用磁碟空間 | ≥ 50 GB SSD（模型與容器映像佔用大） |
| 記憶體（RAM） | 最低 8 GB／建議 16 GB 以上 —— 這兩級用的模型不同，見 6.3 |
| 顯示卡 | 不需要獨立顯示卡（GPU） |
一個容易誤採購的點：課程規劃階段（8 月版）曾提及「地端 LLM 最低需求：NVIDIA 顯示卡 6–8 GB VRAM」，但 2026-09-10 的最新環境需求單已明確改為「不需要獨立顯示卡」（課程改用 2B/4B 級小模型，一般辦公筆電的 CPU 就跑得動；有 NVIDIA GPU 或 Apple Silicon 會自動加速，屬加分非必要）。請以較新版本為準，勿依舊版規格篩選機器。
6.2 虛擬化
- WSL2 或 Hyper-V 已啟用且可用（不只是「沒被政策鎖住」，課程單要求的是已啟用）
- BIOS／UEFI 的虛擬化（VT-x／AMD-V）已開啟
BIOS 這一層要最早確認，因為處理方式差很多：
- 若已部署韌體管理能力（如 Intune DFCI，或 Dell／HP／Lenovo 的 BIOS 設定工具），通常可以遠端派送開啟（需 OEM 與韌體支援，且變更多半要重開機一次）
- 若沒有這類能力 → 只能逐台進 BIOS，在 33 台的規模下這是需要提早排的工作
6.3 課前必須完成的下載
這一項不是 IT 放行事項，但會直接影響當天進度，所以列在這裡。地端模型檔需在 2026-09-18 之前下載完成（走
registry.ollama.ai）。| 機器記憶體 | 使用的模型（課程單載明之參考 tag） | 下載量 |
|---|---|---|
| 16 GB 以上（一般） | gemma4:e2b-it-qat（課程預設） | 約 4.3 GB |
| 8 GB 級（弱機） | gemma3:1b（弱機備援） | 較小 |
tag 可能異動 —— 課程單註明實際請以官方最新版為準，可用 ollama list 確認當下拉到的版本。
強烈建議課前完成下載：33 位學員若在上課當天同時各拉數 GB，對任一場地的現場網路都是明顯負擔，且會直接佔用課程時間。
6.4 本機連接埠與服務
以下皆為本機（loopback）連線，不對外開放，不需要防火牆入向規則，但需確認未被端點防護或主機型防火牆阻擋。
| 埠 | 用途 | 何時使用 |
|---|---|---|
| 11434 | 地端模型服務（可用 OLLAMA_HOST 變更） | 地端模型段（常駐） |
| 1455 | 🅱 Codex CLI 路線登入時的 OAuth 回呼監聽（固定埠）—— 選 🅰 者不需要 | 每次登入（極短暫） |
| 8000 | 課程自檢頁面用的簡易 HTTP 伺服器 | 瀏覽器工作台段（短暫） |
| 8080 | 容器部署段的服務埠 | 容器部署段（短暫） |
1455 埠依官方登入文件所列，本地未實測；它只屬 🅱 Codex CLI 路線。列出的理由是：若主機型防火牆禁止應用程式監聽任意本機埠，登入流程會在瀏覽器完成授權後卡住，而這個症狀很難聯想到本機埠。選 🅱 路線時它屬第 2 節第一層。
🅰 Claude Code 路線的登入回呼埠，本文件未查證 —— 該路線同樣以瀏覽器完成授權，若出現「授權完成卻卡住」的相同症狀，請一併往本機監聽埠的方向查。
🅰 Claude Code 路線的登入回呼埠，本文件未查證 —— 該路線同樣以瀏覽器完成授權，若出現「授權完成卻卡住」的相同症狀，請一併往本機監聽埠的方向查。
6.5 作業系統範圍
本清單以 Windows 受管環境為主要情境撰寫（權限機制以群組原則／AppLocker／WDAC 為例）。若有 macOS 機器：軟體清單與網域需求完全相同，但——
- 權限與政策機制不同（MDM profile 取代群組原則）
- 虛擬化不需要 WSL2／BIOS VT-x 設定
- 驗收與診斷指令不同
若有 macOS 機器，建議及早告知課程方，會另外提供對應的說明。
7 驗收方式
課程已提供官方自檢腳本 preflight_check.py（隨教材包發給學員），回報 PASS／WARN／FAIL。
但在把它當成驗收依據之前，有三件事必須先知道。
① 它只測 6 個網域，必需項大部分沒測到
實際測試清單為 pypi.org、github.com、api.anthropic.com、api.openai.com（FAIL 級）＋ ollama.com、hub.docker.com（WARN 級）。對照 5.1 的必需清單：共用 8 個只測了 3 個、🅰 路線 4 個只測了 1 個、🅱 路線 2 個只測了 1 個。沒有測到：
| 沒測到的 | 本清單怎麼標它 |
|---|---|
| claude.ai、claude.com、platform.claude.com、chatgpt.com | 最容易漏、也最致命的一組（登入端點） |
| files.pythonhosted.org、codeload.github.com、objects.githubusercontent.com | 實際下載檔案的來源 |
| registry.npmjs.org | 第 5 項 · 必需（CLI 安裝來源） |
| registry.ollama.ai | 第 18 項 · 必需（4.3 GB 模型檔的實際來源） |
腳本全 PASS 不代表必需網域都通了。這幾項需另以瀏覽器或既有 IT 工具逐一確認。
② 它要先裝好 Python 才跑得動
而「能不能裝 Python」正是本清單在請求確認的事項之一 —— 驗收必然晚於放行。
③ 它驗「連得到」，不驗「用得動」
登入流程是否走得完、端點防護是否在執行中攔截，都測不到。
建議的順序
| 序 | 動作 | 由誰 | 完成條件 |
|---|---|---|---|
| 1 | 確認並處理第 4 節（端點政策）與第 2 節第一層（必需網域） | 設備政策管理方 | 政策面確認完畢 |
| 2 | 安裝 3.2 的軟體清單 | 學員（必要時協助提權） | 軟體裝得起來 |
| 3 | 執行 preflight_check.py | 學員 | 逐項 PASS／WARN／FAIL |
| 4 | 把結果回傳課程方 | 學員 | — |
最低通過標準：第 2 節第一層全部 PASS。第三層相關項目（Docker／容器）出現 WARN 可以接受，課程對該段有替代示範。
腳本之外必須人工補驗的兩件事：
- 登入流程是否走得完（🅰 路線看第 2、3、4 項；🅱 路線看第 11 項與 1455 埠）
- 端點防護是否會在執行中攔截（3.4 的靜默阻擋，只有實際跑起來才會出現）
一台成功不等於全部成功 —— 不同的機型、設備政策、作業系統與場地網路都可能有不同結果。建議在 9/17（四）下班前，讓每一種組合（公司配發／個人自備 × 各場地）至少各有一台完成過這件事。
8 這份清單的證據等級
下表分兩個軸：來源可靠度（依據有多硬）與本地驗證狀態（有沒有實際跑過）。兩者是不同的事 —— 有官方文件不代表已實測，實測過也不代表涵蓋所有情境。
| 內容 | 來源可靠度 | 本地驗證 | 依據 |
|---|---|---|---|
| 硬體規格、地端模型網域（17–18）、容器網域、本機埠 11434、模型 tag 與課前下載、虛擬化需求、本機服務與子行程 | 高 | — | 課程官方環境需求單（2026-09-10），逐項對照 |
| 🅰 路線 9 個網域、SOCKS 不支援、CA 信任條件、SSE watchdog 機制、Proxy scheme 驗證 | 高 | — | 2026-09-14 直接讀取官方企業網路設定文件，就本課程適用範圍逐項核對（該文件另列數項本課程用不到的主機，未納入） |
production.cloudfront.docker.com、auth.docker.io 的角色分工 | 高 | 部分實測 | Docker 官方 allowlist 文件；另 2026-09-15 實測映像登錄庫回 401 並指向認證主機 |
| npm 套件名稱與版本 | 高 | 實查 | 2026-09-15 直接查詢套件登錄庫 |
| 本機埠 8000／8080、跨來源（CORS）設定 | 中 | 未測 | 不在官方需求單上 —— 由課程實作教材（地端模型設定說明、部署說明）比對後補出 |
| 🅱 路線 2 個網域、CA 環境變數、1455 登入回呼埠 | 中 | 未測 | 該廠商未提供官方網域白名單文件；依其官方登入／設定文件彙整 |
| Windows per-user 安裝免管理員（3.1） | 中 | 未測 | 各軟體官方安裝文件 |
| BIOS 虛擬化可否遠端派送（6.2） | 中 | 未測 | 韌體管理平台與各 OEM 工具之官方文件 |
| WebSocket 傳輸是否實際啟用 | 推論 | 未測 | 官方列為可配置傳輸方式 |
| 「緩衝式 Proxy 會觸發 watchdog」的因果 | 推論 | 未測 | 由官方機制描述推出，官方未明述 |
| 端點防護與強制隧道的影響（第 4 節） | 通則 | 未測 | 企業 IT 常見情形，實際政策未知 —— 故該節全部寫成「請確認」 |
因此請以實機測試作為最終驗收依據，不要僅以本清單為準。若測試中出現本清單未涵蓋的網域被阻擋，該網址是補進清單的最好素材。
課程環境需求 · 技術內容基準日 2026-09-15 · 本頁不含任何單位或人員資訊