KernelSU Documentation

A Kernel based root solution for Android

17,720 stars Kotlin Kotlin 1 file · ~5,618 tokens #android#kernel#kernelsu#root#su
RAW Doc

File: docs/README.md

English | Español | 简体中文 | 繁體中文 | 日本語 | 한국어 | Polski | Português (Brasil) | Türkçe | Русский | Tiếng Việt | Indonesia | עברית | हिंदी | Italiano

KernelSU

A kernel-based root solution for Android devices.





Features

  1. Kernel-based su and root access management.
  2. Module system based on metamodules: Pluggable infrastructure for systemless modifications.
  3. App Profile: Lock up the root power in a cage.

Compatibility state

KernelSU officially supports Android GKI 2.0 devices (kernel 5.10+). Older kernels (4.14+) are also supported, but the kernel will need to be built manually.

With this, WSA, ChromeOS, and container-based Android are all supported.

Currently, the arm64-v8a and x86_64 architectures are supported.

[!CAUTION]
Recent kernel versions have implemented a breaking change causing KernelSU to fail and potentially trigger a kernel panic on x86_64! Check the website for more info!

Usage

Translation

To help translate KernelSU, we no longer accept translation contributions via Weblate. All translations are now handled using LLMs.

If you would like to add support for a new language, feel free to open a PR. Please note that modifications to existing English and Chinese translations are not accepted.

Discussion

Security

For information on reporting security vulnerabilities in KernelSU, see SECURITY.md.

License

Credits

File: docs/README_CN.md

English | Español | 简体中文 | 繁體中文 | 日本語 | 한국어 | Polski | Português (Brasil) | Türkçe | Русский | Tiếng Việt | Indonesia | עברית | हिंदी | Italiano

KernelSU

一个 Android 上基于内核的 root 方案。





特性

  • 基于内核的 su 和权限管理。
  • 基于 metamodules 的模块系统：可插拔的模块架构。
  • App Profile: 把 Root 权限关进笼子里。

兼容状态

KernelSU 官方支持 GKI 2.0 的设备（内核版本5.10以上）；旧内核也是兼容的（最低4.14+），不过需要自己编译内核。

WSA, ChromeOS 和运行在容器上的 Android 也可以与 KernelSU 一起工作。

目前支持 arm64-v8a 和 x86_64 架构。

[!CAUTION]
最近的内核版本引入了一项破坏性更改，导致 KernelSU 在 x86_64 上运行失败，甚至可能引发内核恐慌 (kernel panic)！请查看网站获取更多信息！

使用方法

参与翻译

要将 KernelSU 翻译成您的语言，或完善现有的翻译，请使用 Weblate。现已不再接受有关管理器翻译的PR，因为这会与Weblate冲突。

讨论

安全性

有关报告 KernelSU 安全漏洞的信息，请参阅 SECURITY.md。

许可证

鸣谢

File: docs/README_ES.md

English | Español | 简体中文 | 繁體中文 | 日本語 | 한국어 | Polski | Português (Brasil) | Türkçe | Русский | Tiếng Việt | Indonesia | עברית | हिंदी | Italiano

KernelSU

Una solución root basada en el kernel para dispositivos Android.





Características

  1. Binario su basado en el kernel y gestión de acceso root.
  2. Sistema de módulos basado en metamodules: Infraestructura conectable para modificaciones sin sistema.

Estado de compatibilidad

KernelSU soporta de forma oficial dispositivos Android con GKI 2.0 (a partir de la versión 5.10 del kernel). Los kernels antiguos (a partir de la versión 4.14) también son compatibles, pero necesitas compilarlos por tu cuenta.

Con esto, WSA, ChromeOS y Android basado en contenedores están todos compatibles.

Actualmente, se soportan las arquitecturas arm64-v8a y x86_64.

[!CAUTION]
¡Las versiones recientes del kernel han implementado un cambio que rompe la compatibilidad, causando que KernelSU falle y potencialmente provoque un kernel panic en x86_64! ¡Consulta el sitio web para más información!

