Repository navigation
vi 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 là một mô-đun KernelSU / APatch / Magisk chạy đúng một daemon SSH Dropbear, được điều khiển hoàn toàn bằng cấu hình. Không có gì về máy chủ SSH được mã hóa cứng cho một thiết bị duy nhất; mọi thứ riêng biệt đều là cấu hình thời gian chạy hoặc một secret.
-
module/common/vddropbear.sh: thư viện lõi: tải cấu hình (với các giá trị mặc định tích hợp an toàn), xác định kho secret, bảo đảm có host key, dựng vector đối số của Dropbear, và quản lý một thực thể daemon duy nhất (start / stop / status / restart). -
module/service.sh: điểm vào khi khởi động. Tuân theo chính sách khởi động BFU/AFU; ở chế độ AFU nó chờ kho credential-encrypted được mở khóa mà không làm nghẽn quá trình khởi động. -
module/action.sh: nút Action của trình quản lý: (tái) khởi chạy daemon. Nó không bao giờ đọc stdin và tách daemon ra phiên riêng của nó, nên trình quản lý không bị treo. -
module/common/vddb-webui.sh+module/webroot/index.html: backend và trang của WebUI. -
patches/: các bản vá nhỏ, có thể kiểm tra, được áp dụng lên Dropbear upstream khi build. -
scripts/build.sh,scripts/build-bundles.sh,.github/workflows/build.yml: quá trình build.
vddb_start tải cấu hình, dừng mọi thực thể đang chạy, bảo đảm host key tồn tại, rồi sinh ra một
daemon. Tệp nhị phân được phát hành dưới tên vddropbear, nên tên tiến trình của nó khớp chính xác với
pgrep -x (Android mksh không có exec -a). Nó được khởi chạy bằng setsid để tách khỏi nhóm tiến
trình của bên gọi: đó là điều giữ cho nút Action của trình quản lý không bị chặn.
Các thiết lập không phải là secret và nằm trên kho device-encrypted (/data/adb/vddropbear), đọc được
khi khởi động. Các secret (host key, authorized_keys, các hash mật khẩu) mặc định nằm trên kho
credential-encrypted (/data/misc_ce/0/vddropbear), chỉ mở khóa sau khi người dùng xác thực. Bật
START_IN_BFU chuyển các secret sang kho device-encrypted để daemon có thể chạy trước lần mở khóa đầu
tiên, với cái giá là các secret đó đọc được sớm hơn. Mô-đun tính toán kho nào sẽ dùng ở mỗi giai đoạn
khởi động.
Máy chủ SSH vẫn là Dropbear upstream; các thay đổi của chúng tôi là vài bản vá có thể xem xét (xem patches/README.md):
- một banner nhận dạng trung tính, cấu hình được ở thời gian chạy;
-
authorized_keysđược đọc từ một đường dẫn đặt qua biến môi trường (nên khóa nằm trong kho secret); - xác thực mật khẩu dựa trên một tệp hash PBKDF2 thay vì
crypt()/shadow của hệ thống, thứ mà Android không có (xem BUILDING.md).
Một trang tĩnh trong WebUI của trình quản lý (KernelSU / APatch / WebUI-X). Nó điều khiển
module/common/vddb-webui.sh qua cầu nối ksu.exec: trạng thái, start/stop/restart, đọc/ghi cấu hình,
và quản lý khóa cùng các tài khoản mật khẩu. Mọi dữ liệu đi qua cầu nối đều được mã hóa base64, nên
shell không bao giờ diễn giải nó; các hash mật khẩu được tính trong trình duyệt bằng WebCrypto, nên mật
khẩu dạng văn bản rõ không bao giờ rời khỏi trang.
Tài liệu này được tạo bằng Claude (Anthropic) và được duy trì bởi VD171. Chúng tôi hoan nghênh các chỉnh sửa và cải tiến; xem CONTRIBUTING.md.