Skip to content

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


Участие в VD Dropbear

Спасибо за интерес. Это небольшой, чувствительный к безопасности проект (он раздаёт 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.

Pull request'ы

  • Одно логическое изменение на PR; опишите мотивацию и влияние на безопасность.
  • Придерживайтесь существующего стиля шелла (POSIX sh / Android mksh; без башизмов).
  • В каждом файле есть короткий заголовок SPDX. Сохраняйте его.
  • Обновляйте CHANGELOG.md в разделе [Unreleased] при любом реальном, видимом пользователю изменении.
  • Отправляя PR, вы соглашаетесь лицензировать свой вклад под лицензией проекта Apache-2.0.

Переводы

README и документация поддерживаются на многих языках (README.<lang>.md). Английский является источником истины; переводы следуют за ним. Если вы улучшаете перевод или добавляете язык, сохраняйте структуру и якоря разделов идентичными английской версии.

Сообщения об ошибках и проблемах безопасности

Используйте шаблоны issue для ошибок и запросов функций. Для всего, что может скомпрометировать устройство, следуйте SECURITY.md и сообщайте об этом в частном порядке, а не открывая публичную issue.


Эта документация создана с помощью Claude (Anthropic) и поддерживается VD171. Исправления и улучшения приветствуются; см. CONTRIBUTING.md.

Clone this wiki locally