---
type: project
tags: [RFID, 树莓派, 点唱机, 硬件, 开源项目]
status: learning
date: 2026-09-01
related: "[[2026-09-搭建RFID点唱机/00-索引|本项目索引]]"
---

# 2026-09-搭建RFID点唱机

> 教学工作区(teach):[MISSION.md](<./MISSION.md>)(为什么学)· [RESOURCES.md](<./RESOURCES.md>)(资源)· [NOTES.md](<./NOTES.md>)(教学偏好) · [课程地图](<./reference/课程地图.html>)(全局路线)
> 属于 `10-项目\` 项目层(月粒度 · 入门 · 部署实操)。RFID 应用双项目之一,与「2026Q4-复刻L-ink智能名片」串联,合计窗口 2026-09-01 → 2026-12-01。
> 来源:开源项目 [MiczFlor/RPi-Jukebox-RFID](https://github.com/MiczFlor/RPi-Jukebox-RFID)(GitHub stars:约1.8k,PHP + Python + Shell)——树莓派 Phoniebox 刷卡点唱机:刷 RFID 卡触发播放本地音乐/播客/网络电台,带 Web 管理界面。安装 Wiki:[INSTALL](https://github.com/MiczFlor/RPi-Jukebox-RFID/wiki/INSTALL) / 使用手册:[MANUAL](https://github.com/MiczFlor/RPi-Jukebox-RFID/wiki/MANUAL)。
> 定位:把「Linux + RFID 硬件 + 开源部署」串成一个拿得出手的实体作品(课设/简历/演示均可)。

- **目标:** 在树莓派上从零部署 RPi-Jukebox-RFID,跑通"刷卡即播",并完成至少一处自己的定制
- **状态:** 进行中(阶段0 调研完成,待采购下单)
- **起止:** 2026-09-01 → 2026-10-15
- **为什么做:** 部署级项目最锻炼"读文档 → 采购 → 最小系统 → 跑通 → 定制"的完整链路,且产出实物,成就感与说服力都强
- **验收标准:**
  1. 刷卡 ≤3 秒出声,再刷一次停止;Web 界面能管理卡片与音频文件夹
  2. 能讲清整体架构与"卡号 → 音频文件夹"的映射机制(讲给人听或写成笔记)
  3. 至少完成一处定制(功能卡 / Web 界面文案样式 / 快捷脚本,任选其一)
  4. 踩坑记录与沉淀笔记完成,文件夹移入 40-归档

## 任务清单(参考:官方 README 与 Wiki 的 components / installation / RFID readers 章节)

### 阶段0 采购与预习(09-01 → 09-07,等快递的同时推进)
>
> 2026-09-01 调研完成:装 **V2 classic** + **RC522** + **Pi 4B(或二手 3B+)**,详见 [01-阶段0-版本与硬件决策及采购清单](<01-阶段0-版本与硬件决策及采购清单.md>)

- [x] 通读官方 README 与 Wiki,确定装 classic 版还是 Spotify 版(后者需 Premium 账号,默认 classic)——结论:V2 classic;V3 尚缺电台/播客,不满足验收标准
- [ ] 列清单并下单(合计约 300~600 元):树莓派(3B+/4/5 均可)、16G+ microSD 卡、读卡器二选一(USB 读卡器免接线最稳 / MFRC522 模块走 GPIO 更练手)——清单已列,定 RC522,待下单
- [ ] 预习:Raspberry Pi Imager 烧录系统;SSH 无屏(headless)连接与 WiFi 预配置
- [ ] 若选 MFRC522:预习 SPI 接线图(对照树莓派 40 引脚图)

### 阶段1 最小系统就绪(09-08 → 09-14)

- [ ] 烧录 Raspberry Pi OS,SSH 连通,apt 换源并更新
- [ ] 音频输出测试(3.5mm/USB/HDMI),调好音量,存一首测试音乐
- [ ] 读卡验证:USB 读卡器直接刷卡看输出,或用示例脚本读出 MFRC522 卡号(记下卡号,后面注册用)
- [ ] 补 Linux 运维三件套:systemctl 管服务、journalctl 看日志、进程与端口排查(后面排障全靠它)

### 阶段2 一键安装跑通(09-15 → 09-21)

- [ ] 按官方 installscripts 一键安装 Phoniebox
- [ ] Web 界面首配:注册第一张卡,绑定本地音乐文件夹
- [ ] 里程碑:刷卡播放本地音乐,再刷停止 —— 录一段演示视频存档
- [ ] 安装过程每个坑(换源/权限/依赖)随手记进「踩坑记录」

### 阶段3 功能铺开与定制(09-22 → 10-05,含国庆假期,弹性缓冲)

- [ ] 音频源铺开:本地文件夹分类建库,注册多张卡
- [ ] 网络电台(stream URL)与播客 RSS 各配一个
- [ ] 功能卡:音量调节卡、关机卡;有余力再试 GPIO 按钮或第二读卡器
- [ ] 完成定制一处:Web 界面文案/样式修改,或新增自己的快捷脚本
- [ ] 稳定性观察:连续播放、频繁刷卡,记录偶发问题与解法

### 阶段4 拆原理与收尾(10-06 → 10-15)

- [ ] 源码结构走读:卡号 → 文件夹映射(shortcuts 目录)、音频库目录、Web 界面(PHP)、各守护脚本职责分工
- [ ] 画出整体架构图(读卡 → 事件 → 播放服务 → Web 管理)
- [ ] 沉淀笔记写进本项目 20-知识/,踩坑记录整理归档
- [ ] 复盘(用 [20-笔记正文模板](<../../90-模板/20-笔记正文模板.md>)),文件夹移入 40-归档,衔接下一项目「2026Q4-复刻L-ink智能名片」

## 沉淀的知识(成品正文放本项目 `20-知识/`)

- 树莓派入门(烧录/SSH headless/音频配置) → 本项目 20-知识/树莓派.md(学成后新建)
- RFID 读卡机制与卡号映射思路 → 与第二项目共用一篇,学成后统一登记
- 完成后在根 [00-索引.md](<../../00-索引/00-索引.md>) 勾选学习路线进度

## 踩坑记录

-

## 复盘 / 出口

- 未开始。完成后:文件夹移入 40-归档;总结"部署一个开源硬件项目"的通用套路(读文档 → 采购 → 最小系统 → 一键安装 → 定制 → 拆原理),输出一页流程笔记