Imagem Docker do DICloak Agent para automacao de navegador no servidor

Execute o DICloak Agent no Docker para fluxos headless e no servidor. Exponha a Agent API na porta 52100, encaminhe as portas CDP 45000-45099, persista dados em /dicloak/data e conecte Playwright ou Puppeteer pelo webSocketDebuggerUrl retornado.

Experimentar Ver docs

4 etapas para iniciar um container DICloak Agent

Baixe a imagem Agent

Baixe dicloakinc/dicloak-agent-image:latest no Docker Hub. Os kernels do navegador sao baixados sob demanda, entao a primeira abertura de perfil pode demorar mais.

Inicie com Docker Compose

Use Docker Compose com TOKEN ou USER_EMAIL e USER_PASSWD, AGENT_PORT=52100, DOCKER=1 e um volume persistente /dicloak/data.

Verifique a Agent API

Acesse http://127.0.0.1:52100/agent/status e /agent/user-info para confirmar prontidao, login, quantidade de perfis em execucao e progresso dos kernels.

Abra um perfil e conecte

Abra um perfil pelo fluxo existente da DICloak Local API, leia debug_port, solicite /json/version e conecte Playwright ou Puppeteer com webSocketDebuggerUrl.

Por que implantar o DICloak Agent com Docker?

Docker oferece a automacao no servidor um runtime reproduzivel, sessoes logadas persistentes e limites de rede previsiveis.

Dores tradicionais

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.

Solucao 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.

Recursos centrais do Agent no Docker

Runtime DICloak Agent orientado a producao para sessoes de navegador logadas e persistentes, isolamento de perfis e automacao via CDP.

Agent API na porta 52100

O container expoe a HTTP Agent API em 52100 para verificacao de status, inspecao da sessao da conta e coordenacao com seu fluxo Local API.

Faixa de portas CDP encaminhadas

As portas de debug do navegador sao encaminhadas por 45000-45099. Consulte /json/version no debug_port retornado antes de conectar o framework.

Dados runtime persistentes

Monte /dicloak/data para manter kernels baixados, diretorios user-data dos perfis, extensoes, logs e cache entre reinicios.

Implantacao segura de conta

Use uma conta membro dedicada com permissao Local API ou Docker. Nao exponha 52100 publicamente sem firewall, VPN ou reverse proxy.

Ate 100 sessoes de navegador

A faixa CDP mapeada suporta ate 100 instancias simultaneas de navegador, cada uma com seu proprio debug_port.

Ciclo de vida com Docker Compose

Use o template Compose para atualizacoes da imagem, politica de restart, limites de recursos, shared memory, proxy do host e configuracoes estaveis.

Implantacao recomendada com Docker Compose

A imagem Agent atual espera variaveis de login gerenciadas pelo Compose, porta 52100 da Agent API, CDP forwarding e armazenamento /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.

O que equipes criam com DICloak Agent Docker?

A imagem Agent foi feita para automacao no servidor que precisa de identidade de navegador estavel, sessoes persistentes e 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.

Integre com toolchains de automacao e Agent

DICloak Agent Docker funciona com frameworks compativeis com CDP depois que seu fluxo Local API abre um perfil de navegador.

Playwright

Puppeteer

Selenium

OpenAI Agents

Claude MCP

Gemini

Docker Compose

Kubernetes

GitHub Actions

AWS ECS

Comece com DICloak Agent Docker

Docker Hub: dicloakinc/dicloak-agent-image