Image Docker DICloak Agent pour l’automatisation de navigateur côté serveur

Exécutez DICloak Agent dans Docker pour les workflows headless et côté serveur. Exposez l’Agent API sur le port 52100, redirigez les ports CDP 45000-45099, persistez les données dans /dicloak/data et connectez Playwright ou Puppeteer via le webSocketDebuggerUrl retourné.

Essayer

4 étapes pour lancer un conteneur DICloak Agent

Télécharger l’image Agent

Téléchargez dicloakinc/dicloak-agent-image:latest depuis Docker Hub. Les noyaux de navigateur sont téléchargés à la demande, donc le premier démarrage d’un profil peut être plus long.

Démarrer avec Docker Compose

Utilisez Docker Compose avec TOKEN ou USER_EMAIL et USER_PASSWD, AGENT_PORT=52100, DOCKER=1 et un volume persistant /dicloak/data.

Vérifier l’Agent API

Consultez http://127.0.0.1:52100/agent/status et /agent/user-info pour confirmer l’état prêt, la connexion, le nombre de profils actifs et les téléchargements de noyaux.

Ouvrir un profil et connecter

Ouvrez un profil via votre workflow DICloak Local API, lisez debug_port, demandez /json/version et connectez Playwright ou Puppeteer avec webSocketDebuggerUrl.

Pourquoi déployer DICloak Agent avec Docker ?

Docker apporte à l’automatisation côté serveur un runtime reproductible, des sessions connectées persistantes et des limites réseau claires.

Problèmes classiques

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.

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

Capacités clés de l’Agent dans Docker

Runtime DICloak Agent orienté production pour sessions de navigateur connectées persistantes, isolation de profils et automatisation CDP.

Agent API sur le port 52100

Le conteneur expose la HTTP Agent API sur 52100 pour les contrôles d’état, l’inspection de session de compte et votre workflow Local API.

Plage de ports CDP redirigés

Les ports de débogage du navigateur sont redirigés via 45000-45099. Interrogez /json/version sur le debug_port retourné avant de connecter le framework.

Données runtime persistantes

Montez /dicloak/data pour conserver kernels téléchargés, répertoires user-data de profils, extensions, logs et cache entre redémarrages.

Déploiement de compte sécurisé

Utilisez un compte membre dédié avec permission Local API ou Docker. N’exposez pas 52100 publiquement sans firewall, VPN ou reverse proxy.

Jusqu’à 100 sessions navigateur

La plage CDP mappée prend en charge jusqu’à 100 instances de navigateur simultanées, chacune avec son propre debug_port.

Cycle de vie Docker Compose

Utilisez le template Compose pour mises à jour d’image, politique de restart, limites de ressources, shared memory, proxy hôte et réglages stables.

Déploiement recommandé avec Docker Compose

L’image Agent actuelle attend des variables de connexion gérées par Compose, le port Agent API 52100, le CDP forwarding et le stockage persistant /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.

Que construisent les équipes avec DICloak Agent Docker ?

L’image Agent vise l’automatisation côté serveur qui exige une identité navigateur stable, des sessions persistantes et une connectivité 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.

Intégration avec les toolchains d’automatisation et Agent

DICloak Agent Docker fonctionne avec les frameworks compatibles CDP une fois qu’un profil est ouvert par votre workflow Local API.

Playwright

Puppeteer

Selenium

OpenAI Agents

Claude MCP

Gemini

Docker Compose

Kubernetes

GitHub Actions

AWS ECS

Commencer avec DICloak Agent Docker

Docker Hub: dicloakinc/dicloak-agent-image