1. 项目概述与核心价值折腾家庭存储这事儿我估计不少技术爱好者都琢磨过。从最早用旧电脑装个黑群晖到后来各种成品NAS再到如今用树莓派这类单板电脑自己搭建玩法是越来越多了。这次我分享的是基于树莓派5打造的一台自带“小电瓶”UPS不间断电源和高速M.2固态硬盘的NAS系统。这玩意儿说白了就是一台放在你家角落、24小时开机的私人数据服务器你的手机、电脑、电视都能直接访问它里面的电影、照片、文档还能自动备份重要数据。为什么选树莓派5相比上一代它的性能提升是实打实的更快的CPU、支持PCIe 2.0接口这意味着我们可以通过扩展板直接接上NVMe协议的M.2固态硬盘摆脱了以往树莓派存储只能依赖USB或SD卡的带宽瓶颈。而给它加上UPS不间断电源板子则是为了解决家庭环境一个非常实际的痛点——意外断电。你肯定不想正在往NAS里拷贝重要文件或者它正在执行定时备份任务时突然停电导致系统崩溃甚至硬盘损坏吧这套方案的核心价值就是在极致的性价比和DIY乐趣之上增加了数据安全和存储性能这两个关键维度让它从一个“玩具级”的存储方案变得更可靠、更实用足以承担家庭核心数据仓库的角色。2. 硬件选型与设计思路拆解自己搭NAS硬件是地基。选对配件不仅关系到最终性能更决定了搭建过程的顺利程度和长期运行的稳定性。我的整体思路是以树莓派5为核心计算单元通过专用扩展板HAT来补足其原生接口的短板最后用一个设计合理的机箱把所有东西规整地装起来兼顾散热与美观。2.1 核心计算单元为什么是树莓派5树莓派5是目前树莓派家族中的性能担当。对于NAS应用几个关键升级点让它脱颖而出PCIe 2.0 x1接口这是本次项目的灵魂。虽然带宽只有约500MB/s理论值但足以让NVMe SSD发挥出远超千兆网络约113MB/s的本地读写速度为未来升级2.5G甚至更高速度的网络预留了性能空间同时大幅降低存储延迟。更强的CPU与内存其ARM Cortex-A76架构处理器应对文件共享、Docker容器、轻量级转码等NAS常见任务游刃有余。建议起步选择4GB或8GB内存版本为系统和服务留出充足余量。双HDMI与供电改进调试更方便且支持PD协议的USB-C供电更稳定。注意树莓派5的PCIe接口默认并未启用需要在系统配置中手动开启。这是后续软件设置中的一个关键步骤我会在实操部分详细说明。2.2 存储扩展方案PCIe to Dual M.2 HAT直接使用树莓派5的PCIe接口连接M.2 SSD是提升存储性能的关键。我选用的是Geekworm X1004这类扩展板。它的设计考量很明确双盘位设计允许你配置RAID 1镜像以实现数据冗余一块硬盘故障数据不丢或者配置RAID 0条带化以获得更大的聚合带宽和容量。对于家庭用户我更推荐单盘使用或RAID 1数据安全第一。免驱兼容性在Linux系统下NVMe SSD通常是即插即用的大大简化了配置。物理连接通过一条柔软的FPC排线连接到树莓派5的PCIe引脚并由扩展板本身的螺丝柱固定结构稳固。为什么不直接用USB硬盘盒USB 3.0接口虽然方便且理论速度5Gbps也够用但其共享总线带宽、依赖USB-SATA桥接芯片的特性会引入额外的延迟和兼容性问题。对于需要7x24小时运行、频繁读写的NAS系统直连PCIe在稳定性、延迟和CPU占用率上都有显著优势。2.3 电力保障核心超薄UPS扩展板断电保护是NAS从“可用”到“可靠”的质变。我选择的是Geekworm X1201这类专为树莓派5设计的超薄UPS板。它的工作原理是双路供电自动切换板子同时接入外部5V电源如原装电源和两节并联的18650锂电池。有外部电源时由外部电源供电并同时为电池充电。无缝切换当外部电源断开停电或拔插头板载电路会在毫秒级时间内无缝切换至电池供电树莓派完全感知不到断电持续运行。安全关机信号更高级的功能是UPS板可以通过GPIO引脚向树莓派发送“电池供电”和“电池电量低”信号。我们可以编写脚本让树莓派在检测到电池供电且电量即将耗尽时自动执行安全关机流程避免数据损坏。关于18650电池的选择 这不是普通的五号电池。务必选择带有“保护板”的动力型18650锂电池如一些知名品牌的3100mAh、3500mAh产品。保护板能防止过充、过放和短路安全第一。电池容量决定了断电后的续航时间以树莓派5满载约10W功耗计算两节3400mAh电池约24Wh大约能提供2小时以上的续航足够完成安全关机。2.4 散热与机箱安静与稳定的守护者树莓派5的功耗和发热比前代高主动散热几乎是必须的。Geekworm H505这类带风扇的散热器通过导热垫直接接触SoC和内存芯片能有效控制温度。风扇策略建议在系统中将风扇设置为温控模式例如温度超过50°C时启动避免一直全速运转产生噪音。机箱选择Geekworm X1201-C1这类金属机箱与UPS板、散热器是配套设计的。金属机箱有助于被动散热同时为所有堆叠的板卡和电池提供了坚固的保护和电磁屏蔽。良好的风道设计如侧面开孔也能辅助散热。3. 硬件组装与布线实操要点组装过程像搭积木但顺序和细节决定成败。核心原则是先连接再固定先测试再封装。3.1 第一步安装主动散热器清洁芯片表面用高纯度异丙醇或无水酒精和无尘布轻轻擦拭树莓派5上CPU最大的那个芯片和内存芯片CPU旁边的几个小芯片表面确保没有油污和灰尘。这是保证导热垫良好接触的关键。粘贴导热垫散热器配套的导热垫通常已预先切割好。撕掉一侧的保护膜将其精准覆盖在需要散热的芯片上然后轻轻按压使其粘牢。注意不要有气泡或褶皱。安装散热器本体将散热器对准位置放下确保其底部的导热部分完全覆盖所有导热垫。然后均匀用力按下四个角落的固定卡扣听到清脆的“咔嗒”声表示已锁紧。用手轻轻摇晃检查是否牢固。实操心得有些散热器的固定卡扣非常紧安装时最好将树莓派放在一个平整、柔软的表面上如鼠标垫用指腹垂直向下均匀发力避免因受力不均导致主板弯曲。3.2 第二步堆叠UPS板与PCIe扩展板这是最核心的硬件连接步骤顺序很重要。准备UPS板将带螺纹的铜柱拧在UPS板正面即有电子元件和电池触点的这一面的四个角上。这面将来会朝向树莓派。将不带螺纹的尼龙隔离柱用附带的小螺丝固定在UPS板背面的对应位置。这面用来放置18650电池。这个设计目的是用铜柱连接上层的树莓派用尼龙柱隔离下层的金属电池触点防止短路。连接PCIe扩展板与树莓派先对准再下压将PCIe扩展板X1004的排线插座与树莓派5板载的PCIe连接器位于USB口旁边一个很小的白色插座仔细对准。注意排线金手指的方向通常有颜色的一边朝向USB口方向。打开锁扣PCIe连接器通常有一个黑色的翻盖锁扣。用指甲或镊子轻轻将其向上翻起至垂直状态。插入排线将排线金手指部分平稳、完全地插入插座底部。锁紧锁扣将黑色锁扣轻轻按回水平位置听到轻微响声排线即被牢牢锁住。切忌在锁扣打开时通电整体堆叠与固定将已经连接好PCIe排线的树莓派5像“三明治”一样对准UPS板上的四个铜柱放下。从树莓派5的板子背面即没有元件的一面穿过其四个固定孔放入长螺丝。在树莓派5的正面将尼龙隔离柱套在长螺丝上然后整体向下拧紧固定在UPS板的铜柱上。这样树莓派5和PCIe扩展板就被一起固定在了UPS板之上。最后将PCIe扩展板附带的另一条短排线连接其自身的另一个接口用于连接第二个M.2盘暂时整理好即可。安装电池根据UPS板上的正负极标识/-放入两节18650电池。确保电池带保护板的一端通常为正极朝向正确。放入时应感到有轻微的弹簧压力。3.3 第三步装入机箱与最终整理预安装存储在将整个“三明治”放入机箱前先把M.2 SSD装上。拧开PCIe扩展板上的固定螺丝以约30度角插入SSD然后下压并用螺丝固定。螺丝不要拧得过紧感受到阻力后再稍加一点力即可防止损坏SSD或螺孔。整体入箱小心地将组装好的整个模块滑入机箱下半部分。对准机箱底部的螺丝孔位用机箱附带的短螺丝将整个模块固定住。理线与盖盖将PCIe排线、风扇电源线等妥善整理用扎带或胶布固定避免干扰风扇或产生噪音。最后盖上机箱上盖并拧紧螺丝。连接外部设备插入已经烧录好系统的MicroSD卡连接网线最后连接USB-C电源。上电前最终检查清单[ ] 18650电池极性是否正确[ ] 所有排线连接器锁扣是否扣紧[ ] M.2 SSD是否安装牢固[ ] 散热器风扇线是否连接[ ] 机箱内有无脱落的螺丝或金属碎屑4. 系统软件安装与基础配置硬件组装完毕我们开始注入灵魂。我们的目标是安装一个无图形界面的、精简高效的操作系统然后在其上部署NAS管理软件。4.1 刷写 Raspberry Pi OS Lite我们选择Raspberry Pi OS (Legacy, 64-bit) Lite版本。这个版本基于 Debian Bookworm没有臃肿的桌面环境更节省资源且系统成熟稳定。使用 Raspberry Pi Imager在另一台电脑上下载并安装官方的 Raspberry Pi Imager。插入 MicroSD 卡在 Imager 中选择操作系统Raspberry Pi OS (other)-Raspberry Pi OS (Legacy, 64-bit) Lite。关键步骤点击右下角的齿轮图标进行高级设置Set hostname: 给你的树莓派起个名字如raspberrypi5-nas。Enable SSH:务必勾选并选择“Use password authentication”设置一个强密码。Set username and password: 设置一个非pi的用户名如admin和强密码提升安全性。Configure wireless LAN: 虽然建议用网线但可以先配置好Wi-Fi作为备用。Set locale settings: 设置时区如Asia/Shanghai。选择你的 MicroSD 卡作为存储设备点击“写入”。完成后安全弹出卡片。首次启动与SSH连接将 MicroSD 卡插入树莓派接通电源和网线。在你的电脑上需要找到树莓派的IP地址。有几种方法路由器后台查看登录你家路由器的管理页面通常是192.168.1.1在“已连接设备”或“DHCP客户端列表”里找主机名raspberrypi5-nas。使用扫描工具在电脑上用arp -aWindows或nmap -sn 192.168.1.0/24Linux/macOS扫描局域网。打开终端Windows 可用 PowerShell 或 WSL2使用 SSH 连接ssh admin192.168.1.100 # 将 admin 和 IP 替换成你实际设置的首次连接会提示确认主机密钥输入yes然后输入密码即可进入树莓派的命令行界面。4.2 启用PCIe接口并挂载M.2 SSD这是让树莓派5识别NVMe硬盘的关键一步。编辑引导配置文件sudo nano /boot/firmware/config.txt在文件末尾添加一行dtparampciex1按CtrlX然后按Y再按Enter保存退出。重启并检查sudo reboot等待重启后重新SSH登录使用以下命令检查PCIe设备和NVMe硬盘是否被识别# 查看PCIe设备 lspci # 你应该能看到类似 “.... NVMe ....” 的设备信息 # 查看块设备 lsblk如果一切正常lsblk命令的输出中除了mmcblk0你的SD卡还会出现一个新的设备比如nvme0n1。这就是你的M.2 SSD。分区与格式化假设你的NVMe设备是/dev/nvme0n1。使用fdisk或parted工具进行分区。这里以创建一个单分区为例sudo fdisk /dev/nvme0n1输入g创建一个新的GPT分区表。输入n创建新分区一路回车使用默认值整个磁盘。输入w写入并退出。格式化分区为 ext4 文件系统适合NASsudo mkfs.ext4 /dev/nvme0n1p1注意ext4是稳定通用的选择。如果你需要快照等高级功能可以考虑btrfs或zfs但这需要更多内存和配置知识。创建挂载点并设置开机自动挂载# 创建挂载目录 sudo mkdir -p /mnt/nvme_storage # 临时挂载测试 sudo mount /dev/nvme0n1p1 /mnt/nvme_storage # 获取分区的UUID sudo blkid | grep nvme0n1p1 # 编辑fstab实现开机自动挂载 sudo nano /etc/fstab在/etc/fstab文件末尾添加一行将UUIDxxxx替换为上一步命令输出的实际UUIDUUID你的NVMe分区UUID /mnt/nvme_storage ext4 defaults,nofail 0 2nofail参数很重要即使启动时硬盘未就绪系统也能继续启动。4.3 安装与配置 OpenMediaVault (OMV)OMV是一个专为NAS设计的、基于Web管理的开源操作系统但它也可以作为Debian上的一个软件包安装这正是我们需要的。一键安装脚本 OMV社区提供了非常方便的安装脚本。在SSH中执行wget -O - https://github.com/OpenMediaVault-Plugin-Developers/installScript/raw/master/install | sudo bash这个命令会下载并运行安装脚本。整个过程会持续10-30分钟取决于网络速度。脚本会自动添加软件源、安装所有依赖和OMV核心包。访问Web管理界面 安装完成后在你的电脑浏览器中输入树莓派的IP地址如http://192.168.1.100。默认用户名admin默认密码openmediavault首次登录后必须立即修改密码OMV基础配置流程 OMV的配置逻辑非常清晰遵循“先定义存储再配置服务最后设置访问权限”的流程。a. 挂载文件系统 进入Storage - File Systems。你应该能看到一个“未挂载”的文件系统这就是我们之前格式化的NVMe分区。选中它点击“挂载”然后点击“应用”按钮OMV的任何配置更改都需要点击页面顶部的“应用”才会生效。b. 创建共享文件夹 进入Storage - Shared Folders。点击“创建”。Name: 给共享文件夹起名如Media。File system: 选择你刚刚挂载的NVMe分区。Relative path: 填写文件夹名称如/media。Permissions: 根据需求设置可以先保持默认。 点击“保存”然后“应用”。c. 启用SMB/CIFS服务用于Windows/Mac/局域网访问 进入Services - SMB/CIFS - Settings先启用服务。 然后进入Shares标签页点击“添加”。选择你刚才创建的共享文件夹如Media设置一个公开的“共享名”如Media并配置访问权限如“来宾允许”或需要用户名密码。点击“保存”然后回到“Settings”页点击“应用”。d. 设置用户权限可选但推荐 进入Users - Users可以创建新的用户如family并为其设置密码。 进入Users - Groups可以创建用户组如nas_users并将用户加入。 最后回到Storage - Shared Folders编辑你创建的共享文件夹在“权限”选项卡里为你创建的用户或组设置读写权限。至此你的NAS已经可以通过网络访问了。在Windows文件资源管理器的地址栏输入\\192.168.1.100或者在Mac的Finder中选择“前往 - 连接服务器”输入smb://192.168.1.100就能看到共享的文件夹了。5. UPS断电保护功能配置与测试硬件UPS板已经能实现断电供电但一个完整的UPS方案还需要软件配合实现“电量低时自动安全关机”这才是数据安全的最后一道保险。5.1 原理与接线Geekworm X1201 UPS板提供了两个GPIO信号POWER-HOLD (PH) 引脚当电池供电时此引脚输出高电平约3.3V。LOW-BATTERY (LB) 引脚当电池电压低于设定阈值如3.1V时此引脚输出高电平。我们需要用杜邦线将这些信号引脚连接到树莓派5的GPIO针脚上以便系统读取状态。接线参考请务必以你购买的UPS板说明书为准UPS板PH引脚 - 树莓派 GPIO 17 (Pin 11)UPS板LB引脚 - 树莓派 GPIO 27 (Pin 13)UPS板GND引脚 - 树莓派任意 GND (如 Pin 9)5.2 安装监控脚本我们需要一个后台服务来持续监控这两个GPIO引脚的状态。安装必要的软件包sudo apt update sudo apt install python3-gpiozero -y创建监控脚本sudo nano /usr/local/bin/ups_monitor.py将以下Python脚本内容粘贴进去根据你的实际接线修改power_hold_pin和low_battery_pin的编号#!/usr/bin/env python3 import time import subprocess from gpiozero import Button from signal import pause # 根据你的接线修改引脚编号 (BCM编号) power_hold_pin 17 # 对应GPIO 17 low_battery_pin 27 # 对应GPIO 27 # 定义触发动作的函数 def on_power_loss(): print(检测到市电断开正在由电池供电。) # 可以在这里触发一些轻量级操作比如发送通知 # 例如: subprocess.run([wall, 警告NAS正在使用电池供电]) def on_battery_low(): print(电池电量低准备安全关机。) # 执行关机命令给系统留出30秒时间同步数据并关闭服务 subprocess.run([sudo, shutdown, -h, 1, 电池电量低系统即将关机。]) # 关机前等待一段时间确保命令已发出 time.sleep(120) # 等待2分钟然后强制关机如果正常关机未完成 subprocess.run([sudo, halt]) # 使用gpiozero库设置引脚为输入并指定触发回调函数 # 当引脚变为高电平时即按钮“按下”触发函数 power_hold_btn Button(power_hold_pin, pull_upFalse) # UPS板信号高电平有效所以pull_upFalse low_battery_btn Button(low_battery_pin, pull_upFalse) # 绑定事件 power_hold_btn.when_pressed on_power_loss low_battery_btn.when_pressed on_battery_low print(UPS监控脚本已启动。正在监听GPIO状态...) # 保持脚本运行 pause()按CtrlX,Y,Enter保存退出。赋予脚本执行权限sudo chmod x /usr/local/bin/ups_monitor.py创建系统服务让脚本开机自启sudo nano /etc/systemd/system/ups-monitor.service粘贴以下内容[Unit] DescriptionUPS Monitor Service Aftermulti-user.target [Service] Typesimple ExecStart/usr/bin/python3 /usr/local/bin/ups_monitor.py Restarton-failure Userroot [Install] WantedBymulti-user.target启用并启动服务sudo systemctl daemon-reload sudo systemctl enable ups-monitor.service sudo systemctl start ups-monitor.service # 检查服务状态 sudo systemctl status ups-monitor.service5.3 功能测试安全测试请确保你的NAS没有在执行重要任务。模拟断电直接拔掉树莓派的USB-C电源线。观察现象树莓派应继续运行毫无间断。此时通过SSH登录如果网络交换机也有备用电源执行cat /sys/class/gpio/gpio17/value假设接GPIO17应该会返回1高电平。模拟低电量此操作有风险仅作原理说明。通常UPS板的低电量阈值是固定的。更安全的测试方法是你可以暂时修改脚本将low_battery_pin临时接到一个手动控制的开关或另一根高电平引脚上模拟低电平信号观察关机命令是否被触发。恢复供电重新插上电源系统应继续正常运行脚本会检测到POWER-HOLD引脚恢复低电平。6. 进阶优化与维护指南系统搭建完成只是开始长期稳定运行需要一些优化和维护。6.1 性能与稳定性调优SD卡寿命保护系统日志频繁写入会损耗SD卡。可以将日志转移到内存中。sudo nano /etc/fstab添加一行tmpfs /tmp tmpfs defaults,noatime,nosuid,size128M 0 0 tmpfs /var/log tmpfs defaults,noatime,nosuid,size64M 0 0注意这会导致重启后日志丢失适合家庭稳定环境。如需查日志可改用journalctl。网络优化确保树莓派使用静态IP或DHCP保留IP避免IP变化导致访问中断。在路由器中为树莓派的MAC地址分配固定IP。散热风扇控制如果风扇噪音大可以安装fancontrol等工具进行温控调速。更简单的方法是使用gpiozero写一个简单的Python脚本根据/sys/class/thermal/thermal_zone0/temp文件读取的温度值来控制连接风扇的GPIO引脚输出PWM信号。6.2 数据备份与安全启用OMV的定时备份插件在OMV的插件管理中可以安装“rsync”或“BorgBackup”插件设置将重要共享文件夹定时备份到另一块USB移动硬盘甚至加密备份到云端如Backblaze B2。SMART监控在OMV的“存储 - S.M.A.R.T.”中为你的NVMe SSD启用定期自检和监控设置邮件报警以便在硬盘出现早期故障征兆时收到通知。定期更新定期通过SSH运行sudo apt update sudo apt upgrade来更新系统和OMV软件包修复安全漏洞。6.3 常见问题与排查实录即使按照步骤操作也可能会遇到一些坑。这里记录几个我实际遇到过的典型问题问题1启动后找不到NVMe硬盘 (lsblk里没有nvme0n1)。排查首先运行sudo dmesg | grep -i pcie和sudo dmesg | grep -i nvme查看内核启动信息中是否有PCIe或NVMe相关的错误。解决确认/boot/firmware/config.txt中dtparampciex1已添加且拼写正确。检查PCIe排线是否插紧锁扣是否扣好。尝试重新插拔。尝试更换另一个M.2插槽如果扩展板有多个。有些NVMe SSD兼容性可能有问题查阅树莓派论坛看看你的SSD型号是否在兼容列表里。问题2OMV Web界面无法访问。排查在树莓派上运行sudo systemctl status openmediavault-engined查看OMV引擎服务是否正常运行。解决尝试重启OMV引擎sudo systemctl restart openmediavault-engined。检查防火墙OMV默认会配置防火墙。如果你在本地网络访问确保没有其他防火墙规则阻止。可以暂时禁用OMV防火墙测试在OMV Web界面“系统 - 工作台”查看是否有错误信息。清除浏览器缓存或换一个浏览器试试。问题3网络传输速度远低于千兆低于100MB/s。排查在树莓派上使用iperf3工具测试内网带宽。在客户端也安装iperf3在树莓派上运行iperf3 -s在客户端运行iperf3 -c看带宽是否能达到900Mbps以上。解决更换网线确保使用的是超五类Cat 5e或以上标准的网线。检查路由器/交换机的端口是否是千兆口。在OMV的SMB/CIFS服务设置中尝试启用“AIOL”和“WSDD”选项有时能提升性能。问题4UPS监控脚本不触发。排查运行sudo systemctl status ups-monitor.service查看服务是否运行。运行sudo journalctl -u ups-monitor.service -f查看实时日志。用万用表测量UPS板的PH和LB引脚在断电和电池低压时的实际电压确认信号输出正常。解决检查GPIO接线是否正确、牢固。确认脚本中使用的GPIO引脚编号BCM编号与实际接线一致。检查脚本中pull_upFalse的设置是否与你的UPS板信号逻辑匹配高电平有效通常为False。搭建这样一套系统最深的体会就是“细节决定成败”。从拧紧每一颗螺丝到每一行配置代码都关乎着未来几年里数据的安全与访问的顺畅。它可能没有成品NAS那样华丽的界面和开箱即用的便利但每一个组件、每一项功能都完全在你的掌控之下这种成就感和后期无限的可定制性才是DIY最大的乐趣。当你在家中任何设备上流畅播放NAS里的4K电影或者手机照片自动备份到私有空间时你会觉得这一切的折腾都是值得的。如果遇到问题树莓派和OMV都有非常活跃的社区绝大多数坑都有前人的解决方案。
基于树莓派5打造高可靠家庭NAS：UPS断电保护与NVMe高速存储方案
1. 项目概述与核心价值折腾家庭存储这事儿我估计不少技术爱好者都琢磨过。从最早用旧电脑装个黑群晖到后来各种成品NAS再到如今用树莓派这类单板电脑自己搭建玩法是越来越多了。这次我分享的是基于树莓派5打造的一台自带“小电瓶”UPS不间断电源和高速M.2固态硬盘的NAS系统。这玩意儿说白了就是一台放在你家角落、24小时开机的私人数据服务器你的手机、电脑、电视都能直接访问它里面的电影、照片、文档还能自动备份重要数据。为什么选树莓派5相比上一代它的性能提升是实打实的更快的CPU、支持PCIe 2.0接口这意味着我们可以通过扩展板直接接上NVMe协议的M.2固态硬盘摆脱了以往树莓派存储只能依赖USB或SD卡的带宽瓶颈。而给它加上UPS不间断电源板子则是为了解决家庭环境一个非常实际的痛点——意外断电。你肯定不想正在往NAS里拷贝重要文件或者它正在执行定时备份任务时突然停电导致系统崩溃甚至硬盘损坏吧这套方案的核心价值就是在极致的性价比和DIY乐趣之上增加了数据安全和存储性能这两个关键维度让它从一个“玩具级”的存储方案变得更可靠、更实用足以承担家庭核心数据仓库的角色。2. 硬件选型与设计思路拆解自己搭NAS硬件是地基。选对配件不仅关系到最终性能更决定了搭建过程的顺利程度和长期运行的稳定性。我的整体思路是以树莓派5为核心计算单元通过专用扩展板HAT来补足其原生接口的短板最后用一个设计合理的机箱把所有东西规整地装起来兼顾散热与美观。2.1 核心计算单元为什么是树莓派5树莓派5是目前树莓派家族中的性能担当。对于NAS应用几个关键升级点让它脱颖而出PCIe 2.0 x1接口这是本次项目的灵魂。虽然带宽只有约500MB/s理论值但足以让NVMe SSD发挥出远超千兆网络约113MB/s的本地读写速度为未来升级2.5G甚至更高速度的网络预留了性能空间同时大幅降低存储延迟。更强的CPU与内存其ARM Cortex-A76架构处理器应对文件共享、Docker容器、轻量级转码等NAS常见任务游刃有余。建议起步选择4GB或8GB内存版本为系统和服务留出充足余量。双HDMI与供电改进调试更方便且支持PD协议的USB-C供电更稳定。注意树莓派5的PCIe接口默认并未启用需要在系统配置中手动开启。这是后续软件设置中的一个关键步骤我会在实操部分详细说明。2.2 存储扩展方案PCIe to Dual M.2 HAT直接使用树莓派5的PCIe接口连接M.2 SSD是提升存储性能的关键。我选用的是Geekworm X1004这类扩展板。它的设计考量很明确双盘位设计允许你配置RAID 1镜像以实现数据冗余一块硬盘故障数据不丢或者配置RAID 0条带化以获得更大的聚合带宽和容量。对于家庭用户我更推荐单盘使用或RAID 1数据安全第一。免驱兼容性在Linux系统下NVMe SSD通常是即插即用的大大简化了配置。物理连接通过一条柔软的FPC排线连接到树莓派5的PCIe引脚并由扩展板本身的螺丝柱固定结构稳固。为什么不直接用USB硬盘盒USB 3.0接口虽然方便且理论速度5Gbps也够用但其共享总线带宽、依赖USB-SATA桥接芯片的特性会引入额外的延迟和兼容性问题。对于需要7x24小时运行、频繁读写的NAS系统直连PCIe在稳定性、延迟和CPU占用率上都有显著优势。2.3 电力保障核心超薄UPS扩展板断电保护是NAS从“可用”到“可靠”的质变。我选择的是Geekworm X1201这类专为树莓派5设计的超薄UPS板。它的工作原理是双路供电自动切换板子同时接入外部5V电源如原装电源和两节并联的18650锂电池。有外部电源时由外部电源供电并同时为电池充电。无缝切换当外部电源断开停电或拔插头板载电路会在毫秒级时间内无缝切换至电池供电树莓派完全感知不到断电持续运行。安全关机信号更高级的功能是UPS板可以通过GPIO引脚向树莓派发送“电池供电”和“电池电量低”信号。我们可以编写脚本让树莓派在检测到电池供电且电量即将耗尽时自动执行安全关机流程避免数据损坏。关于18650电池的选择 这不是普通的五号电池。务必选择带有“保护板”的动力型18650锂电池如一些知名品牌的3100mAh、3500mAh产品。保护板能防止过充、过放和短路安全第一。电池容量决定了断电后的续航时间以树莓派5满载约10W功耗计算两节3400mAh电池约24Wh大约能提供2小时以上的续航足够完成安全关机。2.4 散热与机箱安静与稳定的守护者树莓派5的功耗和发热比前代高主动散热几乎是必须的。Geekworm H505这类带风扇的散热器通过导热垫直接接触SoC和内存芯片能有效控制温度。风扇策略建议在系统中将风扇设置为温控模式例如温度超过50°C时启动避免一直全速运转产生噪音。机箱选择Geekworm X1201-C1这类金属机箱与UPS板、散热器是配套设计的。金属机箱有助于被动散热同时为所有堆叠的板卡和电池提供了坚固的保护和电磁屏蔽。良好的风道设计如侧面开孔也能辅助散热。3. 硬件组装与布线实操要点组装过程像搭积木但顺序和细节决定成败。核心原则是先连接再固定先测试再封装。3.1 第一步安装主动散热器清洁芯片表面用高纯度异丙醇或无水酒精和无尘布轻轻擦拭树莓派5上CPU最大的那个芯片和内存芯片CPU旁边的几个小芯片表面确保没有油污和灰尘。这是保证导热垫良好接触的关键。粘贴导热垫散热器配套的导热垫通常已预先切割好。撕掉一侧的保护膜将其精准覆盖在需要散热的芯片上然后轻轻按压使其粘牢。注意不要有气泡或褶皱。安装散热器本体将散热器对准位置放下确保其底部的导热部分完全覆盖所有导热垫。然后均匀用力按下四个角落的固定卡扣听到清脆的“咔嗒”声表示已锁紧。用手轻轻摇晃检查是否牢固。实操心得有些散热器的固定卡扣非常紧安装时最好将树莓派放在一个平整、柔软的表面上如鼠标垫用指腹垂直向下均匀发力避免因受力不均导致主板弯曲。3.2 第二步堆叠UPS板与PCIe扩展板这是最核心的硬件连接步骤顺序很重要。准备UPS板将带螺纹的铜柱拧在UPS板正面即有电子元件和电池触点的这一面的四个角上。这面将来会朝向树莓派。将不带螺纹的尼龙隔离柱用附带的小螺丝固定在UPS板背面的对应位置。这面用来放置18650电池。这个设计目的是用铜柱连接上层的树莓派用尼龙柱隔离下层的金属电池触点防止短路。连接PCIe扩展板与树莓派先对准再下压将PCIe扩展板X1004的排线插座与树莓派5板载的PCIe连接器位于USB口旁边一个很小的白色插座仔细对准。注意排线金手指的方向通常有颜色的一边朝向USB口方向。打开锁扣PCIe连接器通常有一个黑色的翻盖锁扣。用指甲或镊子轻轻将其向上翻起至垂直状态。插入排线将排线金手指部分平稳、完全地插入插座底部。锁紧锁扣将黑色锁扣轻轻按回水平位置听到轻微响声排线即被牢牢锁住。切忌在锁扣打开时通电整体堆叠与固定将已经连接好PCIe排线的树莓派5像“三明治”一样对准UPS板上的四个铜柱放下。从树莓派5的板子背面即没有元件的一面穿过其四个固定孔放入长螺丝。在树莓派5的正面将尼龙隔离柱套在长螺丝上然后整体向下拧紧固定在UPS板的铜柱上。这样树莓派5和PCIe扩展板就被一起固定在了UPS板之上。最后将PCIe扩展板附带的另一条短排线连接其自身的另一个接口用于连接第二个M.2盘暂时整理好即可。安装电池根据UPS板上的正负极标识/-放入两节18650电池。确保电池带保护板的一端通常为正极朝向正确。放入时应感到有轻微的弹簧压力。3.3 第三步装入机箱与最终整理预安装存储在将整个“三明治”放入机箱前先把M.2 SSD装上。拧开PCIe扩展板上的固定螺丝以约30度角插入SSD然后下压并用螺丝固定。螺丝不要拧得过紧感受到阻力后再稍加一点力即可防止损坏SSD或螺孔。整体入箱小心地将组装好的整个模块滑入机箱下半部分。对准机箱底部的螺丝孔位用机箱附带的短螺丝将整个模块固定住。理线与盖盖将PCIe排线、风扇电源线等妥善整理用扎带或胶布固定避免干扰风扇或产生噪音。最后盖上机箱上盖并拧紧螺丝。连接外部设备插入已经烧录好系统的MicroSD卡连接网线最后连接USB-C电源。上电前最终检查清单[ ] 18650电池极性是否正确[ ] 所有排线连接器锁扣是否扣紧[ ] M.2 SSD是否安装牢固[ ] 散热器风扇线是否连接[ ] 机箱内有无脱落的螺丝或金属碎屑4. 系统软件安装与基础配置硬件组装完毕我们开始注入灵魂。我们的目标是安装一个无图形界面的、精简高效的操作系统然后在其上部署NAS管理软件。4.1 刷写 Raspberry Pi OS Lite我们选择Raspberry Pi OS (Legacy, 64-bit) Lite版本。这个版本基于 Debian Bookworm没有臃肿的桌面环境更节省资源且系统成熟稳定。使用 Raspberry Pi Imager在另一台电脑上下载并安装官方的 Raspberry Pi Imager。插入 MicroSD 卡在 Imager 中选择操作系统Raspberry Pi OS (other)-Raspberry Pi OS (Legacy, 64-bit) Lite。关键步骤点击右下角的齿轮图标进行高级设置Set hostname: 给你的树莓派起个名字如raspberrypi5-nas。Enable SSH:务必勾选并选择“Use password authentication”设置一个强密码。Set username and password: 设置一个非pi的用户名如admin和强密码提升安全性。Configure wireless LAN: 虽然建议用网线但可以先配置好Wi-Fi作为备用。Set locale settings: 设置时区如Asia/Shanghai。选择你的 MicroSD 卡作为存储设备点击“写入”。完成后安全弹出卡片。首次启动与SSH连接将 MicroSD 卡插入树莓派接通电源和网线。在你的电脑上需要找到树莓派的IP地址。有几种方法路由器后台查看登录你家路由器的管理页面通常是192.168.1.1在“已连接设备”或“DHCP客户端列表”里找主机名raspberrypi5-nas。使用扫描工具在电脑上用arp -aWindows或nmap -sn 192.168.1.0/24Linux/macOS扫描局域网。打开终端Windows 可用 PowerShell 或 WSL2使用 SSH 连接ssh admin192.168.1.100 # 将 admin 和 IP 替换成你实际设置的首次连接会提示确认主机密钥输入yes然后输入密码即可进入树莓派的命令行界面。4.2 启用PCIe接口并挂载M.2 SSD这是让树莓派5识别NVMe硬盘的关键一步。编辑引导配置文件sudo nano /boot/firmware/config.txt在文件末尾添加一行dtparampciex1按CtrlX然后按Y再按Enter保存退出。重启并检查sudo reboot等待重启后重新SSH登录使用以下命令检查PCIe设备和NVMe硬盘是否被识别# 查看PCIe设备 lspci # 你应该能看到类似 “.... NVMe ....” 的设备信息 # 查看块设备 lsblk如果一切正常lsblk命令的输出中除了mmcblk0你的SD卡还会出现一个新的设备比如nvme0n1。这就是你的M.2 SSD。分区与格式化假设你的NVMe设备是/dev/nvme0n1。使用fdisk或parted工具进行分区。这里以创建一个单分区为例sudo fdisk /dev/nvme0n1输入g创建一个新的GPT分区表。输入n创建新分区一路回车使用默认值整个磁盘。输入w写入并退出。格式化分区为 ext4 文件系统适合NASsudo mkfs.ext4 /dev/nvme0n1p1注意ext4是稳定通用的选择。如果你需要快照等高级功能可以考虑btrfs或zfs但这需要更多内存和配置知识。创建挂载点并设置开机自动挂载# 创建挂载目录 sudo mkdir -p /mnt/nvme_storage # 临时挂载测试 sudo mount /dev/nvme0n1p1 /mnt/nvme_storage # 获取分区的UUID sudo blkid | grep nvme0n1p1 # 编辑fstab实现开机自动挂载 sudo nano /etc/fstab在/etc/fstab文件末尾添加一行将UUIDxxxx替换为上一步命令输出的实际UUIDUUID你的NVMe分区UUID /mnt/nvme_storage ext4 defaults,nofail 0 2nofail参数很重要即使启动时硬盘未就绪系统也能继续启动。4.3 安装与配置 OpenMediaVault (OMV)OMV是一个专为NAS设计的、基于Web管理的开源操作系统但它也可以作为Debian上的一个软件包安装这正是我们需要的。一键安装脚本 OMV社区提供了非常方便的安装脚本。在SSH中执行wget -O - https://github.com/OpenMediaVault-Plugin-Developers/installScript/raw/master/install | sudo bash这个命令会下载并运行安装脚本。整个过程会持续10-30分钟取决于网络速度。脚本会自动添加软件源、安装所有依赖和OMV核心包。访问Web管理界面 安装完成后在你的电脑浏览器中输入树莓派的IP地址如http://192.168.1.100。默认用户名admin默认密码openmediavault首次登录后必须立即修改密码OMV基础配置流程 OMV的配置逻辑非常清晰遵循“先定义存储再配置服务最后设置访问权限”的流程。a. 挂载文件系统 进入Storage - File Systems。你应该能看到一个“未挂载”的文件系统这就是我们之前格式化的NVMe分区。选中它点击“挂载”然后点击“应用”按钮OMV的任何配置更改都需要点击页面顶部的“应用”才会生效。b. 创建共享文件夹 进入Storage - Shared Folders。点击“创建”。Name: 给共享文件夹起名如Media。File system: 选择你刚刚挂载的NVMe分区。Relative path: 填写文件夹名称如/media。Permissions: 根据需求设置可以先保持默认。 点击“保存”然后“应用”。c. 启用SMB/CIFS服务用于Windows/Mac/局域网访问 进入Services - SMB/CIFS - Settings先启用服务。 然后进入Shares标签页点击“添加”。选择你刚才创建的共享文件夹如Media设置一个公开的“共享名”如Media并配置访问权限如“来宾允许”或需要用户名密码。点击“保存”然后回到“Settings”页点击“应用”。d. 设置用户权限可选但推荐 进入Users - Users可以创建新的用户如family并为其设置密码。 进入Users - Groups可以创建用户组如nas_users并将用户加入。 最后回到Storage - Shared Folders编辑你创建的共享文件夹在“权限”选项卡里为你创建的用户或组设置读写权限。至此你的NAS已经可以通过网络访问了。在Windows文件资源管理器的地址栏输入\\192.168.1.100或者在Mac的Finder中选择“前往 - 连接服务器”输入smb://192.168.1.100就能看到共享的文件夹了。5. UPS断电保护功能配置与测试硬件UPS板已经能实现断电供电但一个完整的UPS方案还需要软件配合实现“电量低时自动安全关机”这才是数据安全的最后一道保险。5.1 原理与接线Geekworm X1201 UPS板提供了两个GPIO信号POWER-HOLD (PH) 引脚当电池供电时此引脚输出高电平约3.3V。LOW-BATTERY (LB) 引脚当电池电压低于设定阈值如3.1V时此引脚输出高电平。我们需要用杜邦线将这些信号引脚连接到树莓派5的GPIO针脚上以便系统读取状态。接线参考请务必以你购买的UPS板说明书为准UPS板PH引脚 - 树莓派 GPIO 17 (Pin 11)UPS板LB引脚 - 树莓派 GPIO 27 (Pin 13)UPS板GND引脚 - 树莓派任意 GND (如 Pin 9)5.2 安装监控脚本我们需要一个后台服务来持续监控这两个GPIO引脚的状态。安装必要的软件包sudo apt update sudo apt install python3-gpiozero -y创建监控脚本sudo nano /usr/local/bin/ups_monitor.py将以下Python脚本内容粘贴进去根据你的实际接线修改power_hold_pin和low_battery_pin的编号#!/usr/bin/env python3 import time import subprocess from gpiozero import Button from signal import pause # 根据你的接线修改引脚编号 (BCM编号) power_hold_pin 17 # 对应GPIO 17 low_battery_pin 27 # 对应GPIO 27 # 定义触发动作的函数 def on_power_loss(): print(检测到市电断开正在由电池供电。) # 可以在这里触发一些轻量级操作比如发送通知 # 例如: subprocess.run([wall, 警告NAS正在使用电池供电]) def on_battery_low(): print(电池电量低准备安全关机。) # 执行关机命令给系统留出30秒时间同步数据并关闭服务 subprocess.run([sudo, shutdown, -h, 1, 电池电量低系统即将关机。]) # 关机前等待一段时间确保命令已发出 time.sleep(120) # 等待2分钟然后强制关机如果正常关机未完成 subprocess.run([sudo, halt]) # 使用gpiozero库设置引脚为输入并指定触发回调函数 # 当引脚变为高电平时即按钮“按下”触发函数 power_hold_btn Button(power_hold_pin, pull_upFalse) # UPS板信号高电平有效所以pull_upFalse low_battery_btn Button(low_battery_pin, pull_upFalse) # 绑定事件 power_hold_btn.when_pressed on_power_loss low_battery_btn.when_pressed on_battery_low print(UPS监控脚本已启动。正在监听GPIO状态...) # 保持脚本运行 pause()按CtrlX,Y,Enter保存退出。赋予脚本执行权限sudo chmod x /usr/local/bin/ups_monitor.py创建系统服务让脚本开机自启sudo nano /etc/systemd/system/ups-monitor.service粘贴以下内容[Unit] DescriptionUPS Monitor Service Aftermulti-user.target [Service] Typesimple ExecStart/usr/bin/python3 /usr/local/bin/ups_monitor.py Restarton-failure Userroot [Install] WantedBymulti-user.target启用并启动服务sudo systemctl daemon-reload sudo systemctl enable ups-monitor.service sudo systemctl start ups-monitor.service # 检查服务状态 sudo systemctl status ups-monitor.service5.3 功能测试安全测试请确保你的NAS没有在执行重要任务。模拟断电直接拔掉树莓派的USB-C电源线。观察现象树莓派应继续运行毫无间断。此时通过SSH登录如果网络交换机也有备用电源执行cat /sys/class/gpio/gpio17/value假设接GPIO17应该会返回1高电平。模拟低电量此操作有风险仅作原理说明。通常UPS板的低电量阈值是固定的。更安全的测试方法是你可以暂时修改脚本将low_battery_pin临时接到一个手动控制的开关或另一根高电平引脚上模拟低电平信号观察关机命令是否被触发。恢复供电重新插上电源系统应继续正常运行脚本会检测到POWER-HOLD引脚恢复低电平。6. 进阶优化与维护指南系统搭建完成只是开始长期稳定运行需要一些优化和维护。6.1 性能与稳定性调优SD卡寿命保护系统日志频繁写入会损耗SD卡。可以将日志转移到内存中。sudo nano /etc/fstab添加一行tmpfs /tmp tmpfs defaults,noatime,nosuid,size128M 0 0 tmpfs /var/log tmpfs defaults,noatime,nosuid,size64M 0 0注意这会导致重启后日志丢失适合家庭稳定环境。如需查日志可改用journalctl。网络优化确保树莓派使用静态IP或DHCP保留IP避免IP变化导致访问中断。在路由器中为树莓派的MAC地址分配固定IP。散热风扇控制如果风扇噪音大可以安装fancontrol等工具进行温控调速。更简单的方法是使用gpiozero写一个简单的Python脚本根据/sys/class/thermal/thermal_zone0/temp文件读取的温度值来控制连接风扇的GPIO引脚输出PWM信号。6.2 数据备份与安全启用OMV的定时备份插件在OMV的插件管理中可以安装“rsync”或“BorgBackup”插件设置将重要共享文件夹定时备份到另一块USB移动硬盘甚至加密备份到云端如Backblaze B2。SMART监控在OMV的“存储 - S.M.A.R.T.”中为你的NVMe SSD启用定期自检和监控设置邮件报警以便在硬盘出现早期故障征兆时收到通知。定期更新定期通过SSH运行sudo apt update sudo apt upgrade来更新系统和OMV软件包修复安全漏洞。6.3 常见问题与排查实录即使按照步骤操作也可能会遇到一些坑。这里记录几个我实际遇到过的典型问题问题1启动后找不到NVMe硬盘 (lsblk里没有nvme0n1)。排查首先运行sudo dmesg | grep -i pcie和sudo dmesg | grep -i nvme查看内核启动信息中是否有PCIe或NVMe相关的错误。解决确认/boot/firmware/config.txt中dtparampciex1已添加且拼写正确。检查PCIe排线是否插紧锁扣是否扣好。尝试重新插拔。尝试更换另一个M.2插槽如果扩展板有多个。有些NVMe SSD兼容性可能有问题查阅树莓派论坛看看你的SSD型号是否在兼容列表里。问题2OMV Web界面无法访问。排查在树莓派上运行sudo systemctl status openmediavault-engined查看OMV引擎服务是否正常运行。解决尝试重启OMV引擎sudo systemctl restart openmediavault-engined。检查防火墙OMV默认会配置防火墙。如果你在本地网络访问确保没有其他防火墙规则阻止。可以暂时禁用OMV防火墙测试在OMV Web界面“系统 - 工作台”查看是否有错误信息。清除浏览器缓存或换一个浏览器试试。问题3网络传输速度远低于千兆低于100MB/s。排查在树莓派上使用iperf3工具测试内网带宽。在客户端也安装iperf3在树莓派上运行iperf3 -s在客户端运行iperf3 -c看带宽是否能达到900Mbps以上。解决更换网线确保使用的是超五类Cat 5e或以上标准的网线。检查路由器/交换机的端口是否是千兆口。在OMV的SMB/CIFS服务设置中尝试启用“AIOL”和“WSDD”选项有时能提升性能。问题4UPS监控脚本不触发。排查运行sudo systemctl status ups-monitor.service查看服务是否运行。运行sudo journalctl -u ups-monitor.service -f查看实时日志。用万用表测量UPS板的PH和LB引脚在断电和电池低压时的实际电压确认信号输出正常。解决检查GPIO接线是否正确、牢固。确认脚本中使用的GPIO引脚编号BCM编号与实际接线一致。检查脚本中pull_upFalse的设置是否与你的UPS板信号逻辑匹配高电平有效通常为False。搭建这样一套系统最深的体会就是“细节决定成败”。从拧紧每一颗螺丝到每一行配置代码都关乎着未来几年里数据的安全与访问的顺畅。它可能没有成品NAS那样华丽的界面和开箱即用的便利但每一个组件、每一项功能都完全在你的掌控之下这种成就感和后期无限的可定制性才是DIY最大的乐趣。当你在家中任何设备上流畅播放NAS里的4K电影或者手机照片自动备份到私有空间时你会觉得这一切的折腾都是值得的。如果遇到问题树莓派和OMV都有非常活跃的社区绝大多数坑都有前人的解决方案。