Uso

Traducción

Para ayudar a traducir KernelSU o mejorar las traducciones existentes, utilice Weblate. Ya no se aceptan PR de la traducción de Manager porque entrará en conflicto con Weblate.

Discusión

Seguridad

Para obtener información sobre cómo informar vulnerabilidades de seguridad en KernelSU, consulte SECURITY.md.

Licencia

  • Los archivos bajo el directorio kernel están licenciados bajo GPL-2-only.
  • Todas las demás partes, a excepción del directorio kernel, están licenciados bajo GPL-3-or-later.

Créditos

File: docs/README_ID.md

English | Español | 简体中文 | 繁體中文 | 日本語 | 한국어 | Polski | Português (Brasil) | Türkçe | Русский | Tiếng Việt | Indonesia | עברית | हिंदी | Italiano

KernelSU

Solusi root berbasis Kernel untuk perangkat Android.





Fitur

  1. Manajemen akses root dan su berbasis kernel.
  2. Sistem modul berdasarkan metamodules: Infrastruktur pluggable untuk modifikasi systemless.
  3. Profil Aplikasi: Kunci daya root di dalam sangkar.

Status Kompatibilitas

KernelSU secara resmi mendukung perangkat Android GKI 2.0 (dengan kernel 5.10+), kernel lama (4.14+) juga kompatibel, tetapi Anda perlu membuat kernel sendiri.

WSA, ChromeOS, dan Android berbasis wadah juga dapat bekerja dengan KernelSU terintegrasi.

Saat ini, arsitektur arm64-v8a dan x86_64 didukung.

[!CAUTION]
Versi kernel terbaru telah menerapkan perubahan yang merusak yang menyebabkan KernelSU gagal dan berpotensi memicu kernel panic pada x86_64! Cek situs web untuk info lebih lanjut!

Penggunaan

Terjemahan

Untuk menerjemahkan KernelSU ke dalam bahasa Anda atau menyempurnakan terjemahan yang sudah ada, harap gunakan Weblat.

Diskusi

Lisensi

Kredit

File: docs/README_IN.md

English | Español | 简体中文 | 繁體中文 | 日本語 | 한국어 | Polski | Português (Brasil) | Türkçe | Русский | Tiếng Việt | Indonesia | עברית | हिंदी | Italiano

KernelSU

Android उपकरणों के लिए कर्नेल-आधारित रूट समाधान।





विशेषताएँ

  1. कर्नेल-आधारित su और रूट एक्सेस प्रबंधन।
  2. metamodules पर आधारित मॉड्यूल प्रणाली: Systemless संशोधनों के लिए प्लगेबल इंफ्रास्ट्रक्चर।
  3. App Profile: Root शक्ति को पिंजरे में बंद कर दो।

अनुकूलता अवस्था

KernelSU आधिकारिक तौर पर Android GKI 2.0 डिवाइस (कर्नेल 5.10+) का समर्थन करता है। पुराने कर्नेल (4.14+) भी संगत हैं, लेकिन कर्नेल को मैन्युअल रूप से बनाना होगा।

इसके साथ, WSA, ChromeOS और कंटेनर-आधारित Android सभी समर्थित हैं।

वर्तमान में, arm64-v8a और x86_64 आर्किटेक्चर समर्थित हैं।

[!CAUTION]
हाल ही के कर्नेल संस्करणों में एक ऐसा बदलाव लागू किया गया है जिससे KernelSU विफल हो सकता है और x86_64 पर कर्नेल पैनिक (kernel panic) ट्रिगर हो सकता है! अधिक जानकारी के लिए वेबसाइट देखें!

प्रयोग

अनुवाद करना

KernelSU का अनुवाद करने या मौजूदा अनुवादों को बेहतर बनाने में सहायता के लिए, कृपया इसका उपयोग करें Weblate.

बहस

