Repository navigation
id ARCHITECTURE
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 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.
-
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.
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.
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.
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_keysdibaca 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).
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.