Repository navigation
fr CONTRIBUTING
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
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.
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)
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 + arm32Le 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.
- Un changement logique par PR ; décrivez la motivation et l'impact sur la sécurité.
- Respectez le style de shell existant (POSIX
sh/mkshd'Android ; pas de bashismes). - Chaque fichier porte un court en-tête SPDX. Conservez-le.
- Mettez à jour
CHANGELOG.mdsous[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.
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.
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.