Repository navigation
ru 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 | 中文
Постоянно доступная точка SSH превращает ваш телефон в то, чем автономный ИИ-агент может управлять напрямую. Любой агент, способный работать с шеллом или SSH-соединением (Claude Code, aider, скрипт с LLM в цикле, ваша собственная автоматизация) получает настоящую root-сессию на устройстве по сети, без USB-кабеля и без каких-либо самораскрывающихся флагов отладки ADB.
Эта страница развивает идею, представленную в README.
ADB сам себя выдаёт: adb_enabled и development_settings_enabled доступны для чтения всем,
соединение логируется, и нет поддерживаемого способа скрыть, что отладка включена (или была включена).
Агент, работающий через ADB, оставляет на устройстве этот след, который может прочитать любое
приложение или антифрод-SDK. VD Dropbear является приватной альтернативой: обычный вход по SSH, с учётными
данными, которые контролируете вы, и баннером, не раскрывающим ничего.
В рамках одного соединения агент видит обычный Linux-подобный шелл и может:
- читать и редактировать файлы, менять настройки и управлять модулями, пакетами и службами;
- разбирать логи, выгружать артефакты и по запросу запускать диагностику или форензику;
- перемещать и синхронизировать файлы в обе стороны через
scp/sftp/rsync: резервные копии, миграции, провижининг; - управлять целым парком root-устройств из одного места, причём к каждому можно обратиться по собственному ключу.
Поскольку проект создан так, чтобы быть дружелюбным к ИИ (документированный файл конфигурации, явный контракт окружения времени выполнения, предсказуемые пути и статус в виде обычного текста) агент может сам разобраться, как им пользоваться, без догадок.
Это root, поэтому относитесь к нему как к root:
- выдайте агенту его собственные учётные данные, а не ваши личные, и направьте его на учётную запись с меньшими привилегиями (
shell), если хотите ограничить его охват; - ограничьте привязки сетями, которым вы доверяете: loopback или VPN вместо открытого Интернета (см. Конфигурация);
- держите аутентификацию по паролю выключенной; ключ можно отозвать, и его никогда не вводят;
- вы можете отозвать ключ или остановить демон в любой момент из WebUI;
- помните, что соединение по умолчанию представляет собой полноценную root-сессию: давайте агенту ровно тот доступ, который ему нужен.
- Сгенерируйте пару ключей специально для агента.
- Добавьте его публичный ключ в WebUI (Authorized keys).
- Выполните привязку только к loopback или вашему VPN, на нестандартном порту.
- Укажите в SSH-конфигурации агента адрес устройства и дайте ему работать.
По USB, без ADB: включите USB-модем и привяжите к USB-адресу для связи только по кабелю, удобно для агента на подключённом ноутбуке. См. руководство пользователя.
Эта документация создана с помощью Claude (Anthropic) и поддерживается VD171. Исправления и улучшения приветствуются; см. CONTRIBUTING.md.