通訊埠、使用者、平台
- 在
$PORT提供 HTTP：依序取專案設定的通訊埠、映像檔唯一 EXPOSE 的通訊埠，都沒有就是 8080。 - 沒有設定非 root 的
USER時，改用 uid 10001、群組 0 執行。 - 只支援
linux/amd64，推送其他平台的映像檔會被拒絕。 - 要有
CMD或ENTRYPOINT啟動伺服器。 - 除了
/tmp，檔案系統都是唯讀。
Agent Lab CLI · Crescendo Agent Lab 部署
推送 Docker 映像檔，
直接部署上線。
Agent Lab CLI 幫你登入，讓 docker 可以推送到組織的映像檔登錄檔。把自己建好的映像檔推上去，就能用它部署專案的新版本。
$ npm install --global @crescendolab/agentlab-cli@alpha
$ agentlab login
Signed in to acme.
$ agentlab auth configure-docker
docker now uses agentlab for registry.agentlab.cresclab.com
$ docker push registry.agentlab.cresclab.com/<org-id>/web:v1
指令
安裝、登入、推送、部署
把 <org-id> 換成你的組織 ID。主控台的映像檔登錄檔頁面會顯示已經填好 ID 的指令。
- 1
安裝 CLI
npm install --global @crescendolab/agentlab-cli@alpha agentlab --version從 npm 安裝。需要 Node.js 24 以上，支援 macOS、Linux、Windows 的 x64 與 arm64。目前是 alpha 版，指令可能還會調整。
- 2
登入並設定 Docker
agentlab login agentlab auth configure-docker agentlab statusagentlab login 會開瀏覽器讓你登入並選擇組織；接著執行 agentlab auth configure-docker，docker 就會用這個登入存取登錄檔，不必再 docker login。
- 3
建置並推送映像檔
docker build --platform linux/amd64 -t registry.agentlab.cresclab.com/<org-id>/web:v1 . docker push registry.agentlab.cresclab.com/<org-id>/web:v1以 linux/amd64 建置（專案只在這個平台上執行），推送到你組織 ID 底下。
- 4
部署上線
在專案的「部署」分頁，於「部署新版本的來源」選「從映像檔」，再選倉庫與標籤。專案的第一個版本準備好就會自動上線，之後的版本按「上線」。
想從原始碼建置？請看用 Dockerfile 部署。
映像檔規則
映像檔要符合這幾點
自己推送的映像檔和從 Dockerfile 建置的映像檔，規則都一樣。
常用指令
agentlab login [--org <uuid>]：用瀏覽器登入。agentlab auth configure-docker：讓 docker 用這個登入存取登錄檔。agentlab status：顯示帳號、組織與登入到期時間。agentlab logout：登出，並移除這台電腦儲存的登入資料。
CLI 還是 MCP
兩種入口，同一個平台
MCP server 適合從 AI 工具部署；CLI 適合部署自己建好的 Docker 映像檔。
表格可以左右滑動。
| Agent Lab CLI | Agent Lab MCP server | |
|---|---|---|
| 適合的情況 | 你已經自己（或在 CI 裡）建置 Docker 映像檔 | 你請 Claude Code、Codex 或 Cursor 幫你部署 |
| 送出的內容 | 建好的映像檔，用 docker 推送 | 原始碼檔案，在平台上建置 |
| 登入方式 | agentlab login，在瀏覽器登入 | 從 AI 工具發起，在瀏覽器 OAuth 登入 |
| 安裝 | npm 套件（alpha 版） | 每個 AI 工具一行設定，不用安裝 |
常見問題
推送映像檔之前
Agent Lab CLI 怎麼安裝？
執行 npm install --global @crescendolab/agentlab-cli@alpha。需要 Node.js 24 以上，支援 macOS、Linux、Windows 的 x64 與 arm64，不需要安裝 Go。
還需要 docker login 嗎？
不用。執行 agentlab login，再執行一次 agentlab auth configure-docker，docker 就會用你的身分推送。在 CI 裡，請到主控台的部署設定建立 robot token，搭配 docker login 使用。
映像檔要推送到哪個位址？
registry.agentlab.cresclab.com/<org-id>/<名稱>:<標籤>，<org-id> 是你的組織 ID。主控台的映像檔登錄檔頁面會顯示完整指令。
Apple silicon 的 Mac 建出來的 arm64 映像檔可以推送嗎？
專案只在 linux/amd64 上執行，推送其他平台的映像檔會被拒絕。請用 docker build --platform linux/amd64 建置。
哪些方案有映像檔登錄檔？
Pro、Team 與 Business 方案有，Free 方案沒有。各方案保留幾個映像檔版本、多少儲存空間，請見方案頁。 方案與價格
CLI 和 MCP server 差在哪？
MCP server 讓 Claude Code、Codex 等 AI 工具幫你把原始碼部署上線；CLI 則是你自己建好 Docker 映像檔後，用它推送並部署。 設定 MCP server