Paddock：自架 AI 代理沙箱與 Linux 工作環境

Paddock 是做什麼的？白話說明

Paddock 就像替 AI 代理準備一台專用 Linux 電腦。你先把軟體部署到自己管理的 VPS，再建立稱為 Box 的工作環境，裡面有專案檔案、工具與 Ubuntu XFCE 桌面。代理可以執行指令、編譯應用程式，還能打開畫面並截圖檢查結果。環境可以長期保留，也能在單次任務結束後刪除。

官網提供專案介紹和安裝入口。實際操作前需要自行架設伺服器。Paddock 負責管理執行環境，任務本身仍由你選擇的代理和模型處理。

讓代理開發程式，也看得到實際成果

Box 可透過 Sysbox 在內部執行 Docker，並提供 SSH 和檔案傳輸。Claude Code、Codex、OpenCode、Pi、Prime、Kimi 已預先安裝，但服務登入及模型驗證要自行設定，不能把預裝解讀成附送模型使用額度。

你可以用 paddock prompt 指派任務，或直接使用 CLI 執行指令。需要確認圖形介面時，以 paddock desktop 開啟桌面、透過 exec --desktop 啟動應用程式，再用 paddock screenshot 保存畫面。網頁管理介面、HTTP API、TypeScript 與 Python SDK 則提供不同的整合方式。

自架條件與第一次專案測試

官方安裝文件要求 Ubuntu 或 Debian VPS、root 權限、amd64 或 arm64 架構，以及開放的 80、443 連接埠。還需要指向伺服器的主機名稱，可依文件使用自己的網域或 sslip.io。伺服器資源要配合預計執行的工作量安排。

安裝完畢後，開啟一次性的擁有者設定連結建立帳號，再在自己的電腦安裝 CLI 並登入。文件提供 Windows、macOS 和 Linux 用戶端方式；Paddock skill 可讓支援的程式開發代理操作 CLI。

以下流程會建立一小時後自動停止的 Box、上傳本機 Node 專案、執行測試，最後停止環境：

paddock new --type small --ttl 3600
paddock push current . --to /config/project
paddock exec current -- bash -lc 'cd /config/project && npm test'
paddock stop current

請閱讀測試輸出來確認結果。專案需要可用的測試指令和相依套件；若要下載套件，網路規則必須允許必要來源。停止前會建立檔案系統快照。刪除臨時 Box 前，應先用 pull 取回需要的檔案與成果。

持續儲存、快照與還原的差異

Paddock 支援停止、繼續、fork 和快照還原，可讓代理沿用工具與檔案，或從既有環境分出新任務。掛載於 /mnt 的具名磁碟會在 Box 刪除後保留資料，適合快取和可重複使用的輸入檔。

快照文件說明，快照僅保存檔案系統，不包含記憶體、正在執行的程序、/var/lib/docker 或掛載磁碟內容。因此還原 Box 不代表程序會從原本的同一個執行位置繼續；重要磁碟資料仍須另外備份。

網路權限與外部模型的資料界線

網路模式有 allow-all、deny-all，以及網域／IPv4 網段允許清單。新 Box 預設採用 allow-all，需主動選擇限制。deny-all 阻擋新的連外連線，現有連線可能完成；雲端中繼資料存取則在各模式都會被阻擋。

設定清單時要納入模型 API、程式碼託管與套件來源。完全斷網的環境無法自行下載相依套件或呼叫遠端模型。自架讓你掌握執行伺服器，但送到外部供應商的內容仍適用對方的資料處理條件，不能因此宣稱完全不外傳或絕對不會發生沙箱逃逸。

開源授權、費用與適用對象

於 2026 年 10 月 29 日核實，Paddock 採用 MIT 授權。檢查的官方資料未列出 Paddock 代管訂閱方案。VPS、儲存、流量和模型服務可能分別收費，沒有適用所有部署的統一月費。可同時執行的 Box 數量也取決於伺服器容量。

它適合需要掌控代理工作環境、檢視桌面成果，且能維護 Linux、更新、權限與備份的開發者和技術團隊。

常見問題

Paddock 免費而且開源嗎？

MIT 原始碼可取得，核實的資料未要求軟體訂閱。自備主機與外部 AI 服務的費用仍需自行負擔。

可以從 Windows 或 macOS 操作嗎？

可以，官方有對應 CLI 安裝說明。伺服器本身仍需符合文件的 Linux 部署條件。

沙箱建立後就沒有網路嗎？

不會，預設是 allow-all。請依任務設定 deny-all 或允許清單，並檢查必要服務是否可達。

官方資源與開發者資料

• 官方 GitHub 專案：原始碼及完整技術參考。
• 版本與下載：用戶端檔案和版本資訊。