DICloak Agent Docker-Image für serverseitige Browser-Automatisierung

Führen Sie DICloak Agent in Docker für Headless- und Server-Workflows aus. Stellen Sie die Agent API auf Port 52100 bereit, leiten Sie CDP-Ports 45000-45099 weiter, speichern Sie Laufzeitdaten unter /dicloak/data und verbinden Sie Playwright oder Puppeteer über die zurückgegebene webSocketDebuggerUrl.

4 Schritte zum Start eines DICloak Agent Containers

1

Agent-Image abrufen

Rufen Sie dicloakinc/dicloak-agent-image:latest von Docker Hub ab. Browser-Kernel werden bei Bedarf geladen, daher kann der erste Profilstart länger dauern.

2

Mit Docker Compose starten

Nutzen Sie Docker Compose mit TOKEN oder USER_EMAIL und USER_PASSWD, AGENT_PORT=52100, DOCKER=1 und einem persistenten /dicloak/data-Volume.

3

Agent API prüfen

Prüfen Sie http://127.0.0.1:52100/agent/status und /agent/user-info, um Bereitschaft, Login-Status, laufende Profile und Kernel-Downloads zu bestätigen.

4

Profil öffnen und verbinden

Öffnen Sie ein Browserprofil über Ihren DICloak Local API Workflow, lesen Sie debug_port, rufen Sie /json/version ab und verbinden Sie Playwright oder Puppeteer mit webSocketDebuggerUrl.

Warum DICloak Agent mit Docker bereitstellen?

Docker gibt serverseitiger Automatisierung einen reproduzierbaren Runtime, persistente Login-Sitzungen und klare Netzwerkgrenzen.

Klassische Probleme

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

Docker Agent Lösung

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

Kernfunktionen von Agent in Docker

Ein production-orientierter DICloak Agent Runtime für persistente eingeloggte Browser-Sitzungen, Profilisolierung und CDP-Automatisierung.

Agent API auf Port 52100

Der Container stellt die HTTP Agent API auf 52100 für Statusprüfungen, Account-Sitzung und Koordination mit Ihrem Local API Workflow bereit.

Weitergeleiteter CDP-Portbereich

Browser-Debugging-Ports werden über 45000-45099 weitergeleitet. Rufen Sie /json/version auf dem zurückgegebenen debug_port ab, bevor Sie verbinden.

Persistente Runtime-Daten

Mounten Sie /dicloak/data, um Browser-Kernel, Profil-user-data, Erweiterungen, Logs und Cache über Neustarts hinweg zu behalten.

Sichere Account-Bereitstellung

Nutzen Sie einen dedizierten Member-Account mit Local API- oder Docker-Berechtigung. Veröffentlichen Sie 52100 nicht ohne Firewall, VPN oder Reverse Proxy.

Bis zu 100 Browser-Sitzungen

Der gemappte CDP-Bereich unterstützt bis zu 100 gleichzeitige Browser-Instanzen, jede mit eigenem debug_port.

Docker Compose Lifecycle

Nutzen Sie das Compose-Template für Image-Updates, Restart Policy, Ressourcenlimits, Shared Memory, Host Proxy und stabile Einstellungen.

Empfohlene Bereitstellung mit Docker Compose

Das aktuelle Agent-Image erwartet Compose-verwaltete Login-Variablen, Agent API Port 52100, CDP Forwarding und persistentes /dicloak/data Storage.

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.

Was bauen Teams mit DICloak Agent Docker?

Das Agent-Image ist für serverseitige Automatisierung mit stabiler Browser-Identität, persistenten Sitzungen und CDP-Konnektivität gedacht.

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.

Integration mit Automatisierungs- und Agent-Toolchains

DICloak Agent Docker arbeitet mit CDP-kompatiblen Frameworks, nachdem Ihr Local API Workflow ein Browserprofil geöffnet hat.

Playwright
Puppeteer
Selenium
OpenAI Agents
Claude MCP
Gemini
Docker Compose
Kubernetes
GitHub Actions
AWS ECS
Mit DICloak Agent Docker starten

Docker Hub: dicloakinc/dicloak-agent-image