TC

面向服務端瀏覽器自動化的 DICloak Agent Docker 映像檔

在 Docker 中執行 DICloak Agent，適用於 Headless 和服務端自動化流程。透過 52100 開放 Agent API，轉發 45000-45099 CDP 連接埠，將執行資料持久化到 /dicloak/data，並透過返回的 webSocketDebuggerUrl 連線 Playwright 或 Puppeteer。

立即試用查看文件

4 步啟動 DICloak Agent 容器

1

拉取 Agent 映像檔

從 Docker Hub 拉取 dicloakinc/dicloak-agent-image:latest。瀏覽器核心會按需下載，因此首次開啟環境可能耗時較長。

2

使用 Docker Compose 啟動

透過 Compose 設定 TOKEN 或 USER_EMAIL 與 USER_PASSWD、AGENT_PORT=52100、DOCKER=1，並掛載持久化 /dicloak/data 資料目錄。

3

驗證 Agent API

存取 http://127.0.0.1:52100/agent/status 和 /agent/user-info，確認就緒狀態、登入狀態、執行環境數量和核心下載進度。

4

開啟環境並連線

透過既有 DICloak Local API 流程開啟瀏覽器環境，讀取 debug_port，先請求 /json/version，再使用 webSocketDebuggerUrl 連線 Playwright 或 Puppeteer。

為什麼用 Docker 部署 DICloak Agent？

Docker 讓服務端自動化擁有可重現的執行時、可持久化的登入工作階段和清晰的網路邊界。

傳統痛點

  • 桌面安裝難以在 CI、雲端伺服器和長期執行的自動化主機之間重現。

  • 瀏覽器自動化需要登入工作階段和環境資料在重啟後繼續可用，而不是依賴人工修復。

  • 如果沒有清晰的主機綁定，CDP 連接埠和本地 API 暴露會帶來安全風險。

  • 使用錯誤的帳號類型可能干擾團隊活躍工作階段，也會讓憑證輪換變得混亂。

Docker Agent 方案

  • 可重現的 Agent 執行時

    在開發、測試、正式環境中部署同一個 dicloak-agent-image，並用 Compose 管理設定。

  • 持久化環境資料

    將核心、user-data、擴充套件、日誌和快取保存到掛載的 /dicloak/data 目錄，方便安全復用工作階段。

  • 明確的連接埠邊界

    透過 52100 發布 Agent API，並預設只將 45000-45099 的 CDP 連接埠段綁定到 localhost，除非你的網路設計另有要求。

  • 更清晰的帳號維運

    使用專用內部成員帳號執行 Docker，讓權限歸屬、操作責任和憑證輪換更容易管理。

Docker 中的核心 Agent 能力

面向正式環境的 DICloak Agent 執行時，支援持久登入瀏覽器工作階段、環境隔離和 CDP 自動化。

52100 連接埠上的 Agent API

容器透過 52100 開放 HTTP Agent API，可用於狀態檢查、帳號工作階段確認，並配合你的 Local API 自動化流程。

轉發 CDP 連接埠段

瀏覽器除錯連接埠透過 45000-45099 轉發。連接自動化框架前，請先在返回的 debug_port 上請求 /json/version。

執行資料持久化

掛載 /dicloak/data，持久保存下載後的瀏覽器核心、環境 user-data 目錄、擴充套件、日誌和執行快取。

安全的帳號部署

建議使用具備 Local API 或 Docker 權限的專用成員帳號。不要在缺少防火牆、VPN 或反向代理保護時把 52100 暴露到公網。

最多 100 個瀏覽器工作階段

映射的 CDP 連接埠段最多支援 100 個並行瀏覽器實例，每個活躍環境都會分配獨立 debug_port。

Docker Compose 生命週期管理

使用 Compose 範本統一管理映像更新、重啟策略、資源限制、共享記憶體、主機代理復用和穩定執行參數。

推薦使用 Docker Compose 部署

目前 Agent 映像檔需要 Compose 管理登入變數、52100 Agent API 連接埠、CDP 轉發連接埠和 /dicloak/data 持久化儲存。

docker-compose.ymlYAML
services:
dicloak-agent:
image: ${DICLOAK_AGENT_IMAGE:-dicloakinc/dicloak-agent-image:latest}
restart: unless-stopped
init: true
environment:
TOKEN: ${DICLOAK_TOKEN:-}
USER_EMAIL: ${DICLOAK_USER_EMAIL:-}
USER_PASSWD: ${DICLOAK_USER_PASSWD:-}
AGENT_PORT: ${DICLOAK_AGENT_PORT:-52100}
DOCKER: 1
BACKEND_URL: ${DICLOAK_BACKEND_URL:-https://gin-server.dicloak.com/gin}
AUTH_MODE: ${DICLOAK_AUTH_MODE:-remote}
CACHE_BASE_DIR: /dicloak/data
ports:
- '${DICLOAK_AGENT_PORT:-52100}:52100'
- '127.0.0.1:45000-45099:45000-45099'
volumes:
- ${DICLOAK_DATA_DIR:-./data}:/dicloak/data
- /etc/localtime:/etc/localtime:ro
shm_size: 1gb

登入變數

選擇 TOKEN 或 USER_EMAIL 加 USER_PASSWD。如果同時提供 Token 和信箱密碼，Agent 會優先使用信箱密碼登入。

持久化 /dicloak/data

使用主機 bind mount 保存下載核心、環境 user-data、擴充套件、日誌和快取。多個實例必須使用不同主機資料目錄。

安全連接埠映射

映射 52100 用於 Agent API，並預設將 45000-45099 綁定到 127.0.0.1。如果 52100 可被公網存取，必須增加網路層保護。

一條指令管理生命週期

執行 docker compose up -d 啟動，docker compose pull 更新，並用 docker compose logs -f dicloak-agent 查看執行日誌。

團隊在用 DICloak Agent Docker 打造什麼？

Agent 映像檔適用於需要穩定瀏覽器身分、持久工作階段和 CDP 連線能力的服務端自動化情境。

AI Agent 瀏覽器工作階段

為 AI Agent 提供可持久化的登入瀏覽器工作階段，並在服務端流程中透過 CDP 重新開啟和控制。

瀏覽器自動化服務

在伺服器上使用 Playwright 或 Puppeteer 操作 DICloak 環境，同時保持指紋、儲存和環境身分隔離。

CI 和排程任務

用可重現容器執行排程瀏覽器任務、回歸檢查或需要穩定環境狀態的服務端流程。

多帳號業務

為多個帳號執行獨立瀏覽器環境，持久保存 user-data 目錄，降低跨工作階段干擾。

廣告與內容驗證

透過 Local API 流程開啟環境，使用受控瀏覽器工作階段檢查區域頁面、廣告投放和登入態體驗。

電商監控

借助持久瀏覽器環境和受控 CDP 連線，監控區域定價、庫存、促銷和帳號相關頁面。

整合自動化和 Agent 工具鏈

當你的 Local API 流程開啟瀏覽器環境後，DICloak Agent Docker 可與相容 CDP 的框架和服務端自動化堆疊配合使用。

Playwright
Puppeteer
Selenium
OpenAI Agents
Claude MCP
Gemini
Docker Compose
Kubernetes
GitHub Actions
AWS ECS
立即開始使用 DICloak Agent Docker

Docker Hub: dicloakinc/dicloak-agent-image