Skip to content

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


デバイス上のAIエージェント

常駐するSSHエンドポイントは、あなたのスマートフォンを 自律型AIエージェントが直接操作できる 存在に変えます。シェルやSSH接続を扱えるエージェントであれば(Claude Code、aider、LLMを組み込んだスクリプト、あなた自身の自動化処理など)USBテザリングも、ADBのように自らを露出させるデバッグフラグも使わずに、ネットワーク経由でデバイス上の本物のrootセッションを手に入れられます。

このページはREADMEで紹介した考え方をさらに掘り下げます。

エージェントにADBではなくSSHを使う理由

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セッションであることを忘れずに、エージェントには必要な範囲だけを与える。

最小限のセットアップ

  1. エージェント専用の鍵ペアを生成する。
  2. WebUIでその公開鍵を追加する(Authorized keys)。
  3. 既定とは異なるポートで、ループバックまたはVPNのみにバインドする。
  4. エージェントのSSH設定をデバイスに向け、作業させる。

USB 経由、ADB なし: USB テザリングをオンにし、その USB アドレスにバインドするとケーブルだけの接続になります。ケーブル接続したノート PC 上のエージェントに便利です。ユーザーガイドを参照してください。


このドキュメントは Claude (Anthropic) で生成され、VD171 によって保守されています。修正や改善を歓迎します。CONTRIBUTING.md を参照してください。

Clone this wiki locally