Skip to content

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


Contribuire a VD Dropbear

Grazie per il tuo interesse. Questo è un piccolo progetto sensibile alla sicurezza (distribuisce root), quindi le modifiche vengono esaminate tenendo conto di questo.

Struttura del repository

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

Il binario è prodotto dalla CI a partire da upstream mkj/dropbear più le patch in patches/. Per compilare in locale ti serve l'Android NDK:

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

L'insieme di patch è volutamente minimo e verificabile: una stringa d'identità neutra/configurabile, percorsi guidati dalla configurazione per authorized_keys e per il file delle password, il fix openpty di Android e la configurazione a runtime. Mantieni le nuove patch piccole, documentate e giustificate nella PR.

Pull request

  • Una modifica logica per PR; descrivi la motivazione e l'impatto sulla sicurezza.
  • Rispetta lo stile shell esistente (POSIX sh / mksh di Android; niente bashism).
  • Ogni file reca un breve header SPDX. Mantienilo.
  • Aggiorna CHANGELOG.md sotto [Unreleased] per ogni modifica reale e visibile all'utente.
  • Inviando una PR accetti di licenziare il tuo contributo sotto la licenza Apache-2.0 del progetto.

Traduzioni

Il README e la documentazione sono mantenuti in molte lingue (README.<lang>.md). L'inglese è la fonte di verità; le traduzioni lo seguono. Se migliori una traduzione o aggiungi una lingua, mantieni la struttura e gli anchor delle sezioni identici alla versione inglese.

Segnalare bug e problemi di sicurezza

Usa i template delle issue per bug e richieste di funzionalità. Per qualsiasi cosa possa compromettere un dispositivo, segui SECURITY.md e segnala in privato anziché aprire una issue pubblica.


Questa documentazione è stata generata con Claude (Anthropic) ed è gestita da VD171. Correzioni e miglioramenti sono benvenuti; vedi CONTRIBUTING.md.

Clone this wiki locally