Imagen Docker de DICloak Agent para automatización de navegador en servidor

Ejecuta DICloak Agent en Docker para flujos headless y de servidor. Expón la Agent API en el puerto 52100, reenvía los puertos CDP 45000-45099, persiste datos en /dicloak/data y conecta Playwright o Puppeteer mediante el webSocketDebuggerUrl devuelto.

Probar Ver documentación

4 pasos para iniciar un contenedor DICloak Agent

Descarga la imagen Agent

Descarga dicloakinc/dicloak-agent-image:latest desde Docker Hub. Los kernels del navegador se descargan bajo demanda, por lo que el primer inicio de perfil puede tardar más.

Inicia con Docker Compose

Usa Docker Compose con TOKEN o USER_EMAIL y USER_PASSWD, AGENT_PORT=52100, DOCKER=1 y un volumen persistente /dicloak/data.

Verifica la Agent API

Consulta http://127.0.0.1:52100/agent/status y /agent/user-info para confirmar disponibilidad, sesión iniciada, perfiles en ejecución y progreso de descarga de kernels.

Abre un perfil y conecta

Abre un perfil mediante tu flujo DICloak Local API, lee debug_port, solicita /json/version y conecta Playwright o Puppeteer con webSocketDebuggerUrl.

¿Por qué desplegar DICloak Agent con Docker?

Docker da a la automatización de servidor un runtime reproducible, sesiones autenticadas persistentes y límites de red claros.

Problemas tradicionales

Instalacoes desktop sao dificeis de reproduzir em CI, servidores cloud e hosts de automacao de longa duracao.
Automacao de navegador precisa de sessoes logadas e dados de perfil que sobrevivam a reinicios sem reparo manual.
Portas CDP e Local API podem ser arriscadas quando expostas sem bindings claros no host.
Usar o tipo errado de conta pode interferir em sessoes ativas da equipe e complicar a rotacao de credenciais.

Solución Docker Agent

Runtime Agent reproduzivel
Implante o mesmo dicloak-agent-image em desenvolvimento, staging e producao com configuracoes gerenciadas pelo Compose.
Dados de perfil persistentes
Guarde kernels, user-data, extensoes, logs e cache em /dicloak/data montado para reutilizar sessoes com seguranca.
Limites de porta explicitos
Publique a Agent API em 52100 e mantenha a faixa CDP ligada ao localhost por padrao, salvo se sua rede exigir outro desenho.
Operacao de conta mais limpa
Execute Docker com uma conta interna dedicada para facilitar permissoes, responsabilidade e rotacao de credenciais.

Capacidades principales de Agent en Docker

Runtime DICloak Agent orientado a producción para sesiones de navegador autenticadas persistentes, aislamiento de perfiles y automatización CDP.

Agent API en el puerto 52100

El contenedor expone HTTP Agent API en 52100 para comprobar estado, inspeccionar la sesión de cuenta y coordinarse con tu flujo Local API.

Rango de puertos CDP reenviados

Los puertos de depuración del navegador se reenvían por 45000-45099. Consulta /json/version en el debug_port devuelto antes de conectar el framework.

Datos runtime persistentes

Monta /dicloak/data para conservar kernels descargados, directorios user-data de perfiles, extensiones, logs y caché entre reinicios.

Despliegue seguro de cuenta

Usa una cuenta miembro dedicada con permiso Local API o Docker. No expongas 52100 públicamente sin firewall, VPN o reverse proxy.

Hasta 100 sesiones de navegador

El rango CDP mapeado admite hasta 100 instancias simultáneas de navegador, cada una con su propio debug_port.

Ciclo de vida con Docker Compose

Usa la plantilla Compose para actualizaciones de imagen, política de reinicio, límites de recursos, shared memory, proxy del host y ajustes estables.

Despliegue recomendado con Docker Compose

La imagen Agent actual espera variables de login gestionadas por Compose, puerto 52100 de Agent API, CDP forwarding y almacenamiento persistente /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

Variaveis de login

Escolha TOKEN ou USER_EMAIL mais USER_PASSWD. Se ambos existirem, Agent prefere login por email e senha.

/dicloak/data persistente

Use host bind mount para kernels, user-data, extensoes, logs e cache. Instancias multiplas precisam de diretorios diferentes.

Mapeamento seguro de portas

Mapeie 52100 para a Agent API e ligue 45000-45099 a 127.0.0.1 por padrao. Proteja 52100 se estiver publico.

Ciclo de vida em um comando

Use docker compose up -d para iniciar, docker compose pull para atualizar e docker compose logs -f dicloak-agent para logs.

¿Qué construyen los equipos con DICloak Agent Docker?

La imagen Agent está pensada para automatización de servidor que necesita identidad de navegador estable, sesiones persistentes y conectividad CDP.

Sessoes de navegador para AI Agent

Forneca a AI agents sessoes logadas persistentes que podem ser reabertas e controladas via CDP em workflows no servidor.

Servicos de automacao de navegador

Execute Playwright ou Puppeteer contra perfis DICloak em servidores mantendo fingerprint, storage e identidade isolados.

CI e tarefas agendadas

Use containers reproduziveis para tarefas de navegador agendadas, checagens de regressao ou fluxos com estado de perfil estavel.

Operacoes multi-conta

Opere ambientes de navegador separados para varias contas preservando user-data e reduzindo interferencia entre sessoes.

Verificacao de anuncios e conteudo

Abra perfis pelo Local API e inspecione paginas regionais, anuncios e experiencias autenticadas em sessoes controladas.

Monitoramento de e-commerce

Monitore precos regionais, estoque, promocoes e paginas especificas de conta com perfis persistentes e CDP controlado.

Integra con toolchains de automatización y Agent

DICloak Agent Docker funciona con frameworks compatibles con CDP después de que tu flujo Local API abre un perfil de navegador.

Playwright

Puppeteer

Selenium

OpenAI Agents

Claude MCP

Gemini

Docker Compose

Kubernetes

GitHub Actions

AWS ECS

Empieza con DICloak Agent Docker

Docker Hub: dicloakinc/dicloak-agent-image