Skip to content

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


Współtworzenie VD Dropbear

Dziękujemy za zainteresowanie. To mały projekt wrażliwy na kwestie bezpieczeństwa (rozdaje roota), więc zmiany są przeglądane z tym na uwadze.

Układ repozytorium

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)

Budowanie

Plik binarny jest tworzony przez CI z oryginalnego mkj/dropbear plus łatki w patches/. Do lokalnego budowania potrzebujesz Android NDK:

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

Zestaw łatek jest celowo minimalny i audytowalny: neutralny/konfigurowalny ciąg tożsamości, oparte na konfiguracji ścieżki do authorized_keys i pliku hasła, poprawka openpty dla Androida oraz konfiguracja uruchomieniowa. Prosimy, aby nowe łatki były małe, udokumentowane i uzasadnione w PR.

Pull requesty

  • Jedna logiczna zmiana na PR; opisz motywację i wpływ na bezpieczeństwo.
  • Trzymaj się istniejącego stylu powłoki (POSIX sh / Android mksh; bez bashizmów).
  • Każdy plik ma krótki nagłówek SPDX. Zachowaj go.
  • Zaktualizuj CHANGELOG.md w sekcji [Unreleased] przy każdej realnej, widocznej dla użytkownika zmianie.
  • Przesyłając PR, zgadzasz się na licencjonowanie swojego wkładu na licencji projektu Apache-2.0.

Tłumaczenia

README i dokumentacja są utrzymywane w wielu językach (README.<lang>.md). Angielski jest źródłem prawdy; tłumaczenia za nim podążają. Jeśli poprawiasz tłumaczenie lub dodajesz język, zachowaj strukturę i kotwice sekcji identyczne jak w wersji angielskiej.

Zgłaszanie błędów i problemów bezpieczeństwa

Do zgłaszania błędów i propozycji funkcji używaj szablonów zgłoszeń. W przypadku czegokolwiek, co mogłoby narazić urządzenie, postępuj zgodnie z SECURITY.md i zgłoś to prywatnie, zamiast otwierać publiczne zgłoszenie.


Ta dokumentacja została wygenerowana za pomocą Claude (Anthropic) i jest utrzymywana przez VD171. Poprawki i ulepszenia są mile widziane; zobacz CONTRIBUTING.md.

Clone this wiki locally