DICloak Agent Docker Image cho tự động hóa trình duyệt phía máy chủ

Chạy DICloak Agent trong Docker cho quy trình headless và phía máy chủ. Mở Agent API trên cổng 52100, chuyển tiếp cổng CDP 45000-45099, lưu dữ liệu runtime trong /dicloak/data và kết nối Playwright hoặc Puppeteer qua webSocketDebuggerUrl được trả về.

Dùng thử Xem tài liệu

4 bước để khởi chạy container DICloak Agent

Kéo Agent Image

Kéo dicloakinc/dicloak-agent-image:latest từ Docker Hub. Kernel trình duyệt được tải khi cần, nên lần mở profile đầu tiên có thể lâu hơn.

Khởi động bằng Docker Compose

Dùng Docker Compose với TOKEN hoặc USER_EMAIL và USER_PASSWD, AGENT_PORT=52100, DOCKER=1 và volume bền vững /dicloak/data.

Xác minh Agent API

Kiểm tra http://127.0.0.1:52100/agent/status và /agent/user-info để xác nhận trạng thái sẵn sàng, đăng nhập, số profile đang chạy và tiến trình tải kernel.

Mở profile và kết nối

Mở profile trình duyệt qua quy trình DICloak Local API hiện có, đọc debug_port, gọi /json/version và kết nối Playwright hoặc Puppeteer bằng webSocketDebuggerUrl.

Vì sao triển khai DICloak Agent bằng Docker?

Docker giúp tự động hóa phía máy chủ có runtime lặp lại được, phiên đăng nhập bền vững và ranh giới mạng rõ ràng.

Vấn đề thường gặp

Cài đặt desktop khó tái lập trên CI, máy chủ cloud và host tự động hóa chạy lâu dài.
Tự động hóa trình duyệt cần phiên đăng nhập và dữ liệu profile sống qua restart mà không cần sửa thủ công.
Cổng CDP và Local API có rủi ro nếu bị mở ra ngoài mà không có binding host rõ ràng.
Dùng sai loại tài khoản có thể ảnh hưởng phiên đang hoạt động của nhóm và làm rối việc xoay vòng thông tin đăng nhập.

Giải pháp Docker Agent

Runtime Agent lặp lại được
Triển khai cùng dicloak-agent-image trên development, staging và production với cấu hình do Compose quản lý.
Dữ liệu profile bền vững
Giữ kernel, user-data, extension, log và cache trong thư mục /dicloak/data đã mount để tái sử dụng phiên an toàn.
Ranh giới cổng rõ ràng
Publish Agent API trên 52100 và mặc định bind dải CDP vào localhost, trừ khi thiết kế mạng của bạn cần khác.
Vận hành tài khoản gọn hơn
Chạy Docker bằng tài khoản thành viên nội bộ chuyên dụng để quyền, trách nhiệm và credential rotation dễ quản lý.

Năng lực Agent cốt lõi trong Docker

Runtime DICloak Agent hướng production cho phiên trình duyệt đã đăng nhập bền vững, cô lập profile và tự động hóa CDP.

Agent API trên cổng 52100

Container mở HTTP Agent API trên 52100 để kiểm tra trạng thái, xem phiên tài khoản và phối hợp với luồng Local API của bạn.

Dải cổng CDP chuyển tiếp

Cổng debug trình duyệt được chuyển tiếp qua 45000-45099. Hãy gọi /json/version trên debug_port được trả về trước khi kết nối framework tự động hóa.

Dữ liệu runtime bền vững

Gắn /dicloak/data để giữ kernel trình duyệt đã tải, thư mục user-data của profile, extension, log và cache runtime qua các lần restart.

Triển khai tài khoản an toàn

Dùng tài khoản thành viên chuyên dụng có quyền Local API hoặc Docker. Không mở cổng 52100 ra public nếu thiếu firewall, VPN hoặc reverse proxy.

Tối đa 100 phiên trình duyệt

Dải CDP đã map hỗ trợ tối đa 100 instance trình duyệt đồng thời, mỗi profile hoạt động có debug_port riêng.

Vòng đời Docker Compose

Dùng template Compose để quản lý cập nhật image, restart policy, giới hạn tài nguyên, shared memory, reuse proxy host và cấu hình ổn định.

Triển khai khuyến nghị bằng Docker Compose

Agent image hiện tại cần Compose quản lý biến đăng nhập, cổng Agent API 52100, CDP forwarding và lưu trữ bền vững /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

Biến đăng nhập

Chọn TOKEN hoặc USER_EMAIL cộng USER_PASSWD. Nếu có cả token và email login, Agent ưu tiên email và mật khẩu.

Lưu bền vững /dicloak/data

Dùng host bind mount cho kernel, user-data, extension, log và cache. Nhiều instance phải dùng thư mục dữ liệu host khác nhau.

Map cổng an toàn

Ánh xạ 52100 cho Agent API và mặc định bind 45000-45099 vào 127.0.0.1. Bảo vệ 52100 nếu có thể truy cập từ public network.

Vòng đời một lệnh

Chạy docker compose up -d để start, docker compose pull để update và docker compose logs -f dicloak-agent để xem log runtime.

Các nhóm xây gì với DICloak Agent Docker?

Agent image dành cho tự động hóa phía máy chủ cần danh tính trình duyệt ổn định, phiên bền vững và kết nối CDP.

Phiên trình duyệt cho AI Agent

Cung cấp cho AI agent phiên trình duyệt đã đăng nhập có thể lưu lại, mở lại và điều khiển qua CDP trong workflow server-side.

Dịch vụ tự động hóa trình duyệt

Chạy Playwright hoặc Puppeteer với profile DICloak trên server trong khi vẫn cô lập fingerprint, storage và danh tính profile.

CI và tác vụ định kỳ

Dùng container lặp lại được cho tác vụ trình duyệt định kỳ, kiểm thử hồi quy hoặc workflow cần trạng thái profile ổn định.

Vận hành nhiều tài khoản

Chạy môi trường trình duyệt riêng cho nhiều tài khoản, giữ thư mục user-data và giảm can nhiễu giữa các phiên.

Xác minh quảng cáo và nội dung

Mở profile qua Local API và kiểm tra trang theo vùng, vị trí quảng cáo và trải nghiệm đã đăng nhập trong phiên có kiểm soát.

Theo dõi thương mại điện tử

Theo dõi giá theo vùng, tồn kho, khuyến mãi và trang theo tài khoản bằng profile bền vững và kết nối CDP có kiểm soát.

Tích hợp với toolchain tự động hóa và Agent

DICloak Agent Docker hoạt động với framework tương thích CDP và stack tự động hóa phía máy chủ sau khi luồng Local API mở profile trình duyệt.

Playwright

Puppeteer

Selenium

OpenAI Agents

Claude MCP

Gemini

Docker Compose

Kubernetes

GitHub Actions

AWS ECS

Bắt đầu với DICloak Agent Docker

Docker Hub: dicloakinc/dicloak-agent-image