postmarketOS通用安裝教學

這篇文章是postmarketOS的通用安裝教學，大部分支援的機型都能夠按照此步驟操作，將postmarketOS安裝至手機上，鮮少需要另外打patch的。

本文示範手動在電腦上建立postmarketOS安裝檔再刷入手機。我的電腦是Ubuntu 22.04，手機是小米Pocophone F1，已解鎖bootloader，安裝TWRP作為Recovery。

大部分的問題在postmarketOS Wiki都有解答。

1. 什麼是postmarketOS

Android基於Linux的核心研發而來，但跟一般的GNU/Linux仍有所差異。postmarketOS是基於Alpine Linux，跟Ubuntu touch一樣，旨在為行動作業系統提供另一種選擇，將真正的Linux發行版安裝到裝置上，提供長達10年的系統更新，並儘量使用Mainline kernel。

由於鎖定的目標是過季裝置，所以百款以上的舊型手機/，如Google Nexus 5、Samsung i9100都有支援，比較新的機型如OnePlus 8亦有人移植。

目前postmarketOS跟電腦上的Linux系統很像，可以跑電腦版的程式，還能跑伺服器類的服務，例如Docker。

目前移植的手機以小米和一加居多，但是都有部份硬體無法運作。只有Pine64 PinePhone和Purism Librem 5這種原生Linux手機的硬體才全部正常。

2. postmarketOS系統要求

確保你有Android刷機相關的知識，知道如何解鎖bootloader、刷入ROM、使用第三方Recovery，並懂得如何使用Linux系統(至少用過Ubuntu一年以上)。

準備好安裝postmarketOS到你的手機了? 先到postmarketOS Wiki瀏覽，看看你的機型是否有在裡面，沒有的話你也可以嘗試自行移植。

以下為2022年8月的postmarketOS裝置支援狀態，“Main"和"Community"列表代表的是所有硬體(Wifi、觸控、藍芽…)幾乎正常的裝置，“Testing"則是只要能開機的裝置都算在內。

在開始安裝postmarketOS之前，你需要一台x64架構的Linux電腦，虛擬機也可以，WSL不行。以下用Ubuntu 22.04作示範。

3. 安裝pmbootstrap

要安裝postmarketOS，第一個方法是從官網下載官方提供的安裝檔。或是第二個方法：手動在電腦上建立安裝檔然後刷入手機，也就是本文所介紹的方法。

pmbootstrap是postmarketOS官方的工具，除了建立安裝檔案以外，亦能進行移植工作。

在Linux上安裝pmboostrap：

1
2
pip3 install --user pmbootstrap
source ~/.profile

安裝自動補完

1
sudo apt install python3-argcomplete

在bash shell的設定檔~/.bashrc加入以下內容

1
echo 'eval "$(register-python-argcomplete3 pmbootstrap)"' >> ~/.bashrc

4. 選擇你的機型並設定選項

pmbootstrap在初始化時會從Gitlab上下載最新版的機型設定檔:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
#初始化
pmbootstrap init

#按Enter使用預設工作目錄 (~/.local/var/pmbootstrap)
Work path: Enter

#更新頻道選擇edge，或者填入寫有Recommended for best stability的穩定版。
Channel: edge

#選擇手機廠牌
Vendor: xiaomi

#選擇手機的裝置代號
Device codename: beryllium

#建立pmOS的使用者帳戶
Username: User

#選擇桌面環境，XFCE4(x11)適合沒有硬體加速的裝置；Phosh(Wayland，需要硬體加速)適合當手機介面。在開機後可以再另外安裝其他桌面環境。
User Interface: phosh

#剩下全部Enter

這就是每次建立對應機型的安裝檔要先做的工作，你必須告訴pmbootstrap你的postmarketOS應該長什麼樣子，才能開始建立安裝檔案。

5. 選擇安裝postmarketOS到手機的方法

這個步驟就要建立安裝檔案了，主要有3種安裝postmarketOS的方法：

安裝至SD卡 (不會影響到原有手機系統，不推薦)
用fastboot刷入 (需清除資料，推薦)
用刷機包刷入 (需清除資料，不推薦)

除此之外還有一些比較奇怪的安裝方法，列在後面。

5.1. 安裝至SD卡

這個方法不會修改手機的資料，可以做雙系統，但是開機需要靠電腦下指令才能進入postmarketOS。

SD卡插到電腦，用指令lsblk確定SD卡的裝置代號，以及掛載點：

1
sdb      8:16   1  29.7G  0 disk /media/ivon/E8D8-4246

先取消掛載

1
umount /media/ivon/E8D8-4246

然後再開始安裝

1
pmbootstrap install --sdcard=/dev/sdb

pmbootstrap會自動格式化SD卡，並將系統安裝進去。過程中會要求建立使用者密碼，並會再確認是否要將SD卡格式化。
接著把SD卡裝到手機，讓手機進入fastboot模式，接到電腦，輸入指令開機:

1
pmbootstrap flasher boot

5.2. 用fastboot刷入

這個方法將清除手機所有的資料。

建立安裝檔

1
pmbootstrap install

2.手機進入fastboot模式，接到電腦刷入:

1
2
3
4
pmbootstrap flasher flash_rootfs

#如果刷入的分區太小，加上--partition參數，改刷入到其他分區:
pmbootstrap flasher flash_rootfs --partition userdata

再刷入kernel到boot分區，重開機:

1
2
pmbootstrap flasher flash_kernel
fastboot reboot

5.3. 用刷機包安裝

這個方法將清除手機所有的資料，可sideload或者傳輸刷機包到手機上再用TWRP安裝。

建立刷機包，大約5分鐘。

1
2
3
pmbootstrap install --android-recovery-zip
#如果要安裝到其他較大的分區，可以加上--partition的選項
pmbootstrap install --android-recovery-zip --recovery-install-partition=data

手機接上電腦，重開機進入TWRP。從電腦的工作目錄找到建立的pmos-*.zip刷機包，例如我的檔案是在~/.local/var/pmbootstrap/chroot_buildroot_aarch64/var/lib/postmarketos-android-recovery-installer。
將檔案傳到手機，用TWRP安裝，之後重新開機。
將電腦上的pmbootstrap關閉：

1
pmbootstrap shutdown

5.4. 其他刷入方法

Netboot：用postmarketOS的boot.img暫時開機後，掛載電腦上的檔案系統。
用Netcat開機
用NFS開機

6. postmarketOS後續安裝優化

就算開機無法進入桌面，手機用USB線連著電腦的情況下，也能用SSH連線到手機：

1
2
#這個IP是固定的，只需將「@」前面改成你的使用者帳號
ssh user@172.16.42.1

假設你的裝置順利進入postmarketOS桌面環境，並且GPU加速、觸控、網路、音效都正常的話，接下來請參考這篇：postmarketOS使用技巧了解postmarketOS的設定眉角，以及如何將postmarketOS當作手機系統用。

postmarketOS通用安裝教學

相關文章：