Skip to content

fa 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 به دستگاه روت‌شدهٔ شما یک سرور SSH خصوصی می‌دهد. این راهنما شما را از نصب تا یک اتصال کارآمد می‌برد، از جمله انتقال فایل و حالت پیش از نخستین بازگشایی (BFU).

یک ورود به‌طور پیش‌فرض یک شل root کامل است. کلیدها را به رمزهای عبور ترجیح دهید، تنها به شبکه‌هایی که به آن‌ها اعتماد دارید باند کنید، و هرگز بدون دلیل پورت را در معرض اینترنت باز قرار ندهید.

۱. نصب

زیپ ماژول را در مدیر KernelSU، APatch یا Magisk فلش کنید (یا از یک شل با 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، کلاینت‌های گرافیکی و پشتیبان‌گیری‌ها همه روی همان اتصال کار می‌کنند.

اتصال از طریق USB (بدون wifi، بدون ADB)

برای انتقال سریع‌تر و پایدارتر و بدون هیچ شبکه‌ای در مسیر، با اشتراک اینترنت از طریق USB و کابل USB به دیمن وصل شوید، بدون ADB یا اشکال‌زدایی USB:

  1. کابل را وصل کنید و در گوشی اشتراک اینترنت USB را روشن کنید (تنظیمات -> شبکه -> نقطه اتصال و اشتراک‌گذاری).
  2. گوشی به یک شبکه کوچک فقط-USB می‌پیوندد، معمولاً روی 192.168.42.129.
  3. در گام ۴ بالا، این نشانی را به بایندهای مشخص (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 نشانی دستگاه شما نیست، واسط USB گوشی را با ip addr ببینید.

۶. پیش از نخستین بازگشایی (BFU)

به‌طور پیش‌فرض دیمون فقط پس از اینکه دستگاه را یک بار باز کنید (AFU) راه‌اندازی می‌شود، چون رازهایش روی فضای رمزنگاری‌شده با اعتبارنامه قرار دارند. اگر به SSH پیش از نخستین بازگشایی نیاز دارید (برای مثال برای بازگشایی یک دستگاه از راه دور پس از یک ری‌استارت)، Start before first unlock (BFU) را روشن کنید. رازها آنگاه به فضای رمزنگاری‌شده با دستگاه منتقل می‌شوند که پیش از بازگشایی خواندنی است: یک مصالحهٔ عمدی و مستند. به مدل امنیتی در README نگاه کنید.

۷. کنترل دیمون

  • WebUI: Start / Stop / Restart، و وضعیت زنده (در حال اجرا، PID، پورت، حالت، اثر انگشت host key).
  • دکمهٔ Action مدیر: دیمون را (دوباره) راه‌اندازی می‌کند.
  • همچنین به‌طور خودکار در بوت راه‌اندازی می‌شود (مگر اینکه آن را غیرفعال کنید).

عیب‌یابی

  • راه‌اندازی نمی‌شود. /data/adb/vddropbear/state/daemon.log را بررسی کنید. مطمئن شوید Enabled روشن است و یک host key توانسته تولید شود.
  • کلید رد شد. تأیید کنید که خط کلید عمومی دقیقاً همان است که کلاینت شما ارائه می‌دهد، و اینکه نام کاربری‌ای که با آن وارد می‌شوید حسابی است که سیستم آن را resolve می‌کند (معمولاً root).
  • نمی‌توانم از ماشینی دیگر متصل شوم. احتمالاً هنوز فقط به loopback باند هستید: رابطی را که نیاز دارید فعال کنید و ری‌استارت کنید.
  • SFTP/scp شکست می‌خورد اما شل کار می‌کند. مطمئن شوید sftp-server همراه، برای ABI شما عرضه شده است؛ وضعیت WebUI، ABI شناسایی‌شده را نشان می‌دهد.

این مستندات با Claude (Anthropic) تولید شده و توسط VD171 نگهداری می‌شود. اصلاحات و بهبودها خوش‌آمد است؛ به CONTRIBUTING.md مراجعه کنید.

Clone this wiki locally