Repository navigation
ru 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 | 中文
Спасибо за интерес. Это небольшой, чувствительный к безопасности проект (он раздаёт root), поэтому изменения проверяются с учётом этого.
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)
Бинарник собирается в CI из апстрима mkj/dropbear плюс патчи в
patches/. Для локальной сборки вам нужен Android NDK:
scripts/build.sh # fetches the tracked upstream, applies patches, builds arm64 + arm32Набор патчей намеренно минимален и поддаётся аудиту: нейтральная/настраиваемая строка идентификации,
задаваемые конфигурацией пути к authorized_keys и файлу паролей, исправление openpty для Android и
конфигурация времени выполнения. Пожалуйста, делайте новые патчи небольшими, документированными и
обоснованными в PR.
- Одно логическое изменение на PR; опишите мотивацию и влияние на безопасность.
- Придерживайтесь существующего стиля шелла (POSIX
sh/ Androidmksh; без башизмов). - В каждом файле есть короткий заголовок SPDX. Сохраняйте его.
- Обновляйте
CHANGELOG.mdв разделе[Unreleased]при любом реальном, видимом пользователю изменении. - Отправляя PR, вы соглашаетесь лицензировать свой вклад под лицензией проекта Apache-2.0.
README и документация поддерживаются на многих языках (README.<lang>.md). Английский является источником
истины; переводы следуют за ним. Если вы улучшаете перевод или добавляете язык, сохраняйте структуру и
якоря разделов идентичными английской версии.
Используйте шаблоны issue для ошибок и запросов функций. Для всего, что может скомпрометировать
устройство, следуйте SECURITY.md и сообщайте об этом в частном порядке, а не открывая
публичную issue.
Эта документация создана с помощью Claude (Anthropic) и поддерживается VD171. Исправления и улучшения приветствуются; см. CONTRIBUTING.md.