Repository navigation
ja USER GUIDE
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シェルになります。 パスワードより鍵を優先し、信頼できるネットワークにのみバインドし、理由なくポートをオープンなインターネットに露出させないでください。
KernelSU、APatch、または Magisk のマネージャでモジュールのzipをフラッシュし(あるいはシェルから ksud module install / apd module install で)、続いてモジュールの WebUI を開きます。
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パスワードログインは既定で無効です(ログインは既定でrootなので、鍵が推奨されます)。有効にするには、設定で Password login をオンにし、続いて Password accounts でログインユーザーのパスワードを設定します。ハッシュはブラウザ内でPBKDF2を使って計算され、パスワードそのものがページを離れることはありません。
Settings で Port を設定し、バインドを選びます。既定ではVD Dropbearは loopback のみでリッスンします;LANやVPNから到達するには、使いたいインターフェースを有効にします。露出を理解していない限り、Listen on all interfaces は避けてください。
適用するには Save & restart を押し、まだ動作していなければ Start を押します。
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 テザリングを使って USB ケーブル経由でデーモンに接続します。ADB も USB デバッグも不要です:
- ケーブルを挿し、電話側で USB テザリングをオンにします(設定 -> ネットワーク -> アクセスポイントとテザリング)。
- 電話は USB だけの小さなネットワークに入り、通常は
192.168.42.129になります。 - 上の手順 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 インターフェースを確認してください。
既定では、デーモンはデバイスを一度アンロックした あと(AFU)にのみ起動します。シークレットが認証情報暗号化ストレージに置かれているためです。最初のアンロック 前 にSSHが必要な場合(たとえば再起動後にデバイスをリモートでアンロックするため)には、Start before first unlock (BFU) をオンにします。するとシークレットはデバイス暗号化ストレージへ移り、アンロック前に読み取れるようになります:意図的で、文書化されたトレードオフです。READMEの Security model を参照してください。
- 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 を参照してください。