raspi-overlayroot 项目常见问题解决方案

项目基础介绍

raspi-overlayroot 是一个用于保护 Raspberry Pi 的 SD 卡免受磨损和数据丢失的开源项目。该项目通过在 Raspberry Pi 上使用 OverlayFS 文件系统，将根文件系统挂载为只读，同时在内存中创建一个可写的覆盖层。这样，所有的写操作都会在内存中进行，从而保护 SD 卡免受频繁写入的损害。

该项目主要使用 Shell 脚本和一些 Linux 系统配置文件进行配置和管理。

新手使用注意事项及解决方案

1. 安装过程中遇到 makepkg -si 命令失败

问题描述：新手在安装过程中可能会遇到 makepkg -si 命令失败的情况，通常是由于缺少必要的依赖包或编译环境不完整。

解决步骤：

1. 检查依赖包：确保系统中已经安装了 base-devel 和 fakeroot 等必要的编译工具包。可以通过以下命令安装：

   sudo pacman -S base-devel fakeroot
   

2. 重新尝试安装：在安装了必要的依赖包后，重新运行 makepkg -si 命令。

2. 启动后无法进入系统

问题描述：在启用 overlayroot 后，系统可能无法正常启动，显示错误信息或直接进入紧急模式。

解决步骤：

1. 检查配置文件：确保 /etc/mkinitcpio.conf 文件中正确添加了 overlay 和 overlayroot 到 MODULES 和 HOOKS 数组中。

   MODULES=(... overlay ...)
   HOOKS=(... overlayroot ...)
   

2. 重建 initramfs：运行以下命令重建 initramfs：

   sudo mkinitcpio -P
   

3. 重启系统：重启系统，检查是否能够正常启动。

3. 系统启动后无法写入文件

问题描述：系统启动后，用户可能会发现无法在根文件系统中写入文件，即使是在 /tmp 目录下。

解决步骤：

1. 检查挂载状态：确认系统已经正确挂载了 OverlayFS。可以通过以下命令查看挂载状态：

   mount | grep overlay
   

2. 临时禁用 overlayroot：如果需要临时禁用 overlayroot，可以在启动时添加内核参数 rwrootfs，例如：

   sudo nano /boot/cmdline.txt
   

   在文件末尾添加 rwrootfs，保存并重启系统。

3. 永久禁用 overlayroot：如果需要永久禁用 overlayroot，可以编辑 /etc/mkinitcpio.conf 文件，移除 overlayroot 钩子，然后重新生成 initramfs。

通过以上步骤，新手用户可以更好地理解和使用 raspi-overlayroot 项目，解决常见的问题。