Skip to content

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


Contribuer à VD Dropbear

Merci de votre intérêt. C'est un petit projet sensible à la sécurité (il distribue du root), donc les changements sont relus avec cela à l'esprit.

Organisation du dépôt

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)

Compilation

Le binaire est produit par la CI à partir de mkj/dropbear upstream plus les correctifs de patches/. Pour compiler en local, il vous faut le NDK Android :

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

Le jeu de correctifs est délibérément minimal et auditable : une chaîne d'identité neutre/configurable, des chemins pilotés par la configuration pour authorized_keys et le fichier de mots de passe, le correctif openpty d'Android, et la configuration à l'exécution. Merci de garder les nouveaux correctifs petits, documentés et justifiés dans la PR.

Pull requests

  • Un changement logique par PR ; décrivez la motivation et l'impact sur la sécurité.
  • Respectez le style de shell existant (POSIX sh / mksh d'Android ; pas de bashismes).
  • Chaque fichier porte un court en-tête SPDX. Conservez-le.
  • Mettez à jour CHANGELOG.md sous [Unreleased] pour tout changement réel et visible par l'utilisateur.
  • En soumettant une PR, vous acceptez de licencier votre contribution sous la licence Apache-2.0 du projet.

Traductions

Le README et la documentation sont maintenus dans de nombreuses langues (README.<lang>.md). L'anglais est la source de vérité ; les traductions le suivent. Si vous améliorez une traduction ou ajoutez une langue, gardez la structure et les ancres de section identiques à la version anglaise.

Signaler des bugs et des problèmes de sécurité

Utilisez les modèles de tickets pour les bugs et les demandes de fonctionnalités. Pour tout ce qui pourrait compromettre un appareil, suivez SECURITY.md et signalez-le en privé plutôt que d'ouvrir un ticket public.


Cette documentation a été générée avec Claude (Anthropic) et est maintenue par VD171. Les corrections et améliorations sont les bienvenues ; voir CONTRIBUTING.md.

Clone this wiki locally