Skip to content

ja USER GUIDE

github-actions[bot] edited this page Nov 17, 2026 · 5 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 | 中文


ユーザーガイド

VD Dropbearは、root化したデバイスにプライベートなSSHサーバーを提供します。このガイドは、インストールから、ファイル転送や最初のアンロック前(BFU)モードを含む、動作する接続までを案内します。

ログインは既定で完全なrootシェルになります。 パスワードより鍵を優先し、信頼できるネットワークにのみバインドし、理由なくポートをオープンなインターネットに露出させないでください。

1. インストール

KernelSU、APatch、または Magisk のマネージャでモジュールのzipをフラッシュし(あるいはシェルから ksud module install / apd module install で)、続いてモジュールの WebUI を開きます。

2. 鍵を追加する(推奨)

WebUIの Authorized keys で、公開鍵(ssh-ed25519 AAAA... you@host)を貼り付け、Add key を押します。鍵が既定で、最も安全な入り口です。

まだ鍵を持っていない場合、コンピュータ上で鍵を生成するには:

ssh-keygen -t ed25519 -C "you@host"
cat ~/.ssh/id_ed25519.pub     # paste this into the WebUI

3. またはパスワードを設定する

パスワードログインは既定で無効です(ログインは既定でrootなので、鍵が推奨されます)。有効にするには、設定で Password login をオンにし、続いて Password accounts でログインユーザーのパスワードを設定します。ハッシュはブラウザ内でPBKDF2を使って計算され、パスワードそのものがページを離れることはありません。

4. ポートとリッスン先を選ぶ

Settings で Port を設定し、バインドを選びます。既定ではVD Dropbearは loopback のみでリッスンします;LANやVPNから到達するには、使いたいインターフェースを有効にします。露出を理解していない限り、Listen on all interfaces は避けてください。

適用するには Save & restart を押し、まだ動作していなければ Start を押します。

5. 接続する

ssh -p 2222 root@<device-ip>
sftp -P 2222 root@<device-ip>
scp -P 2222 file root@<device-ip>:/sdcard/
rsync -e 'ssh -p 2222' -av ./dir/ root@<device-ip>:/sdcard/dir/

sftp-server、scp、rsync が同梱されているため、SFTP、sshfs、GUIクライアント、バックアップがすべて同じ接続で動作します。

USB で接続する(wifi なし、ADB なし)

ネットワークを一切介さず、より速く安定した転送を行うには、USB テザリングを使って USB ケーブル経由でデーモンに接続します。ADB も USB デバッグも不要です:

  1. ケーブルを挿し、電話側で USB テザリングをオンにします(設定 -> ネットワーク -> アクセスポイントとテザリング)。
  2. 電話は USB だけの小さなネットワークに入り、通常は 192.168.42.129 になります。
  3. 上の手順 4 で、そのアドレスを個別のバインド(LISTEN_ADDRESSES)に追加し、すべてのインターフェースはオフのままにします。こうするとデーモンはケーブル経由だけで応答します。

その後、無線のアドレスではなく USB のアドレスに接続します:

ssh -p 2222 root@192.168.42.129
scp -P 2222 file root@192.168.42.129:/sdcard/

192.168.42.129 が自分の端末のアドレスでない場合は、ip addr で電話の USB インターフェースを確認してください。

6. 最初のアンロック前(BFU)

既定では、デーモンはデバイスを一度アンロックした あと(AFU)にのみ起動します。シークレットが認証情報暗号化ストレージに置かれているためです。最初のアンロック 前 にSSHが必要な場合(たとえば再起動後にデバイスをリモートでアンロックするため)には、Start before first unlock (BFU) をオンにします。するとシークレットはデバイス暗号化ストレージへ移り、アンロック前に読み取れるようになります:意図的で、文書化されたトレードオフです。READMEの Security model を参照してください。

7. デーモンの制御

  • WebUI: Start / Stop / Restart、そしてライブステータス(動作状況、PID、ポート、モード、ホスト鍵のフィンガープリント)。
  • マネージャのActionボタン: デーモンを(再)起動します。
  • 起動時にも自動的に開始します(無効にしていない限り)。

トラブルシューティング

  • 起動しない。 /data/adb/vddropbear/state/daemon.log を確認してください。Enabled がオンで、ホスト鍵が生成できたことを確かめてください。
  • 鍵が拒否される。 公開鍵の行がクライアントが提示するものと完全に一致していること、そしてログインに使うユーザー名がシステムの解決できるもの(通常は root)であることを確認してください。
  • 別のマシンから接続できない。 おそらくまだループバックのみにバインドされています。必要なインターフェースを有効にして再起動してください。
  • SFTP/scpは失敗するがシェルは動く。 同梱の sftp-server があなたのABI向けに配布されているか確認してください;WebUIのステータスに検出されたABIが表示されます。

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

Clone this wiki locally