【免费下载】 Screenly/Anthias项目：树莓派5通过PCIe SSD安装指南

硬件准备

本教程基于树莓派5（8GB内存版本）配合GeeekPi P33 PoE+PCI-e扩展板实现。该扩展板支持M.2 NVMe固态硬盘，早期版本仅支持2230和2242规格的SSD，新版已扩展支持2260和2280规格。

建议选择256GB容量的NVMe SSD，2242规格（22mm×44mm）是较理想的选择。虽然教程使用特定扩展板，但任何兼容树莓派5的PCIe HAT理论上均可使用。

启动方式注意事项

树莓派5的早期版本出厂引导程序不支持PCIe启动。若您的设备引导程序版本早于2024年9月23日的版本（可通过sudo rpi-eeprom-update命令查看），则需要先通过microSD卡启动并配置引导顺序。

详细安装步骤

第一步：系统镜像写入

推荐使用树莓派官方镜像工具，将64位Raspberry Pi OS Lite（Bookworm版本）写入microSD卡。根据实际需求，您可以选择：

1. 将相同系统写入SSD
2. 或将BalenaOS镜像部署到SSD

替代安装方案包括：

• 网络启动（需在树莓派上启用）
• 通过SD卡启动后使用系统自带的SD卡复制工具
• 使用树莓派镜像工具直接写入SSD
• 通过rpiboot模式将SSD识别为PC上的存储设备

从SD卡启动配置（必要时）

若您的设备需要先通过SD卡启动配置：

1. 启动后执行：sudo rpi-eeprom-config -edit
2. 修改引导顺序为：BOOT_ORDER=0xf614
3. 新增配置行：PCIE_PROBE=1
4. 按Ctrl-O保存，Ctrl-X退出编辑器
5. 移除SD卡后重启设备

专业提示：通过sudo rpi-eeprom-update可检查引导程序版本，添加-a参数可自动更新到最新版本。

从SSD启动后的配置

成功从SSD启动后，若安装的是Raspberry Pi OS，需执行以下操作：

1. 系统更新：

   sudo apt update -y
   sudo apt full-upgrade -y
   

2. 引导程序更新检查：

   sudo rpi-eeprom-update
   

3. 通过raspi-config更新引导程序：

   sudo raspi-config
   

   选择路径：6 高级选项 → A5 引导程序版本 → E1 最新版本

4. 重启后安装Anthias：

   bash <(curl -sL https://install-anthias.srly.io)
   

   按照提示完成安装并重启

5. 最后务必修改默认密码：

   passwd
   

常见问题排查

启动顺序验证

执行rpi-eeprom-config可查看当前启动顺序配置。树莓派官方文档详细说明了各启动选项的含义，您可以根据实际需求调整这些参数。

安装后黑屏问题

若安装完成后出现黑屏现象，可通过以下步骤解决：

1. 按Ctrl-Alt-F1进入控制台
2. 或通过SSH连接设备
3. 执行容器升级脚本：

   ./screenly/bin/upgrade_containers.sh
   

   该脚本会重新创建容器，通常能解决显示问题

技术要点解析

1. PCIe启动原理：树莓派5的PCIe启动依赖于引导程序的特定配置，新版本已原生支持，旧版本需手动配置。

2. BOOT_ORDER参数：0xf614中的各位分别对应不同启动设备尝试顺序，这是树莓派特有的配置方式。

3. 容器化架构：Anthias采用容器化部署，upgrade_containers.sh脚本负责管理容器生命周期，这是解决显示问题的关键。

4. 安全建议：教程特别强调修改默认密码，这是因为数字标牌设备常部署在公共场合，安全配置尤为重要。

本指南涵盖了从硬件选型到系统配置的全流程，特别针对树莓派5的新特性进行了优化说明，帮助用户充分发挥PCIe SSD的性能优势。