Skip to content

vi CONTRIBUTING

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 | 中文


Đóng góp cho VD Dropbear

Cảm ơn bạn đã quan tâm. Đây là một dự án nhỏ, nhạy cảm về bảo mật (nó trao quyền root), nên các thay đổi được xem xét với điều đó trong đầu.

Bố cục kho mã

module/     the installable KernelSU / APatch / Magisk module (scripts, WebUI, config, installer)
patches/    the patch set applied on top of upstream Dropbear (the only changes to the SSH server)
src/        where CI unpacks upstream Dropbear to build (not committed)
scripts/    build and maintenance helpers
.github/    CI workflows and issue/PR templates
docs/       documentation (mirrored to the wiki)

Build

Tệp nhị phân được CI tạo ra từ upstream mkj/dropbear cộng với các bản vá trong patches/. Để build cục bộ bạn cần Android NDK:

scripts/build.sh            # fetches the tracked upstream, applies patches, builds arm64 + arm32

Bộ bản vá được giữ tối thiểu và có thể kiểm tra một cách có chủ đích: một chuỗi nhận dạng trung tính/cấu hình được, các đường dẫn do cấu hình điều khiển cho authorized_keys và tệp mật khẩu, bản sửa openpty cho Android, và cấu hình thời gian chạy. Vui lòng giữ các bản vá mới nhỏ, có tài liệu, và được biện giải trong PR.

Pull request

  • Mỗi PR một thay đổi logic; mô tả động cơ và tác động bảo mật.
  • Khớp với phong cách shell hiện có (POSIX sh / Android mksh; không dùng bashisms).
  • Mỗi tệp mang một header SPDX ngắn. Hãy giữ nó.
  • Cập nhật CHANGELOG.md dưới mục [Unreleased] cho bất kỳ thay đổi thực sự, hữu hình với người dùng nào.
  • Khi gửi một PR, bạn đồng ý cấp phép đóng góp của mình theo giấy phép Apache-2.0 của dự án.

Bản dịch

README và tài liệu được duy trì bằng nhiều ngôn ngữ (README.<lang>.md). Tiếng Anh là nguồn chuẩn; các bản dịch bám theo nó. Nếu bạn cải thiện một bản dịch hoặc thêm một ngôn ngữ, hãy giữ cấu trúc và các neo mục giống hệt phiên bản tiếng Anh.

Báo cáo lỗi và vấn đề bảo mật

Dùng các mẫu issue cho lỗi và yêu cầu tính năng. Với bất cứ điều gì có thể làm tổn hại một thiết bị, hãy theo SECURITY.md và báo cáo riêng tư thay vì mở một issue công khai.


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.

Clone this wiki locally