Skip to content

fa ARCHITECTURE

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 یک ماژول KernelSU / APatch / Magisk است که دقیقاً یک دیمون SSH Dropbear را اجرا می‌کند و کاملاً با پیکربندی هدایت می‌شود. هیچ چیزِ سرور SSH برای یک دستگاه خاص در کد ثابت نشده است؛ هر چیز خاصی یا پیکربندی زمان اجرا است یا یک راز.

اجزا

  • module/common/vddropbear.sh، کتابخانهٔ هسته‌ای: بارگذاری پیکربندی (با مقادیر پیش‌فرض داخلی و ایمن)، یافتن انبار راز، تضمین وجود یک host key، ساختن بردار آرگومان‌های Dropbear و مدیریت یک نمونهٔ واحد از دیمون (start / stop / status / restart).
  • module/service.sh: نقطهٔ ورود در بوت. سیاست شروع BFU/AFU را رعایت می‌کند؛ در حالت AFU منتظر می‌ماند تا فضای ذخیره‌سازی رمزنگاری‌شده با اعتبارنامه باز شود، بدون اینکه بوت را متوقف کند.
  • module/action.sh، دکمهٔ Action مدیر: دیمون را (دوباره) راه‌اندازی می‌کند. هرگز stdin را نمی‌خواند و دیمون را به نشست خودش جدا می‌کند، بنابراین مدیر معلق نمی‌ماند.
  • module/common/vddb-webui.sh + module/webroot/index.html: بک‌اند و صفحهٔ WebUI.
  • patches/: وصله‌های کوچک و قابل‌ممیزی که در زمان ساخت روی Dropbear upstream اعمال می‌شوند.
  • scripts/build.sh، scripts/build-bundles.sh، .github/workflows/build.yml: ساخت.

چرخهٔ عمر دیمون (نمونهٔ واحد)

vddb_start پیکربندی را بارگذاری می‌کند، هر نمونهٔ در حال اجرا را متوقف می‌کند، وجود یک host key را تضمین می‌کند و سپس یک دیمون واحد را به‌راه می‌اندازد. باینری با نام vddropbear عرضه می‌شود، بنابراین نام فرایندش دقیقاً با pgrep -x مطابقت دارد (mksh اندروید exec -a ندارد). با setsid راه‌اندازی می‌شود تا از گروه فرایند فراخوان جدا شود: همین است که Action مدیر را از مسدودشدن باز می‌دارد.

انبار راز (CE در برابر DE، BFU در برابر AFU)

تنظیمات راز نیستند و روی فضای ذخیره‌سازی رمزنگاری‌شده با دستگاه (/data/adb/vddropbear) قرار دارند که در بوت خواندنی است. رازها (host key، authorized_keys، هش‌های رمز عبور) به‌طور پیش‌فرض روی فضای رمزنگاری‌شده با اعتبارنامه (/data/misc_ce/0/vddropbear) قرار دارند که فقط پس از احراز هویت کاربر باز می‌شود. روشن‌کردن START_IN_BFU رازها را به فضای ذخیره‌سازی رمزنگاری‌شده با دستگاه منتقل می‌کند تا دیمون بتواند پیش از نخستین بازگشایی اجرا شود، به بهای اینکه آن رازها زودتر خواندنی می‌شوند. ماژول در هر مرحله از بوت محاسبه می‌کند که از کدام انبار استفاده کند.

مجموعهٔ وصله‌ها

سرور SSH همان Dropbear upstream می‌ماند؛ تغییرات ما تنها چند وصلهٔ قابل‌بازبینی است (نگاه کنید به patches/README.md):

  • یک بنر هویت خنثی و قابل‌پیکربندی در زمان اجرا؛
  • authorized_keys که از مسیری تعیین‌شده با محیط خوانده می‌شود (تا کلیدها در انبار راز قرار گیرند)؛
  • احراز هویت با رمز عبور در برابر یک فایل هش PBKDF2 به‌جای crypt()/shadow سیستم که اندروید فاقد آن است (نگاه کنید به BUILDING.md).

WebUI

یک صفحهٔ ایستا در WebUI مدیر (KernelSU / APatch / WebUI-X). این صفحه module/common/vddb-webui.sh را از طریق پل ksu.exec هدایت می‌کند: وضعیت، start/stop/restart، خواندن/نوشتن پیکربندی و مدیریت کلیدها و حساب‌های رمز عبور. همهٔ داده‌ها به‌صورت کدگذاری‌شده با base64 از پل عبور می‌کنند، بنابراین شل هرگز آن‌ها را تفسیر نمی‌کند؛ هش‌های رمز عبور در مرورگر با WebCrypto محاسبه می‌شوند، پس رمز عبور به‌صورت متن روشن هرگز صفحه را ترک نمی‌کند.


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

Clone this wiki locally