音乐在线电台
把 audio/ 目录里的歌曲用 FFmpeg 切成 HLS 切片，拼成一条永不停播的直播流，并提供 Web 控制面板管理播放列表、从网易云导入音源。前后端一体的 Node.js 应用，无数据库依赖。
功能特性
- 🎵 音频文件自动转码切片（HLS），拼成 24 小时不间断的直播流
- 📋 拖拽排序的播放列表（支持添加、移除、清空、切歌）
- 🔥 热度统计 + 缓存自动清理（上限 1GB，按热度淘汰）
- ☁️ 网易云音源导入：输入歌曲 ID，一键下载入库并显示封面/歌名/作者
- 🖼️ 资源卡片展示：封面图高斯模糊背景 + 时长/大小信息（hover 显示）
- 🔒 可选 API 鉴权（Bearer Token）
环境要求
| 依赖 | 版本要求 |
|---|---|
| Node.js | >= 14.14 |
| npm | 随 Node 附带 |
| FFmpeg | 任意较新版本（需包含 ffmpeg 与 ffprobe，且在系统 PATH 中） |
⚠️ FFmpeg 是硬性依赖。缺少它程序能启动但无法转码切片，直播流不会有内容。安装后请在终端运行
ffmpeg -version与ffprobe -version确认可用。
安装
1. 安装 Node.js
Windows
- 前往 https://nodejs.org 下载 LTS 版本安装包（
.msi），一路下一步即可。 - 安装完成后重新打开终端，运行
node -v应显示版本号（≥ v14.14）。
Linux（Debian/Ubuntu 示例）
# 使用 NodeSource 源安装新版 Node
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v
其它发行版请参考 Node.js 官方安装文档，或使用包管理器安装
nodejs/npm。
2. 安装 FFmpeg
Windows（推荐）
方式一：用 winget（Windows 11 自带）：
winget install Gyan.FFmpeg
方式二：手动下载
- 打开 https://www.gyan.dev/ffmpeg/builds/，下载
release essentials的 zip 包。 - 解压到固定目录（如
C:\ffmpeg）。 - 把解压后
bin子目录的完整路径（如C:\ffmpeg\bin）加入系统环境变量Path：Win键 → 搜索「编辑系统环境变量」→ 「环境变量」→ 双击「Path」→ 新建 → 粘贴路径 → 确定。
- 重新打开终端，运行
ffmpeg -version验证。
方式三：用 Chocolatey / Scoop：
choco install ffmpeg # 或
scoop install ffmpeg
Linux
# Debian / Ubuntu
sudo apt update && sudo apt install -y ffmpeg
# CentOS / RHEL / Fedora
sudo dnf install -y ffmpeg # 部分发行版需先启用 EPEL 或 RPM Fusion 源
# Arch
sudo pacman -S ffmpeg
验证安装：
ffmpeg -version
ffprobe -version
3. 安装项目依赖
在项目根目录（demo/）下：
npm install
启动
npm start
启动成功后控制台会输出：
[INFO] 资源: N 个文件
[CACHE] 启动扫描: ...
[LIVE] 已启动 | 切片 5s | 窗口 15 段 ≈75s | ...
[HTTP] 面板: http://127.0.0.1:3000
[HTTP] 直播: http://127.0.0.1:3000/hls/index.m3u8
- 控制面板：浏览器打开 http://127.0.0.1:3000
- 直播流地址：http://127.0.0.1:3000/hls/index.m3u8（可用 VLC、PotPlayer、ffplay 等播放器打开）
停止服务：在终端按 Ctrl + C。
💡 Windows 下如果端口被旧进程占用导致启动失败（
EADDRINUSE），见下文「常见问题」。
使用指南
添加音频
把音频文件（支持 .mp3 / .m4a / .flac / .wav）直接放进 audio/ 目录。程序用 chokidar 监听目录，无需重启，新文件会自动扫描并开始转码切片。
文件名建议用「作者 - 歌名.mp3」格式，程序会据此自动解析出作者与歌名，用于面板展示。
网易云音源导入
- 在控制面板左侧「资源列表」顶部输入框填入网易云歌曲 ID。
- 点「查询」，预览区会显示封面、歌名、作者。
- 点「下载」，音频会自动保存到
audio/并入库切片，封面/歌名/作者写入元数据。
网易云歌曲 ID 在哪找？ 打开网易云网页版某首歌的页面，地址栏 https://music.163.com/song?id=33894312 中 id= 后面的数字即为歌曲 ID。
⚠️ 版权限制：只有免费、可播的歌曲能下载。VIP / 灰色无版权歌曲会被拦截并提示「无版权或需 VIP」，这是网易云服务端的限制，无法绕过。
管理播放列表
控制面板右侧「播放列表」支持：
- ➕ 点资源卡片右侧的加号把歌曲加入播放列表
- 🖱️ 拖拽排序（SortableJS）
- ❌ 移除单曲
- 🗑️ 清空列表（清空后自动随机补一首，保证直播不断流）
- 歌曲播完自动从列表移除，列表空了自动随机补一首
播放列表与热度会持久化到磁盘，重启后保留。
目录结构与数据文件
demo/
├── index.js # 主程序（后端 + HLS 直播 + HTTP API）
├── package.json # 依赖与启动脚本
├── public/ # 前端控制面板（静态文件，含 favicon）
│ ├── index.html
│ └── favicon.png
├── audio/ # 【你的音频】放这里，程序自动监听
└── （以下为运行时自动生成，可随时删除，重启自动重建）
├── hls/ # 直播流滑动窗口 index.m3u8
├── hls_cache/ # 每首歌的 HLS 切片缓存（上限 1GB，自动清理）
├── heat.json # 歌曲热度（缓存清理优先级）
├── playlist.json # 播放列表（持久化）
└── metadata.json # 歌曲元数据（歌名/作者/封面图/时长）
环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
AUTH_TOKEN |
（空） | 设置后，所有 /api/* 接口需携带请求头 Authorization: Bearer <token> |
USE_DISCONTINUITY |
false |
设为 true 时在歌曲切换处插入 #EXT-X-DISCONTINUITY 标签（兼容性更好则保持关闭） |
PORT |
3000 |
HTTP 服务端口 |
HLS_TIME |
5 |
单个 HLS 切片时长（秒），同时决定直播 tick 间隔 |
SLIDE_WINDOW |
15 |
直播滑动窗口段数（≈ 窗口秒数 = HLS_TIME × 该值） |
MAX_CACHE_MB |
1000 |
HLS 缓存上限（MB），超出按热度淘汰 |
FFMPEG_CONCURRENCY |
3 |
FFmpeg 转码并发数 |
MAX_RETRIES |
3 |
单文件转码失败重试上限 |
FFMPEG_TIMEOUT_MS |
300000 |
单次 FFmpeg 转码超时（毫秒） |
设置方式（三平台）：
Windows PowerShell
$env:AUTH_TOKEN="your_token"; npm start
Windows CMD
set AUTH_TOKEN=your_token && npm start
Linux / macOS
AUTH_TOKEN=your_token npm start
常见问题
端口 3000 被占用
Windows
# 找到占用 3000 端口的 PID
netstat -ano | findstr :3000
# 结束该进程（把 <PID> 换成上一条命令查到的数字）
taskkill /PID <PID> /F
Linux
# 查看占用进程
sudo lsof -i :3000
# 或
sudo ss -tlnp | grep 3000
# 结束进程（把 <PID> 换成实际值）
kill <PID>
启动成功但直播流没声音 / 一直缓冲
- 确认
audio/目录里确有音频文件。 - 确认 FFmpeg 已正确安装并在 PATH 中：
ffmpeg -version。 - 看启动日志里
[PRESEG]是否报错——若某首歌转码失败会打印[PRESEG] 失败，可检查该文件是否损坏。 - 首次启动需对所有歌曲转码，耗时随歌曲数量与长度增加，请耐心等待日志出现
[PRESEG] 完成。
网易云下载报「无版权或需 VIP」
正常现象，见上文「网易云音源导入」的版权说明。换一首免费歌曲即可。
局域网内其它设备访问不到
- 确认目标设备能 ping 通本机 IP。
- Windows：需在防火墙中放行 Node.js（或放行 3000 端口）。首次启动时若弹出防火墙授权，点「允许」；否则在「Windows 安全中心 → 防火墙 → 允许应用通过防火墙」中手动添加 node.exe。
- Linux：若有
ufw/firewalld需放行端口：
sudo ufw allow 3000 # ufw
sudo firewall-cmd --add-port=3000/tcp --permanent && sudo firewall-cmd --reload # firewalld
然后用本机局域网 IP 访问：http://<本机IP>:3000。
技术栈
Node.js · Express · Chokidar · FFmpeg（HLS 切片）· SortableJS · Bootstrap Icons