Repository navigation
ja 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を組み込んだスクリプト、あなた自身の自動化処理など)USBテザリングも、ADBのように自らを露出させるデバッグフラグも使わずに、ネットワーク経由でデバイス上の本物のrootセッションを手に入れられます。
このページはREADMEで紹介した考え方をさらに掘り下げます。
ADBは自らの存在を公言します。adb_enabled と development_settings_enabled は誰からでも読み取れ、接続はログに残り、デバッグが有効である(または有効だった)ことを隠す正式な手段はありません。ADB経由で作業するエージェントは、どんなアプリや不正検知SDKにも読み取られるその痕跡をデバイスに残します。VD Dropbearはそのプライベートな代替手段です:普通のSSHログインで、認証情報はあなたが管理し、バナーは何も明かしません。
ひとつの接続を通じて、エージェントは普通のLinuxライクなシェルを見て、次のことができます:
- ファイルの読み書きや編集、設定の切り替え、モジュール・パッケージ・サービスの管理;
- ログの切り分け、成果物の取得、必要に応じた診断やフォレンジックの実行;
-
scp/sftp/rsyncによる双方向のファイル移動・同期:バックアップ、移行、プロビジョニング; - それぞれが専用の鍵で到達できる、root化デバイスの群れ全体を一箇所から操作。
このプロジェクトは AIフレンドリー に作られているため(文書化された設定ファイル、明示的なランタイムの env contract、予測可能なパス、プレーンテキストのステータス)、エージェントは当て推量なしに使い方を把握できます。
これはrootなので、rootとして扱ってください:
- エージェントには、あなた個人のものではなく 専用の認証情報 を与え、到達範囲を制限したい場合は権限の低いアカウント(
shell)に向ける; - バインドは信頼できるネットワークに限定する:オープンなインターネットではなく、ループバックやVPN(Configuration を参照);
- パスワード認証は無効のままにする;鍵は失効させられ、入力されることもない;
- WebUIからいつでも鍵を失効させたり、デーモンを停止したりできる;
- 既定の接続は完全なrootセッションであることを忘れずに、エージェントには必要な範囲だけを与える。
- エージェント専用の鍵ペアを生成する。
- WebUIでその公開鍵を追加する(Authorized keys)。
- 既定とは異なるポートで、ループバックまたはVPNのみにバインドする。
- エージェントのSSH設定をデバイスに向け、作業させる。
USB 経由、ADB なし: USB テザリングをオンにし、その USB アドレスにバインドするとケーブルだけの接続になります。ケーブル接続したノート PC 上のエージェントに便利です。ユーザーガイドを参照してください。
このドキュメントは Claude (Anthropic) で生成され、VD171 によって保守されています。修正や改善を歓迎します。CONTRIBUTING.md を参照してください。