लाइसेंस

  • Kernel निर्देशिका के अंतर्गत फ़ाइलें हैं GPL-2-only
  • Kernel निर्देशिका को छोड़कर अन्य सभी भाग हैं GPL-3.0-or-later

आभार सूची

File: docs/README_IT.md

English | Español | 简体中文 | 繁體中文 | 日本語 | 한국어 | Polski | Português (Brasil) | Türkçe | Русский | Tiếng Việt | Indonesia | עברית | हिंदी | Italiano

KernelSU

Una soluzione per il root basata sul kernel per i dispositivi Android.





Funzionalità

  1. su e accesso root basato sul kernel.
  2. Sistema di moduli basato su metamodules: Infrastruttura modulare per modifiche systemless.
  3. App profile: Limita i poteri dell'accesso root a permessi specifici.

Compatibilità

KernelSU supporta ufficialmente i dispositivi Android GKI 2.0 (kernel 5.10 o superiore). I kernel precedenti (kernel 4.14+) sono anche compatibili, ma il kernel deve essere compilato manualmente.

Questo implica che WSA, ChromeOS e tutti le varianti di Android basate su container e virtualizzazione sono supportate.

Attualmente sono supportate le architetture arm64-v8a e x86_64.

[!CAUTION]
Le versioni recenti del kernel hanno implementato una modifica che causa il fallimento di KernelSU e potenzialmente innesca un kernel panic su x86_64! Controlla il sito web per maggiori informazioni!

Utilizzo

Traduzioni

Per aiutare a tradurre KernelSU o migliorare le traduzioni esistenti, si è pregati di utilizzare
To help translate KernelSU or improve existing translations, please use Weblate. Le richieste di pull delle traduzioni del manager non saranno più accettate perché sarebbero in conflitto con Weblate.

Discussione

Securezza

Per informazioni riguardo la segnalazione di vulnerabilità di sicurezza per KernelSU, leggi SECURITY.md.

Licenza

  • I file nella cartella kernel sono forniti secondo la licenza GPL-2.0-only.
  • Tutte le altre parti, ad eccezione della certella kernel, seguono la licenza GPL-3.0-or-later.

Riconoscimenti e attribuzioni

File: docs/README_IW.md

English | Español | 简体中文 | 繁體中文 | 日本語 | 한국어 | Polski | Português (Brasil) | Türkçe | Русский | Tiếng Việt | Indonesia | עברית | हिंदी | Italiano

KernelSU

פתרון לניהול root מבוסס על Kernel עבור מכשירי Android.





תכונות

  1. ניהול root ו־su מבוססים על Kernel.
  2. מערכת מודולים מבוססת metamodules: תשתית מודולרית לשינויים systemless.
  3. פרופיל אפליקציה: נעילת גישת root בכלוב.

מצב תאימות

KernelSU תומך במכשירי Android GKI 2.0 (kernel 5.10+) באופן רשמי. לליבות ישנות (4.14+) יש גם תאימות, אך יידרש לבנות את הליבה באופן ידני.

באמצעות זה, תמיכה זמינה גם ל-WSA, ChromeOS ומכשירי Android המבוססים על מיכלים.

כיום, נתמכות הארכיטקטורות arm64-v8a ו-x86_64.

[!CAUTION]
גרסאות קרנל אחרונות יישמו שינוי שובר תאימות הגורם ל-KernelSU להיכשל ועלול לעורר kernel panic ב-x86_64! בדוק באתר למידע נוסף!

שימוש

תרגום

כדי לעזור בתרגום של KernelSU או לשפר תרגומים קיימים, יש להשתמש ב-Weblate.

דיון

רשיון

  • קבצים תחת הספרייה kernel מוגנים על פי GPL-2.0-only.
  • כל החלקים האחרים, למעט הספרייה kernel, מוגנים על פי GPL-3.0-or-later.

קרדיטים

File: docs/README_JP.md

