外观
树莓派 NAS
目标：用树莓派加一块 USB 硬盘，搭一台低功耗、安静、体积很小的 NAS，提供 SMB 共享和少量轻量容器。
适合谁
- 数据量小到中等，单盘就够，家里 1 到 3 个人使用。
- 想要低功耗、无风扇、小体积，能接受速度和扩展性上的限制。
- 不适合：需要多盘 RAID、热插拔的；要跑 Immich 这类吃资源的应用的；多人同时传大文件的。这些场景看家庭 NAS或低成本方案。
路线里有几步会清除存储设备上的数据
- 影响范围：往 SD 卡或 U 盘写系统镜像会清空整个设备；给 USB 硬盘创建文件系统会清空这块盘；官方整机安装脚本还会改动网络和 SSH 设置。
- 前置条件：写镜像前确认选对了设备，用型号和容量核对，别选错成数据盘。数据盘用新盘，或确认里面的数据已有备份。
- 怎么回退：清除之后无法回退，只能从备份恢复。SD 卡上的系统可以靠镜像备份恢复，见下面的「备份方案」。
先确认型号和系统
OMV 8 只支持 64 位，对树莓派的要求来自 omv-extras wiki 的兼容性页面：
| 项 | 内容 |
|---|---|
| 支持的型号 | Pi 3B、3B+、3A+、4、400、5，以及 Compute Module 3+、4、5，必须用 64 位系统 |
| 不支持 | Pi 1、Zero、Pi 2 v1.0，它们是 32 位硬件 |
| 系统镜像 | Raspberry Pi OS Lite（64 位，基于 Debian Trixie）。带桌面的镜像不受支持 |
| 网络 | 安装过程需要有线网络和互联网。wiki 建议先不要预配置 Wi-Fi，装好之后再在 OMV 里加 |
其他 ARM 单板机的选型见 ARM 单板机怎么选。Armbian 要自检用户空间是 64 位，见版本对照表里的架构自检。
硬件与存储方案
| 项 | 选择 | 理由 |
|---|---|---|
| 系统 | Raspberry Pi OS Lite 64 位加 omv-extras 的整机安装脚本 | 官方文档指向这条路线 |
| 系统盘 | 名牌新 SD 卡，A1 级、Class 10 或更好，16 GB 更长寿 | 先格式化，再用 h2testw 之类的工具写入校验，防止买到假容量卡 |
| writecache | 必装 | wiki：闪存系统盘不用它会提前报废。整机安装脚本默认会装 |
| 数据盘 | 自带电源的 USB 硬盘或硬盘盒，单盘 EXT4 | 不用 USB 盘组 RAID |
| 备份 | SD 卡整盘镜像，加一块备份用的 USB 盘 | 见下文 |
供电和性能
- 供电：树莓派常见的问题是 USB 供电不足。wiki 的建议是用短而粗的线，避免让硬盘直接由树莓派供电，并用
dmesg查有没有 undervoltage 之类的报错。 - 性能预期：瓶颈通常在 USB 总线、网口和 CPU，不在 OMV。不同型号差别很大，这里不给数字，装好之后自己测，见性能测试：fio 与 iperf3。
分步路线
| 步骤 | 做什么 | 教程 |
|---|---|---|
| 1. 选板和配件 | 型号、电源、USB 硬盘盒、SD 卡 | ARM 单板机怎么选、硬件要求 |
| 2. 准备 SD 卡 | 格式化并校验，发现假容量卡就退掉 | 系统盘怎么选 |
| 3. 写入系统并安装 OMV | Raspberry Pi OS Lite 64 位，再运行整机安装脚本 | 在树莓派等 ARM 设备上安装 |
| 4. 首次登录和加固 | 改默认密码，检查 SSH | 第一次登录、安装后检查清单 |
| 5. writecache 和 omv-extras | 确认 writecache 已启用，需要插件再装 omv-extras | writecache 插件、安装 omv-extras |
| 6. USB 硬盘 | 按型号和序列号确认磁盘，建 EXT4，读不到 SMART 也属正常 | 外接 USB 硬盘的正确用法、S.M.A.R.T.、创建并挂载文件系统 |
| 7. 共享 | 建共享文件夹和用户，开 SMB | 共享文件夹、SMB/CIFS 共享 |
| 8. 容器（可选） | 只跑少量轻量应用，镜像要有 arm64 版本 | 安装 Docker 与 Compose 插件、部署第一个应用 |
| 9. 备份 | SD 卡镜像，数据同步到另一块盘 | 备份系统盘、插上 USB 硬盘自动备份 |
| 10. 维护 | 更新和健康检查 | 系统更新、健康检查清单 |
在界面里保存任何设置之后，都要点页面顶部黄色提示条上的应用（Apply），配置才会真正生效。
几个容易踩的坑：
- 整机安装脚本会开启 SSH 并允许 root 密码登录，还可能改动原有的网络配置，Wi-Fi 受影响的概率更大。装完立刻照安装后检查清单关掉 root 的 SSH 登录。
- 别把 Docker 数据放在 SD 卡或 U 盘系统盘上，持续写入会让它很快折寿，哪怕装了 writecache 也一样。Docker 存储放到 USB 硬盘上，见 Compose 插件设置详解。
- wiki 建议 SBC 在装 Docker 之前先保持 DHCP，之后需要固定地址时，在路由器上做 DHCP 预留最省事，见网络接口。
备份方案
| 数据 | 怎么保护 | 教程 |
|---|---|---|
| SD 卡上的系统 | backup 插件的 ddfull 方式做整盘镜像，对树莓派来说恢复最简单。恢复时在另一台电脑上把镜像写到新的 SD 卡，不需要救援盘。有条件准备两张卡 | 备份系统盘 |
| USB 盘上的数据 | 第二块 USB 盘，用 USB 备份或 rsync 任务定期同步。同机的备份盘防不了偷盗和断电，重要数据再加一份离开这台机器的副本 | 插上 USB 硬盘自动备份、rsync 任务、异地与云端备份 |
| 配置 | 把用户、共享、权限写成文档 | OMV 配置怎么留底 |
| 验证 | 把镜像写到另一张卡上，真的启动一次 | 恢复演练 |
验收清单
- [ ]
dmesg里没有 undervoltage 之类的供电警告，硬盘不会无故掉线。 - [ ] writecache 已启用。
- [ ] root 的 SSH 登录已关闭，默认密码已改。
- [ ] 重启之后 USB 盘自动挂载，共享自动恢复。
- [ ] 用 iperf3 和实际拷文件测过速度，结果符合你的预期。
- [ ] SD 卡镜像做过一份，并在另一张卡上验证过能启动。
- [ ] 备份盘上的同步跑过一次，恢复过一个文件。
常见问题
能用 USB 盘代替 SD 卡当系统盘吗？ 可以。omv-extras wiki 提到过把 OMV 装在 U 盘上并配合 writecache 的做法。同样要备份系统盘，持续写入的数据（例如 Docker）也不该放在这块盘上。
Wi-Fi 怎么配？ 先用有线网络装好系统，再在 OMV 的网络接口里添加 Wi-Fi 接口。NAS 不推荐长期靠 Wi-Fi，见代理与无线网络。
装完之后连不上了？ 先看路由器的 DHCP 列表，IP 可能变了；还是不行就接显示器键盘，见改坏网络后怎么救。