安裝
檢查您的裝置是否受支援
從 GitHub Releases 下載 KernelSU 管理器應用程式,然後將應用程式安裝至裝置並開啟:
- 如果應用程式顯示「不支援」,則表示您的裝置不支援 KernelSU,您需要自行編譯核心才能繼續使用,,KernelSU 官方也永遠不會為您提供一個可以刷新的 Boot 映像。
- 如果應用程式顯示「未安裝」,那麼 KernelSU 支援您的裝置;可以進行下一步作業。
INFO
對於顯示「不支援」的裝置,這裡有一個非官方支援裝置清單,您可以使用這個清單裡的核心自行編譯。
備份您的原廠 boot.img
在進行刷新作業前,您必須預先備份您的原廠 boot.img。如果您在後續刷新作業中出現了任何問題,您都可以透過使用 Fastboot 刷新回到原廠 Boot 以還原系統。
WARNING
刷新作業可能會造成資料遺失,請確保做好這一步再繼續進行下一步作業!!必要時您還可以備份您手機的所有資料。
必要知識
ADB 和 Fastboot
預設狀況下,您將會使用 ADB 和 Fastboot 工具,如果您不知道它們,建議使用搜尋引擎先瞭解相關內容。
KMI
KMI 全稱 Kernel Module Interface,相同 KMI 的核心版本是相容的 這也是 GKI 中「標準」的涵義所在;反之,如果 KMI 不同,那麼這些核心之間無法彼此相容,刷新與您裝置 KMI 不同的核心映像可能會導致開機迴圈。
具體來講,對 GKI 的裝置,其核心版本格式應該如下:
KernelRelease :=
Version.PatchLevel.SubLevel-AndroidRelease-KmiGeneration-suffix
w .x .y -zzz -k -something
其中,w.x-zzz-k
為 KMI 版本。例如,一部裝置核心版本為 5.10.101-android12-9-g30979850fc20
,那麼它的 KMI 為 5.10-android12-9
;理論上刷新其他這個 KMI 的核心也能正常開機。
TIP
請注意,核心版本中的 SubLevel 並非 KMI 的一部分!也就是說 5.10.101-android12-9-g30979850fc20
與 5.10.137-android12-9-g30979850fc20
的 KMI 相同!
核心版本與 Android 版本
請注意:核心版本與 Android 版本並不一定相同!
如果您發現您的核心版本是 android12-5.10.101
,然而您 Android 系統的版本為 Android 13 或者其他;請不要覺得奇怪,因為 Android 系統的版本與 Linux 核心的版本號碼並非一致;Linux 核心的版本號碼一般與裝置出廠時隨附的 Android 系統的版本一致,如果後續 Android 系統更新,核心版本一般不會發生變化。如果您需要刷新,請以核心版本為準!!
安裝簡介
自 0.9.0
版本以後,在 GKI 裝置中,KernelSU 支援兩種運行模式:
GKI
:使用通用核心鏡像(GKI)取代掉裝置原有的核心。LKM
:使用可載入核心模組(LKM)的方式載入到裝置核心中,不會替換掉裝置原有的核心。
這兩種方式適用於不同的場景,你可以根據自己的需求選擇。
GKI 模式
GKI 模式會替換掉裝置原有的內核,使用 KernelSU 提供的通用內核鏡像。 GKI 模式的優點是:
- 通用型強,適用於大多數裝置;例如三星開啟了 KNOX 的裝置,LKM 模式無法運作。還有一些冷門的魔改裝置,也只能使用 GKI 模式;
- 不依賴官方韌體即可使用;不需要等待官方韌體更新,只要 KMI 一致,就可以使用;
LKM 模式
LKM 模式不會替換掉裝置原有的內核,而是使用可載入內核模組的方式載入到裝置內核中。 LKM 模式的優點是:
- 不會取代裝置原有的核心;如果你對裝置原有的核心有特殊需求,或是你希望在使用第三方核心的同時使用 KernelSU,可以使用 LKM 模式;
- 升級和 OTA 較為方便;升級 KernelSU 時,可以直接在管理器內部安裝,無需再手動刷寫;系統 OTA 後,可以直接安裝到第二個槽位,也無需再手動刷寫;
- 適用於一些特殊場景;例如使用臨時 ROOT 權限也可以載入 LKM,由於不需要替換 boot 分區,因此不會觸發 avb,不會使裝置意外變磚;
- LKM 可以被暫時卸載;如果你暫時想取消 root,可以卸載 LKM,這個過程不需要刷寫分區,甚至也不用重啟裝置;如果你想再次 root,只需要重啟裝置即可;
兩種模式共存
打開管理器後,你可以在首頁看到裝置目前運行的模式;注意 GKI 模式的優先級高於 LKM ,如你你既使用 GKI 內核替換掉了原有的內核,又使用 LKM 的方式修補了 GKI 內核,那麼 LKM 會被忽略,裝置將永遠以 GKI 的模式運作。
選哪個?
如果你的裝置是手機,我們建議您優先考慮 LKM 模式;如果你的裝置是模擬器、WSA 或 Waydroid 等,我們建議您優先考慮 GKI 模式。
LKM 安裝
取得官方韌體
使用 LKM 的模式,需要取得官方韌體,然後在官方韌體的基礎上修補;如果你使用的是第三方內核,可以把第三方內核的 boot.img 作為官方韌體。
取得官方韌體的方法有很多,如果你的裝置支援 fastboot boot
,那麼我們最推薦以及最簡單的方法是使用 fastboot boot
臨時啟動 KernelSU 提供的 GKI 內核,然後安裝管理器,最後在管理器中直接安裝;這種方法不需要你手動下載官方韌體,也不需要你手動提取 boot。
如果你的裝置不支援 fastboot boot
,那麼你可能需要手動去下載官方韌體包,然後從中提取 boot。
與 GKI 模式不同,LKM 模式會修改 ramdisk
,因此在出廠 Android 13 的裝置上,它需要修補的是 init_boot
分區而非 boot
分區;而 GKI 模式則永遠是操作 boot
分區。
使用管理器
開啟管理器,點選右上角的安裝圖標,會出現若干個選項:
- 選擇並修補一個文件:如果你手機目前沒有 root 權限,你可以選擇這個選項,然後選擇你的官方韌體,管理器會自動修補它;你只需要刷入這個修補後的文件,即可永久取得 root 權限;
- 直接安裝:如果你手機已經 root,你可以選擇這個選項,管理器會自動獲取你的裝置資訊,然後自動修補官方韌體,然後刷入;你可以考慮使用
fastboot boot
KernelSU 的 GKI 內核來取得臨時 root 安裝管理器,然後再使用這個選項;這種方式也是 KernelSU 升級最主要的方式; - 安裝到另一個分割區:如果你的裝置支援 A/B 分割區,你可以選擇這個選項,管理器會自動修補官方韌體,然後安裝到另一個分割區;這種方式適用於 OTA 後的裝置,你可以在 OTA 後直接安裝到另一個分割區,然後重新啟動裝置即可;
使用命令列
如果你不想使用管理器,你也可以使用命令列來安裝 LKM;KernelSU 提供的 ksud
工具可以幫助你快速修補官方韌體,然後刷入。
這個工具支援 macOS、Linux 和 Windows,你可以在 GitHub Release 下載對應的版本。
使用方法:ksud boot-patch
具體的使用方法你可以查看命令列幫助。
husky:/ # ksud boot-patch -h
Patch boot or init_boot images to apply KernelSU
Usage: ksud boot-patch [OPTIONS]
Options:
-b, --boot <BOOT> boot image path, if not specified, will try to find the boot image automatically
-k, --kernel <KERNEL> kernel image path to replace
-m, --module <MODULE> LKM module path to replace, if not specified, will use the builtin one
-i, --init <INIT> init to be replaced
-u, --ota will use another slot when boot image is not specified
-f, --flash Flash it to boot partition after patch
-o, --out <OUT> output path, if not specified, will use current directory
--magiskboot <MAGISKBOOT> magiskboot path, if not specified, will use builtin one
--kmi <KMI> KMI version, if specified, will use the specified KMI
-h, --help Print help
需要說明的幾個選項:
--magiskboot
選項可以指定 magiskboot 的路徑,如果不指定,ksud 會在環境變數中尋找;如果你不知道如何取得 magiskboot,可以參考這裡;--kmi
選項可以指定KMI
版本,如果你的裝置核心名字沒有遵循 KMI 規範,你可以透過這個選項來指定; 最常見的使用方法為:
ksud boot-patch -b <boot.img> --kmi android13-5.10
GKI 安裝
GKI 的安裝方式有以下幾種,各自適用於不同的場景,請依需求選擇:
- 使用自訂 Recovery (如 TWRP) 安裝
- 使用核心刷新應用程式 (例如 Franco Kernel Manager) 安裝
- 使用 KernelSU 提供的 boot.img 透過 Fastboot 安裝
- 手動修補 boot.img 並安裝
使用自訂 Recovery 安裝
先決條件:您的裝置必須有自訂的 Recovery,例如 TWRP;如果沒有或者只有官方 Recovery,請使用其他方法。
步驟:
- 在 KernelSU 的 Release 頁面 下載與您手機版本相符的以 AnyKernel3 開頭的 Zip 套件;例如,手機核心版本為
android12-5.10.66
,那麼您應該下載AnyKernel3-android12-5.10.66_yyyy-MM.zip
這個檔案 (其中yyyy
為年份,MM
為月份)。 - 重新開機手機至 TWRP。
- 使用 Adb 將 AnyKernel3-*.zip 放置到手機 /sdcard 然後在 TWRP 圖形使用者介面選擇並安裝;或者您也可以直接
adb sideload AnyKernel-*.zip
安裝。
PS. 這種方法適用於任何狀況下的安裝 (不限於初次安裝或後續更新),只要您用 TWRP 就可以進行作業。
使用核心刷新應用程式安裝
先決條件:您的裝置必須已經 Root。例如您已經安裝了 Magisk 並取得 Root 存取權,或者您已經安裝了舊版本的 KernelSU 需升級到其他版本的 KernelSU;如果您的裝置並未 Root,請嘗試其他方法。
步驟:
- 下載 AnyKernel3 的 Zip 檔案;請參閱 使用自訂 Recovery 安裝 章節的内容。
- 開啟核心刷新應用程式提供的 AnyKernel3 Zip 檔案進行刷新。
如果您先前並未使用過核心刷新應用程式,可以嘗試下面幾個方法:
PS. 這種方法在更新 KernelSU 時比較方便,無需電腦即可完成 (注意備份!)。
使用 KernelSU 提供的 boot.img 安裝
這種方法無需您有 TWRP,也無需您的手機有 Root 權限;適用於您初次安裝 KernelSU。
找到合適的 boot.img
KernelSU 為 GKI 裝置提供了標準 boot.img,您需要將 boot.img 刷新至裝置的 Boot 分割區。
您可以從 GitHub Release 下載 boot.img,請注意,您應該使用正確版本的 boot.img。例如,如果您的裝置顯示核心是 android12-5.10.101
,需要下載 android-5.10.101_yyyy-MM.boot-<format>.img
.
其中 <format>
指的是您的官方 boot.img 的核心壓縮格式,請檢查您原有 boot.img 的核心壓縮格式,您應該使用正確的格式,例如 lz4
、gz
;如果使用不正確的壓縮格式,刷新 Boot 後可能無法開機。
INFO
- 您可以透過 magiskboot 以取得您的原始 Boot 的壓縮格式;當然,您也可以詢問與您相同型號的其他更有經驗的使用者。另外,核心的壓縮格式通常部會出現變更,如果您使用的某個壓縮格式成功開機,後續可以優先嘗試這個格式。
- 小米裝置通常
gz
或者 不壓縮。 - Pixel 裝置有些特殊,請遵循下方的指示。
將 boot.img 刷新至裝置
使用 adb
連接您的裝置,然後執行 adb reboot bootloader
進入 fastboot 模式,然後使用此命令刷新 KernelSU:
fastboot flash boot boot.img
INFO
如果您的裝置支援 fastboot boot
,可以先使用 fastboot boot boot.img
來先嘗試使用 boot.img 開機進入系統,如果出現意外,重新啟動即可開機。
重新開機
刷新完成後,您應該重新啟動您的裝置:
fastboot reboot
手動修補 boot.img
對於某些裝置來說,其 boot.img 格式並不是很常見,比如 lz4
,gz
和未壓縮;最典型的就是 Pixel,它的 boot.img 格式是 lz4_legacy
壓縮,ramdisk 可能是 gz
也可能是 lz4_legacy
壓縮;此時如果您直接刷新 KernelSU 提供的 boot.img,手機可能無法開機;這時,您可以透過手動修補 boot.img 來完成。
一般有兩種修補方法:
其中,Android-Image-Kitchen 適用於在電腦上作業,magiskboot 需要手機協作。
準備
- 取得您手機的原廠 boot.img;您可以聯絡您的裝置製造商,您也可能需要payload-dumper-go
- 下載 KernelSU 提供的與您的裝置 KMI 一致地 AnyKernel3 Zip 檔案 (可參閱 使用自訂 Recovery 安裝)。
- 解壓縮 AnyKernel3 Zip 檔案,取得其中的
Image
檔案,此檔案為 KernelSU 的核心檔案。
使用 Android-Image-Kitchen
- 下載 Android-Image-Kitchen 至您的電腦。
- 將手機原廠 boot.img 放置於 Android-Image-Kitchen 根目錄。
- 在 Android-Image-Kitchen 根目錄執行
./unpackimg.sh boot.img
;此命令會將 boot.img 解除封裝,您會得到一些檔案。 - 將
split_img
目錄中的boot.img-kernel
取代為您從 AnyKernel3 解壓縮出來的Image
(注意名稱變更為 boot.img-kernel)。 - 在 Android-Image-Kitchecn 根目錄執行
./repackimg.sh
;此時您會得到一個image-new.img
檔案;使用此 boot.img 透過 fastboot 刷新即可 (刷新方法請參閱上一章節)。
使用 magiskboot
- 在 Magisk 的 Release 頁面 下載最新的 Magisk 安裝套件。
- 將
Magisk-*(version).apk
重新命名為Magisk-*.zip
然後解壓縮。 - 將解壓縮後的
Magisk-*/lib/arm64-v8a/libmagiskboot.so
檔案,使用 Adb 推入至手機:adb push Magisk-*/lib/arm64-v8a/libmagiskboot.so /data/local/tmp/magiskboot
- 使用 Adb 將原廠 boot.img 和 AnyKernel3 中的 Image 推入至手機。
- adb shell 進入 /data/local/tmp/ 目錄,然後賦予先前推入檔案的可執行權限
chmod +x magiskboot
- adb shell 進入 /data/local/tmp/ 目錄,執行
./magiskboot unpack boot.img
此時會將boot.img
解除封裝,得到一個名為kernel
的檔案,這個檔案是您的原廠核心。 - 使用
Image
取代kernel
:mv -f Image kernel
- 執行
./magiskboot repack boot.img
重新封裝 img,此時您會得到一個new-boot.img
檔案,透過 Fastboot 將這個檔案刷新至裝置即可。
GKI的其他替代方法
其實所有這些安裝方法的主旨只有一個,那就是將原廠核心取代為 KernelSU 提供的核心;只要能實現這個目的,就可以安裝;比如以下是其他可行的方法:
- 首先安裝 Magisk,透過 Magisk 取得 Root 權限後使用核心刷新程式刷新 KernelSU 的 AnyKernel Zip。
- 使用某些 PC 上的刷新工具組刷新 KernelSU 提供的核心。