English | Español | 简体中文 | 繁體中文 | 日本語 | 한국어 | Polski | Português (Brasil) | Türkçe | Русский | Tiếng Việt | Indonesia | עברית | हिंदी | Italiano

KernelSU

Android におけるカーネルベースの root ソリューションです。





特徴

  1. カーネルベースの su と権限管理。
  2. metamodules に基づくモジュールシステム: プラグイン可能なシステムレス変更インフラストラクチャ。
  3. アプリのプロファイル: root の権限をケージ内に閉じ込めます。

対応状況

KernelSU は GKI 2.0 デバイス（カーネルバージョン 5.10 以上）を公式にサポートしています。古いカーネル（4.14以上）とも互換性がありますが、自分でカーネルをビルドする必要があります。

WSA 、ChromeOS とコンテナ上で動作する Android でも KernelSU を統合して動かせます。

現在、arm64-v8a および x86_64 アーキテクチャがサポートされています。

[!CAUTION]
最近のカーネルバージョンでは、KernelSU が機能しなくなり、x86_64 上でカーネルパニックを引き起こす可能性のある破壊的な変更が実装されています！詳細についてはウェブサイトを確認してください！

使用方法

翻訳

KernelSU をあなたの言語に翻訳するか、既存の翻訳を改善するには、Weblate を使用してください。Manager翻訳した PR は、Weblate と競合するため受け入れられなくなりました。

ディスカッション

ライセンス

  • kernel ディレクトリの下にあるすべてのファイル： GPL-2-only。
  • kernel ディレクトリ以外のすべてのファイル： GPL-3.0-or-later。

クレジット

File: docs/README_KR.md

English | Español | 简体中文 | 繁體中文 | 日本語 | 한국어 | Polski | Português (Brasil) | Türkçe | Русский | Tiếng Việt | Indonesia | עברית | हिंदी | Italiano

KernelSU

안드로이드 기기에서 사용되는 커널 기반 루팅 솔루션입니다.





기능들

  1. 커널 기반 su 및 루트 액세스 관리.
  2. metamodules 기반 모듈 시스템: 플러그인 가능한 시스템리스 수정 인프라.
  3. App Profile: 루트 권한을 케이지에 가둡니다.

호환 상태

KernelSU는 공식적으로 안드로이드 GKI 2.0 디바이스(커널 5.10 이상)를 지원합니다. 오래된 커널(4.14 이상)도 사용할 수 있지만, 커널을 수동으로 빌드해야 합니다.

KernelSU는 WSA, ChromeOS, 컨테이너 기반 안드로이드 모두를 지원합니다.

현재 arm64-v8a 및 x86_64 아키텍처가 지원됩니다.

[!CAUTION]
최신 커널 버전에는 KernelSU가 실패하고 x86_64에서 커널 패닉을 일으킬 수 있는 치명적인 변경 사항이 적용되었습니다! 자세한 내용은 웹사이트를 확인하세요!

사용 방법

번역

KernelSU 번역을 돕거나 기존 번역을 개선하려면 Weblate를 이용해 주세요. 매니저의 번역은 Weblate와 충돌할 수 있으므로 더 이상 허용되지 않습니다.

토론

보안

KernelSU의 보안 취약점 보고에 대한 자세한 내용은 SECURITY.md를 참조하세요.

저작권

  • kernel 디렉터리 아래의 파일은 GPL-2.0 전용입니다.
  • kernel 디렉토리를 제외한 다른 모든 부분은 GPL-3.0-이상입니다.

크래딧

Explore Related Technologies & Topics

View All 9,111+ Repositories →

Discover similar high-velocity repositories, agent skills, and OpenAPI specifications across the ecosystem.

#android Browse android catalog → #kernel Browse kernel catalog → #kernelsu Browse kernelsu catalog → #root Browse root catalog → #su Browse su catalog → ⚡ MCP Servers Model Context Protocol → 🧠 Agent Skills Prompt & rule files → 🔌 OpenAPI Specs REST & Swagger schemas →