Repository navigation
uk 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 з upstream 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; без bashisms). - Кожен файл містить короткий SPDX-заголовок. Зберігайте його.
- Оновлюйте
CHANGELOG.mdу розділі[Unreleased]для будь-якої реальної зміни, видимої користувачу. - Надсилаючи PR, ви погоджуєтеся ліцензувати свій внесок за ліцензією проєкту Apache-2.0.
README та документація підтримуються багатьма мовами (README.<lang>.md). Англійська є джерелом істини;
переклади слідують за нею. Якщо ви покращуєте переклад або додаєте мову, зберігайте структуру та якорі
розділів ідентичними англійській версії.
Використовуйте шаблони issue для помилок і запитів на функції. Для всього, що може скомпрометувати
пристрій, дотримуйтеся SECURITY.md і повідомляйте приватно замість відкриття публічної
issue.
Ця документація створена за допомогою Claude (Anthropic) і підтримується VD171. Виправлення та покращення вітаються; див. CONTRIBUTING.md.