Skip to content

pt AI AGENTS

github-actions[bot] edited this page Nov 17, 2026 · 6 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文


Agentes de IA no seu dispositivo

Um ponto de acesso SSH permanente transforma o seu celular em algo que um agente de IA autônomo pode operar diretamente. Qualquer agente capaz de conduzir um shell ou uma conexão SSH (Claude Code, aider, um script com LLM no laço, a sua própria automação) ganha uma sessão root real no dispositivo, pela rede, sem cabo USB e sem nenhuma das flags de depuração autodenunciadoras do ADB.

Esta página amplia a ideia apresentada no README.

Por que SSH, e não ADB, para agentes

O ADB se denuncia: adb_enabled e development_settings_enabled são legíveis por qualquer um, a conexão é registrada e não há maneira suportada de esconder que a depuração está (ou esteve) ativa. Um agente trabalhando por ADB deixa esse rastro no dispositivo para qualquer app ou SDK antifraude ler. O VD Dropbear é a alternativa privada: um login SSH comum, com credenciais que você controla e um banner que não revela nada.

O que um agente pode fazer

Por uma única conexão, um agente vê um shell comum no estilo Linux e pode:

  • ler e editar arquivos, alterar configurações e gerenciar módulos, pacotes e serviços;
  • triar logs, extrair artefatos e executar diagnósticos ou perícia sob demanda;
  • mover e sincronizar arquivos nos dois sentidos por scp / sftp / rsync: backups, migrações, provisionamento;
  • comandar uma frota inteira de dispositivos com root a partir de um só lugar, cada um acessível pela sua própria chave.

Como o projeto foi construído para ser amigável à IA (um arquivo de configuração documentado, um contrato de ambiente de execução explícito, caminhos previsíveis e status em texto puro) um agente consegue descobrir como usá-lo sem adivinhação.

Fazendo isso com segurança

Isto é root, então trate como root:

  • dê ao agente a sua própria credencial, não a sua pessoal, e aponte-o para uma conta de menor privilégio (shell) se quiser limitar o alcance dele;
  • restrinja os binds a redes em que você confia: loopback ou uma VPN em vez da Internet aberta (veja Configuração);
  • mantenha a autenticação por senha desativada; uma chave é revogável e nunca é digitada;
  • você pode revogar uma chave ou parar o daemon a qualquer momento pela WebUI;
  • lembre-se de que uma conexão padrão é uma sessão root completa. Dê ao agente apenas o alcance de que ele precisa.

Uma configuração mínima

  1. Gere um par de chaves apenas para o agente.
  2. Adicione a chave pública dele na WebUI (Authorized keys).
  3. Faça o bind apenas no loopback ou na sua VPN, em uma porta não padrão.
  4. Aponte a configuração SSH do agente para o dispositivo e deixe-o trabalhar.

Por USB, sem ADB: ative o tethering USB e faça o bind no endereço USB para um link só pelo cabo, útil para um agente num laptop conectado. Veja o guia do usuário.


Esta documentação foi gerada com o Claude (Anthropic) e é mantida por VD171. Correções e melhorias são bem-vindas; veja CONTRIBUTING.md.

Clone this wiki locally