Container Desk 0.2.0 教學：用原生 Mac 介面管理 Apple Container，部署第一個本機服務

在 Mac 上跑容器，啟動服務只是第一步。平常還要找映像檔、調整資源、查日誌、確認連接埠，再把測試用的容器整理乾淨。如果這些操作能集中在熟悉的 Mac 介面裡，嘗試新專案就能少一些來回切換。

Container Desk 0.2.0 已正式公開，原始碼採 Apache-2.0 授權。這是一款以 SwiftUI 製作的本機 Apple Container 管理 App，提供英文、繁體中文及簡體中文介面。本文從安裝開始，帶你建立一個真正能在瀏覽器打開的本機網頁服務。

下載 Container Desk 0.2.0 · 查看 GitHub 原始碼 · 完整繁體中文教學

Apple Container 負責執行，Container Desk 負責日常管理

Apple Container 是 Apple 開源的工具，透過輕量虛擬機在 Apple Silicon Mac 上執行 Linux 容器，並使用 OCI 相容映像檔。Container Desk 建立在這個引擎之上，把常用管理流程整理成圖形介面；它是獨立開發的應用程式，並非 Apple 官方產品。

VM 層級隔離有助於理解它的執行架構，但不代表容器自動成為區域網路上的另一台實體電腦。服務能否被連線，仍取決於網路及連接埠設定。本文使用 127.0.0.1，讓示範服務只從本機存取。

先看看它能幫你省下哪些步驟

• 搜尋到部署接在一起：搜尋 Docker Hub 映像、選擇標籤與架構，再進入容器設定。建立前可查看映像預設的啟動資訊。
• 資源配置更直覺：CPU 使用下拉選單，記憶體可拖曳滑桿或直接輸入數字；可選範圍取自主機規格。
• 找資訊不必一直換視窗：雙擊容器展開完整資訊，查看 CPU、記憶體、日誌及工作階段圖表；點擊 TCP 連接埠可開啟網址。連接埠對應的服務仍須支援網頁協定。
• 整理測試環境更方便：批量選取容器、檔案傳輸、儲存為映像，以及逐項確認未使用的映像、網路和儲存卷。
• 保留 Mac 的使用習慣：可調整側欄順序，使用 ⌘+／⌘− 縮放內容、⌘0 還原，並遵循系統減少動態效果設定。

開始之前：設備需求與下載檔案

本文對應 Container Desk 0.2.0。請準備 Apple Silicon Mac、macOS 26 以上，以及本版已測試的 Apple Container 1.5.0。不支援 Intel Mac；其他引擎版本的相容性不能直接視為已驗證。下載映像檔需要網路，首次完成時間也會受到網速影響。

• Container-Desk-0.2.0-arm64.dmg：安裝 App，使用者不需要編譯。
• Container-Desk-0.2.0-Quick-Start.zip：選用的三語教學、快速測試腳本及範例專案，不重複包含 DMG。
• Container-Desk-0.2.0-source.zip：同版原始碼、建置腳本與測試，供開發者研究或修改。
• SHA256SUMS.txt：用來核對下載檔案是否與發布內容一致。

從 v0.2.0 下載頁 取得檔案。只下載 DMG 時，在下載資料夾執行以下指令，將完整結果與 SHA256SUMS.txt 的同名項目比對：

shasum -a 256 Container-Desk-0.2.0-arm64.dmg

若已下載全部附件並放在同一個資料夾，可一次核對：

shasum -a 256 -c SHA256SUMS.txt

第一步：安裝 App，連接官方引擎

開啟 DMG，將 Container Desk.app 拖到「應用程式」，再從應用程式啟動。到左側「容器引擎」連接或安裝支援的官方 Apple Container，並視需要啟動引擎。App 與引擎分開安裝；需要管理員授權時由 macOS 顯示提示。

這個公開版只有 ad hoc 簽章，沒有 Developer ID 或 Apple 公證。首次開啟可能受到 macOS 阻擋，請先核對來源與校驗碼，再閱讀 安裝教學中的單一 App 開啟說明。不要為了安裝而全域關閉 Gatekeeper。公開發行不等於已取得 Apple 認證。

連線後，先在總覽核對主機 CPU、記憶體與系統資訊，再到設定切換語言。接下來的操作都以本機測試服務為例。

第二步：用圖形介面部署第一個網頁服務

在「映像檔」開啟「下載與快速部署」，搜尋 python，選擇官方 library/python、標籤 3.13-slim 與 Linux ARM64。也可以直接輸入：

docker.io/library/python:3.13-slim

按「下載並設定」，填入以下設定。主機連接埠若已被其他服務使用，請換成空閒埠，不要停止不相關的服務。

• 名稱：my-python-web。
• CPU：1；記憶體：512 MiB。
• 主機連接埠：18081；容器連接埠：8080，使用 TCP。
• 保留預設網路，不加入主機掛載、帳號密鑰或環境變數。
• 進階設定的入口程式：python3。命令參數如下，一行一個，不加 Shell 引號。

