在 Debian 13 系统环境下完全通过命令行为小米 Redmi 5 Plus (vince) 手机刷入轻量级的 postmarketOS 移动操作系统

1. 前提条件

1. 您的 Redmi 5 Plus 必须已经 解锁 Bootloader。
2. 电脑已安装 Debian 13 系统。

2. 安装必要工具

2.1 安装 Python（推荐使用 Miniconda）

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash ~/Miniconda3-latest-Linux-x86_64.sh
python --version

提示: 安装完成后，您可能需要重启终端或运行 source ~/.bashrc 让python命令生效。

2.2 安装 fastboot

sudo apt install android-sdk-platform-tools-common android-sdk-platform-tools

2.3 安装 pmbootstrap

git clone https://gitlab.postmarketos.org/postmarketOS/pmbootstrap.git
cd pmbootstrap
pip install .
pmbootstrap --version

3. 初始化 pmbootstrap 配置

运行初始化命令并根据提示进行配置。

pmbootstrap init

配置选项及推荐值：

序号	选项描述 (原文/翻译)	您的输入/选择	目的或说明
1	Work path (工作路径)	回车 (默认)	默认路径通常最佳。
2	pmaports path (pmaports 路径)	回车 (默认)	存放 postmarketOS 软件包定义文件的路径。
3	Available postmarketOS release (选择发行版)	v25.06	选择您希望安装的 postmarketOS 版本。
4	Vendor (选择设备厂商)	qcom	Redmi 5 Plus 采用高通芯片。
5	Device codename (选择设备型号)	msm8953	Redmi 5 Plus 所属的平台代号。
6	Username (设置用户名)	qixinlee	替换为您想要的用户名。
7	Available providers for postmarketos-base-ui-wifi (选择 WiFi 后端)	回车 (默认)	默认选择 default 即可。
8	User interface (选择用户界面)	phosh	推荐 Phosh，它是一个基于 GNOME 的移动界面。
9	Install systemd? (是否安装 systemd)	回车 (默认)	默认选择 y。
10	Change them? (y/n) (更改额外选项)	回车 (默认 n)	通常无需更改。
11	Extra packages (额外软件包)	回车 (默认 none)	暂不添加额外软件包。
12	Use this timezone instead of GMT? (使用此本地时区)	回车 (默认 y)	使用本地时间而非 GMT。
13	Locale (选择本地化语言环境)	回车 (默认 en_US)	推荐使用 en_US，以确保兼容性。
14	Device hostname (设置设备主机名)	回车 (默认)	设备在网络上的名称。
15	Build outdated packages? (构建过时包)	回车 (默认 y)	允许构建可能过时的包，提高成功率。
16	Zap existing chroots…? (清空已有 chroot)	回车 (默认 y)	确保配置能立即生效。

4. 构建系统 (Install)

开始构建 postmarketOS 系统镜像。

pmbootstrap install

系统会提示设置用户登录密码，请根据提示输入两次密码：

*** SET LOGIN PASSWORD FOR: 'qixinlee' ***
New password:
Retype new password:

5. 电脑连接设备进行刷写

将手机进入 Fastboot 模式：关闭手机电源，然后同时按住 音量下键 和 电源键，直到屏幕上出现 Fastboot 字样，连接电脑。

5.1 确认设备已连接

sudo fastboot devices

提示: 如果能看到设备序列号，则连接成功。

5.2 刷入 lk2nd (引导加载程序)

pmbootstrap flasher flash_lk2nd

5.3 刷入 rootfs (系统文件系统)

pmbootstrap flasher flash_rootfs

5.4 重启设备

sudo fastboot reboot

设备将自动启动进入您所选择的 postmarketOS 用户界面