Skip to content

it 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 | 中文


Agenti AI sul tuo dispositivo

Un endpoint SSH sempre attivo trasforma il tuo telefono in qualcosa che un agente AI autonomo può operare direttamente. Qualsiasi agente in grado di pilotare una shell o una connessione SSH (Claude Code, aider, uno script LLM-in-the-loop, la tua automazione personale) ottiene una vera sessione root sul dispositivo, via rete, senza cavo USB e senza alcuno dei flag di debug di ADB che si espongono da soli.

Questa pagina approfondisce l'idea introdotta nel README.

Perché SSH, e non ADB, per gli agenti

ADB si annuncia da solo: adb_enabled e development_settings_enabled sono leggibili da chiunque, la connessione viene registrata e non esiste alcun modo supportato per nascondere che il debug è (o era) attivo. Un agente che lavora tramite ADB lascia quella traccia sul dispositivo, leggibile da qualsiasi app o SDK antifrode. VD Dropbear è l'alternativa privata: un normale accesso SSH, con credenziali che controlli tu e un banner che non rivela nulla.

Cosa può fare un agente

Su un'unica connessione, un agente vede una normale shell in stile Linux e può:

  • leggere e modificare file, cambiare impostazioni e gestire moduli, pacchetti e servizi;
  • analizzare i log, estrarre artefatti ed eseguire diagnostica o analisi forensi su richiesta;
  • spostare e sincronizzare file in entrambe le direzioni tramite scp / sftp / rsync: backup, migrazioni, provisioning;
  • pilotare un'intera flotta di dispositivi con root da un unico punto, ciascuno raggiungibile con la propria chiave.

Poiché il progetto è costruito per essere AI-friendly (un file di configurazione documentato, un esplicito env contract di runtime, percorsi prevedibili e stato in testo semplice), un agente può scoprire come usarlo senza tirare a indovinare.

Farlo in sicurezza

Questo è root, quindi trattalo come root:

  • assegna all'agente una credenziale propria, non quella personale, e indirizzalo a un account con privilegi inferiori (shell) se vuoi limitarne la portata;
  • limita i bind alle reti di cui ti fidi: loopback o una VPN anziché l'Internet aperto (vedi Configuration);
  • tieni disattivata l'autenticazione con password; una chiave è revocabile e non viene mai digitata;
  • puoi revocare una chiave o fermare il daemon in qualsiasi momento dalla WebUI;
  • ricorda che una connessione predefinita è una sessione root completa: concedi all'agente solo la portata di cui ha bisogno.

Una configurazione minima

  1. Genera una coppia di chiavi solo per l'agente.
  2. Aggiungi la sua chiave pubblica nella WebUI (Authorized keys).
  3. Fai il bind solo su loopback o sulla tua VPN, su una porta non predefinita.
  4. Punta la configurazione SSH dell'agente al dispositivo e lascialo lavorare.

Via USB, senza ADB: attiva il tethering USB e lega all'indirizzo USB per un collegamento solo via cavo, comodo per un agente su un laptop collegato. Vedi la guida utente.


Questa documentazione è stata generata con Claude (Anthropic) ed è gestita da VD171. Correzioni e miglioramenti sono benvenuti; vedi CONTRIBUTING.md.

Clone this wiki locally