-u
-m
http.server
8080
--bind
0.0.0.0

按下建立後，容器會先保持已停止。選取它並按「啟動」，再點擊連接埠連結，或於瀏覽器開啟 http://127.0.0.1:18081/。看到 Python 的目錄列表，代表服務已能從本機連線。這是練習用 HTTP 服務，不是對外正式網站的部署範本。

雙擊容器可展開詳細資訊；在日誌中確認請求，並觀察資源用量。完成體驗後，停止並刪除 my-python-web。映像檔是獨立資源，確定其他容器不需要它時再移除。

想先確認環境正常？執行隨附快速測試

解壓 Quick Start 入門包，在該資料夾開啟終端機，先閱讀腳本，再依序執行：

bash quick-test.sh --check
bash quick-test.sh --run

--check 唯讀檢查設備與引擎。--run 會建立專用 BusyBox 容器，在 127.0.0.1:18080 驗證 HTTP、exec／日誌存取，以及停止再啟動後的檔案保留，最後清理這次建立的資源。不需要 Xcode、Python 或 sudo，也不會全域清除容器。

預期看到 PASS: 且結束代碼為 0；BLOCKED 或 FAIL 不算通過。若 18080 已被占用，可改用 bash quick-test.sh --run --port 18082，並確認新埠也空閒。

想把測試服務留在 App 裡操作，可執行：

bash quick-test.sh --run --keep

回到 App 重新整理，選取 cd-quick-… 容器，就能試看日誌、連接埠與檔案。--keep 會留下運行中的服務，完成後請依腳本印出的精確命令清理；不要把它留著就當成測試已自動收尾。

手上已有 Docker 專案，可以怎麼搬？

在「專案」匯入 Compose 設定，先閱讀相容性報告，再啟動支援的服務。Container Desk 也提供 Docker 專案轉換，以及選用已安裝的官方 Compose CLI 解析設定的流程。第一次可從入門包的 docs/examples/quick-web.yaml 開始，熟悉匯入、啟動與移除。

目前支援的是明確列出的設定子集。不支援的欄位會阻擋匯入；Docker 本機映像與儲存卷資料仍須另行遷移。尚未提供自動資料搬移、持續重啟監督或完整切換／回滾。若專案有資料庫或持久化資料，先依 Docker 轉換指南 規劃測試，不要直接把原環境刪掉。

架構也需要確認：優先選 ARM64 映像；AMD64 需要相容的 Rosetta 設定。選擇另一個架構不等於把原有二進位檔轉換成 ARM64。

0.2.0 的其他便利功能

複製容器適合從既有設定建立另一個測試實例。新副本會清除連接埠；環境變數與掛載需選擇加入，掛載預設唯讀。它不會複製儲存卷資料；需要保留容器可寫層變更時，可先儲存為映像，掛載資料仍不在快照內。

Registry 瀏覽可在支援的 HTTPS Registry V2 服務中查看目錄及標籤，再選擇部署。目錄認證與 CLI 拉取／推送認證分開處理；不同服務的認證流程不完全相同，不能視為支援所有私人倉庫。

磁碟用量與清理顯示真實用量，讓你逐項選擇資源；刪除前會重新檢查參照。整理空間前，仍應核對選取項目，尤其是可能含資料的儲存卷。

我們實際測到哪裡？

本版只在開發者自己的 M4 Mac mini、16 GiB 記憶體、macOS 26.7.1、Apple Container 1.5.0 上測試。後端 QA 記錄為 23 通過、0 失敗、6 明確略過；三語、深淺色與視窗尺寸矩陣通過 170 步，另有 68 步實機錄影流程。最終版本的相關平台與專案流程已重新驗證，60 分鐘連續觀察也通過。

這些數字不是百分之百程式碼覆蓋率，也不是跨設備效能保證。第二台 Mac、乾淨安裝、真實核心升級、外部私人 HTTPS 倉庫成功流程及完整人工無障礙驗收仍未完成。AI 模型導入延後，本版也沒有遠端主機管理與內嵌終端機。完整結果及限制列在 版本驗證紀錄 與 Release 的 Validation.json 附件。

看一段實機操作，再開始自己的第一個服務

觀看 67 秒 Container Desk 0.2.0 實機影片（繁體中文字幕）。影片與本文截圖都來自實際 App 操作，主機名稱已遮蔽。

如果你正在 Apple Silicon Mac 上試用 Apple Container，可以從一個本機網頁服務開始：下載 App、連接引擎、搜尋映像，再用介面查看運行狀態。遇到問題時，歡迎在 GitHub Issues 回報版本、設備、重現步驟與預期結果；分享日誌前請移除密碼、Token 及私人路徑。

下載 v0.2.0 正式版與快速測試包 · 閱讀完整教學 · 參與 Apache-2.0 開源專案

版本依據：Container Desk 0.2.0，2026 年 10 月 18 日。底層引擎的官方資訊請以 Apple Container 為準。