Docker-образ DICloak Agent для серверной автоматизации браузера

Запускайте DICloak Agent в Docker для headless- и серверных процессов. Откройте Agent API на порту 52100, перенаправьте CDP-порты 45000-45099, сохраняйте данные в /dicloak/data и подключайте Playwright или Puppeteer через возвращенный webSocketDebuggerUrl.

4 шага для запуска контейнера DICloak Agent

1

Загрузите образ Agent

Загрузите dicloakinc/dicloak-agent-image:latest из Docker Hub. Ядра браузера скачиваются по требованию, поэтому первый запуск профиля может занять больше времени.

2

Запустите через Docker Compose

Используйте Docker 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 и подключите Playwright или Puppeteer через webSocketDebuggerUrl.

Зачем разворачивать DICloak Agent в Docker?

Docker дает серверной автоматизации воспроизводимую среду, постоянные авторизованные сессии и понятные сетевые границы.

Типичные проблемы

  • Desktop-установки сложно воспроизводить в CI, облачных серверах и долгоживущих automation-хостах.

  • Автоматизации браузера нужны авторизованные сессии и данные профилей, которые переживают перезапуск без ручного восстановления.

  • CDP-порты и Local API становятся рискованными, если открыты без явных привязок к хосту.

  • Неверный тип аккаунта может мешать активным командным сессиям и усложнять ротацию учетных данных.

Docker Agent решение

  • Воспроизводимый runtime Agent

    Разворачивайте один и тот же dicloak-agent-image в development, staging и production с настройками под управлением Compose.

  • Постоянные данные профилей

    Храните ядра, user-data, расширения, логи и кеш в смонтированном каталоге /dicloak/data, чтобы безопасно переиспользовать сессии.

  • Явные границы портов

    Публикуйте Agent API на 52100 и по умолчанию привязывайте диапазон CDP к localhost, если сеть не требует другого.

  • Более чистая эксплуатация аккаунта

    Запускайте Docker с отдельным внутренним аккаунтом участника, чтобы права, ответственность и ротация были проще.

Ключевые возможности Agent в Docker

DICloak Agent для production-сценариев: постоянные авторизованные браузерные сессии, изоляция профилей и автоматизация через CDP.

Agent API на порту 52100

Контейнер открывает HTTP Agent API на 52100 для проверки статуса, просмотра сессии аккаунта и координации с вашим потоком Local API.

Диапазон перенаправленных CDP-портов

Отладочные порты браузера перенаправляются через 45000-45099. Перед подключением фреймворка запросите /json/version на возвращенном debug_port.

Постоянные runtime-данные

Смонтируйте /dicloak/data, чтобы сохранять загруженные ядра браузера, user-data профилей, расширения, логи и кеш между перезапусками.

Безопасное развертывание аккаунта

Используйте отдельный аккаунт участника с нужными правами Local API или Docker. Не открывайте 52100 в интернет без firewall, VPN или reverse proxy.

До 100 браузерных сессий

Сопоставленный диапазон CDP поддерживает до 100 одновременных экземпляров браузера, каждый с собственным debug_port.

Жизненный цикл через Docker Compose

Используйте Compose-шаблон для обновлений образа, политики перезапуска, лимитов ресурсов, shared memory, host proxy и стабильных настроек.

Рекомендуемое развертывание Docker Compose

Текущий образ Agent ожидает login-переменные в Compose, порт Agent API 52100, CDP forwarding и постоянное хранилище /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 и email login, Agent предпочитает email и пароль.

Постоянный /dicloak/data

Используйте host bind mount для ядер, user-data, расширений, логов и кеша. Для нескольких экземпляров нужны разные host data directories.

Безопасное сопоставление портов

Сопоставьте 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 предназначен для серверной автоматизации, которой нужны стабильная browser identity, постоянные сессии и CDP-подключение.

Браузерные сессии для AI Agent

Дайте AI agent постоянные авторизованные браузерные сессии, которые можно переоткрывать и контролировать через CDP.

Сервисы браузерной автоматизации

Запускайте Playwright или Puppeteer против профилей DICloak на серверах, сохраняя изоляцию fingerprint, storage и profile identity.

CI и задания по расписанию

Используйте воспроизводимые контейнеры для scheduled browser tasks, регрессионных проверок и процессов с устойчивым состоянием профиля.

Мультиаккаунт-операции

Работайте с отдельными браузерными средами для разных аккаунтов, сохраняя user-data и уменьшая влияние между сессиями.

Проверка рекламы и контента

Открывайте профили через Local API и проверяйте региональные страницы, размещения рекламы и авторизованный опыт.

E-Commerce мониторинг

Отслеживайте региональные цены, остатки, промо и account-specific pages с постоянными профилями и управляемым CDP.

Интеграция с automation- и agent-стеками

DICloak Agent Docker работает с CDP-совместимыми фреймворками после открытия профиля через ваш поток Local API.

Playwright
Puppeteer
Selenium
OpenAI Agents
Claude MCP
Gemini
Docker Compose
Kubernetes
GitHub Actions
AWS ECS
Начать с DICloak Agent Docker

Docker Hub: dicloakinc/dicloak-agent-image