烧录树莓派:图文步骤

面向零基础:不需要任何命令行知识,按步骤做即可。

需要准备

  • 树莓派 4 或 5(内存 2GB 以上)
  • microSD 卡,16GB 以上。建议选 A2 级更耐用;卡只装系统,不必买大容量
  • USB 外接硬盘或固态盘 —— 你的音乐和影片存在这里
  • 一台带读卡器的电脑
  • 家里的 Wi-Fi,或一根网线

第 1 步 · 下载镜像

下载最新的树莓派系统镜像(一个 .img.xz 文件,不用解压)。

下载镜像

想核对下载是否完整,可对照校验和清单: SHA256SUMS

第 2 步 · 把镜像烧录到 SD 卡

推荐用 Raspberry Pi Imager(官方免费工具,支持 Windows / macOS / Linux):

  1. 到 raspberrypi.com/software 安装并打开它。
  2. 点「选择设备」,选你的树莓派型号。
  3. 点「选择操作系统」,拉到最下面选「使用自定义映像」,选中刚下载的 .img.xz(不用解压)。
  4. 点「选择存储卡」,选中你的 microSD 卡。
  5. 点「下一步」。如果问「要应用系统自定义设置吗」,选「不要」—— 首次开机会自行完成设置。
  6. 确认写入前再看一眼:这会清空该卡上的全部数据,务必确认选对了卡。
  7. 等待完成(通常 5–15 分钟),然后拔出卡。

也可以用 balenaEtcher:Flash from file → 选 .img.xz → Select target → Flash!

第 3 步 · 首次开机

  1. 把 microSD 卡插进树莓派。
  2. 接上 USB 外接硬盘 —— 媒体库存在这里。
  3. 插网线(最省事),或准备下一步用 Wi-Fi 配网。
  4. 接通电源。

首次开机需要 2–4 分钟。这段时间设备在准备存储,并生成自己的身份密钥 —— 该密钥在设备上生成,不会离开设备。

第 4 步 · 在浏览器里完成设置

用**同一网络**下的手机或电脑打开:

http://sontrove-device.local

然后按屏幕提示:配置 Wi-Fi(用网线可跳过)、用 App 扫码把设备绑到你的账号、选择存放媒体库的硬盘。

如果这个地址打不开

  • 再等一分钟 —— 设备可能还在启动。
  • 部分安卓手机和较老的 Windows 不支持 .local 地址。打开路由器的设备列表,找到该设备的 IP,改用 http://<那个地址>。
  • 确认手机/电脑与树莓派在**同一网络**(访客 Wi-Fi 通常是隔离的)。

第 5 步 · 放入你的媒体

把音乐和影片拷贝到外接硬盘上,设备会自动建立索引,随后在 App 里就能看到。

值得知道

SD 卡是消耗品。 当系统盘用时,SD 卡往往 6–24 个月就会老化。系统为此以只读为主运行以延长卡的寿命,**你的媒体从不存在 SD 卡上**,而是在外接硬盘里。万一卡坏了,重烧一张、重新绑定设备即可,媒体库不受影响。

更新会自动完成。 设备自动安装经过签名的更新,并保留另一份系统副本,万一更新失败可回退。不需要为了保持最新而重新烧卡。

没有我们它照样能用。 在你自己的网络里,播放不依赖我们的服务器。绑定账号带来的是跨网络访问与同步;即使我们的服务不可达、或你不再使用,设备仍会在本地继续提供你的媒体库。

遇到问题

你看到的现象怎么办
Imager 或 Etcher 不接受这个文件确认下载已完成,并且**不要**解压那个 .img.xz
首次开机没有任何灯光或动静检查电源:树莓派 4/5 需要合规的 USB-C 电源适配器,手机充电器功率不足会导致启动失败
设备地址打不开见第 4 步 —— 改用路由器里查到的设备 IP
设置页提示没找到硬盘检查 USB 硬盘是否接好;部分大容量机械硬盘需要带供电的 USB 集线器
App 搜不到设备手机和设备必须在同一网络 —— 访客 Wi-Fi 通常与主网络隔离

还是卡住?写信给我们:contact@cedarkeel.com