项目介绍
MelodyHub 提供网页搜索、任务队列与音乐文件管理入口。可用于把音乐整理任务放到常开设备,音源可用性仍取决于对应服务。
网页端负责搜索和查看任务,服务端负责排队、保存音乐及维护数据。下载目录与应用数据库分开持久化,方便把整理后的文件交给其他播放器或音乐服务器。
原资料介绍了多音源、下载进度、元数据编辑和队列管理等能力。接入自定义音源后,应先确认搜索与实际播放都正常,再安排批量任务;搜索有结果不代表每首歌都能取得可用文件。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 聚合检索 | 使用已配置的音源搜索音乐。 |
| 任务队列 | 查看等待、运行与失败的下载项目。 |
| 进度反馈 | 通过网页观察任务状态变化。 |
| 文件管理 | 在音乐目录中保存和整理结果。 |
| 元数据编辑 | 检查曲名、专辑与艺术家标签。 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | 项目指南 |
| 分类 | 影音与下载 |
| 项目仓库 | geelonn/melodyhub |
| 整理日期 | 2026-11-14 |
安装或使用条件
先确认所用项目版本、操作系统与依赖,准备独立测试目录及可恢复的数据副本。本文中的操作流程需与对应版本的官方说明配合使用。
安装与使用步骤
- 核对仓库中的镜像和版本,分别设置数据目录、音乐目录与会话密钥。
- 先配置一个可使用的音源,用单曲检查搜索、播放与保存路径。
- 确认任务状态和元数据写入正常后,再添加歌单任务与调度。
首次使用与操作检查
先设置自己的会话密钥和持久化目录,导入一个可信音源。只提交一首自己有权保存的音乐,核对任务状态、实际文件与播放效果。
出现搜索正常但下载失败时,分别检查音源响应、保存路径和文件权限。批量歌单先限制任务量,失败项单独重试,避免同一任务反复生成重复文件。
配置与常见问题
- 原示例的 JWT_SECRET 是占位内容,正式使用必须替换。
- 不要把 MelodyHub 与 foamzou/melody 当作同一个项目。
更新与备份
备份应用数据库、任务配置和音乐目录,升级前先停止写入任务。