Repository navigation
uk 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 перетворює ваш телефон на пристрій, яким автономний AI-агент може керувати безпосередньо. Будь-який агент, здатний працювати з оболонкою або з'єднанням 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-пристроїв з одного місця, причому кожен доступний за власним ключем.
Оскільки проєкт створено дружнім до AI (задокументований файл конфігурації, явний env-контракт середовища виконання, передбачувані шляхи та статус у вигляді звичайного тексту) агент може зрозуміти, як ним користуватися, без здогадок.
Це root, тож ставтеся до нього як до root:
- надайте агенту його власні облікові дані, а не свої особисті, і спрямуйте його на обліковий запис із меншими привілеями (
shell), якщо хочете обмежити його досяжність; - обмежте прив'язки мережами, яким ви довіряєте: loopback чи VPN, а не відкритий Інтернет (див. Конфігурацію);
- тримайте автентифікацію за паролем вимкненою; ключ можна відкликати, і його ніколи не вводять вручну;
- ви будь-коли можете відкликати ключ або зупинити демон із WebUI;
- пам'ятайте, що типове з'єднання є повноцінною root-сесією; надавайте агенту лише той доступ, який йому потрібен.
- Згенеруйте пару ключів спеціально для агента.
- Додайте його публічний ключ у WebUI (Authorized keys).
- Прив'яжіться лише до loopback або вашого VPN, на нестандартному порту.
- Спрямуйте SSH-конфігурацію агента на пристрій і дайте йому працювати.
Через USB, без ADB: увімкніть USB-прив'язку і прив'яжіть до USB-адреси для з'єднання лише через кабель, зручно для агента на під'єднаному ноутбуці. Див. посібник користувача.
Ця документація створена за допомогою Claude (Anthropic) і підтримується VD171. Виправлення та покращення вітаються; див. CONTRIBUTING.md.