Repository navigation
nl AI AGENTS
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
Een permanent draaiend SSH-eindpunt maakt van je telefoon iets wat een autonome AI-agent rechtstreeks kan bedienen. Elke agent die een shell of een SSH-verbinding kan aansturen (Claude Code, aider, een script met een LLM in de lus, je eigen automatisering) krijgt een echte root-sessie op het toestel, via het netwerk, zonder USB-kabel en zonder de zelfonthullende debugvlaggen van ADB.
Deze pagina werkt het idee uit dat in de README is geïntroduceerd.
ADB kondigt zichzelf aan: adb_enabled en development_settings_enabled zijn door iedereen leesbaar, de verbinding wordt gelogd, en er is geen ondersteunde manier om te verbergen dat debuggen aan staat (of aan heeft gestaan). Een agent die over ADB werkt, laat dat spoor op het toestel achter voor elke app of antifraude-SDK om te lezen. VD Dropbear is het private alternatief: een gewone SSH-login, met inloggegevens die jij beheert en een banner die niets prijsgeeft.
Over één verbinding ziet een agent een normale Linux-achtige shell en kan die:
- bestanden lezen en bewerken, instellingen omzetten, en modules, pakketten en services beheren;
- logs uitpluizen, artefacten ophalen, en op aanvraag diagnoses of forensisch onderzoek uitvoeren;
- bestanden beide kanten op verplaatsen en synchroniseren via
scp/sftp/rsync: back-ups, migraties, provisioning; - een hele vloot van geroote toestellen vanaf één plek aansturen, elk bereikbaar met een eigen sleutel.
Omdat het project AI-vriendelijk is gebouwd (een gedocumenteerd configuratiebestand, een expliciet runtime env contract, voorspelbare paden en status in platte tekst) kan een agent zonder giswerk ontdekken hoe die het moet gebruiken.
Dit is root, dus behandel het als root:
- geef de agent zijn eigen credential, niet die van jou, en wijs het naar een account met minder rechten (
shell) als je het bereik wilt beperken; - beperk de binds tot netwerken die je vertrouwt: loopback of een VPN in plaats van het open internet (zie Configuration);
- houd wachtwoordauthenticatie uit; een sleutel is intrekbaar en wordt nooit ingetypt;
- je kunt op elk moment een sleutel intrekken of de daemon stoppen vanuit de WebUI;
- onthoud dat een standaardverbinding een volledige root-sessie is. Geef de agent alleen de reikwijdte die die nodig heeft.
- Genereer een sleutelpaar speciaal voor de agent.
- Voeg de publieke sleutel ervan toe in de WebUI (Authorized keys).
- Bind alleen aan loopback of je VPN, op een niet-standaardpoort.
- Richt de SSH-config van de agent op het toestel en laat die aan het werk gaan.
Via USB, zonder ADB: zet USB-tethering aan en bind aan het USB-adres voor een verbinding alleen via de kabel, handig voor een agent op een gekoppelde laptop. Zie de gebruikershandleiding.
Deze documentatie is gegenereerd met Claude (Anthropic) en wordt onderhouden door VD171. Correcties en verbeteringen zijn welkom; zie CONTRIBUTING.md.