Skip to content

id ARCHITECTURE

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


Arsitektur

VD Dropbear adalah modul KernelSU / APatch / Magisk yang menjalankan tepat satu daemon SSH Dropbear, yang sepenuhnya dikendalikan oleh konfigurasi. Tidak ada bagian dari server SSH yang di-hardcode untuk satu perangkat; semua yang spesifik berupa konfigurasi runtime atau sebuah secret.

Bagian-bagian

  • module/common/vddropbear.sh, pustaka inti: memuat konfigurasi (dengan default bawaan yang aman), menentukan secret store, memastikan ada host key, menyusun vektor argumen Dropbear, dan mengelola satu instance daemon tunggal (start / stop / status / restart).
  • module/service.sh: titik masuk boot. Mematuhi kebijakan start BFU/AFU; dalam mode AFU ia menunggu penyimpanan credential-encrypted terbuka tanpa menahan proses boot.
  • module/action.sh, tombol Action pada manajer: (men)jalankan ulang daemon. Ia tidak pernah membaca stdin dan melepaskan daemon ke sesinya sendiri, sehingga manajer tidak menggantung.
  • module/common/vddb-webui.sh + module/webroot/index.html: backend dan halaman WebUI.
  • patches/: patch kecil yang dapat diaudit, diterapkan ke Dropbear upstream saat build.
  • scripts/build.sh, scripts/build-bundles.sh, .github/workflows/build.yml: proses build.

Siklus hidup daemon (instance tunggal)

vddb_start memuat konfigurasi, menghentikan instance yang sedang berjalan, memastikan ada host key, lalu menelurkan satu daemon. Binary dikirim sebagai vddropbear, sehingga nama prosesnya cocok persis dengan pgrep -x (mksh Android tidak punya exec -a). Ia dijalankan dengan setsid agar terlepas dari grup proses pemanggil: itulah yang membuat tombol Action manajer tidak terblokir.

Secret store (CE vs DE, BFU vs AFU)

Pengaturan bukanlah secret dan berada di penyimpanan device-encrypted (/data/adb/vddropbear), yang dapat dibaca saat boot. Secret (host key, authorized_keys, hash kata sandi) secara default berada di penyimpanan credential-encrypted (/data/misc_ce/0/vddropbear), yang baru terbuka setelah pengguna terautentikasi. Mengaktifkan START_IN_BFU memindahkan secret ke penyimpanan device-encrypted agar daemon dapat berjalan sebelum first unlock, dengan konsekuensi secret tersebut dapat dibaca lebih awal. Modul menghitung store mana yang dipakai di setiap tahap boot.

Kumpulan patch

Server SSH tetap Dropbear upstream; perubahan kami hanya beberapa patch yang dapat ditinjau (lihat patches/README.md):

  • banner identitas yang netral dan dapat dikonfigurasi saat runtime;
  • authorized_keys dibaca dari jalur yang diatur lewat environment (agar kunci berada di secret store);
  • autentikasi kata sandi terhadap berkas hash PBKDF2, bukan crypt()/shadow sistem yang tidak ada di Android (lihat BUILDING.md).

WebUI

Sebuah halaman statis di WebUI manajer (KernelSU / APatch / WebUI-X). Ia menggerakkan module/common/vddb-webui.sh melalui jembatan ksu.exec: status, start/stop/restart, baca/tulis konfigurasi, serta pengelolaan kunci dan akun kata sandi. Semua data menyeberangi jembatan dalam bentuk base64, sehingga shell tidak pernah menafsirkannya; hash kata sandi dihitung di browser dengan WebCrypto, sehingga kata sandi teks-jelas tidak pernah keluar dari halaman.


Dokumentasi ini dibuat dengan Claude (Anthropic) dan dikelola oleh VD171. Koreksi dan perbaikan dipersilakan; lihat CONTRIBUTING.md.

Clone this wiki locally