项目介绍
Melody 用来管理音乐检索与云盘整理流程。它与 MelodyHub 是不同项目,登录配置与数据目录不能混用;平台接口是否可用会随上游变化。
检索取得曲目信息,保存和云盘上传负责后续整理。不同来源与音质可能对应同名不同版本,需要明确重复规则。
适合已有音乐云盘使用习惯的用户。先核对单曲与账户权限,再处理歌单。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 多源搜索 | 查找对应歌曲 |
| 链接解析 | 识别支持的单曲歌单 |
| 本地保存 | 检查文件路径与音质 |
| 云盘上传 | 核对自己账号的结果 |
| 信息整理 | 统一命名与标签 |
界面展示

图 1:官方仓库提供的项目示意图,用于说明功能与布局。

项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | 影音与下载 |
| 项目仓库 | foamzou/melody |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 创建
/volume1/docker/melody/profile与data,按下面配置启动,打开http://NAS_IP:5566。 - 先检查设置与支持的平台,用自己有权处理的一首音乐测试搜索、保存与元数据,不立即进行整歌单批量任务。
- 需要关联云盘时只使用自己的账号,检查凭据保存位置和上传结果。对重名文件、不同版本和已存在歌曲采用明确规则。
首次使用与操作检查
选一首自己可保存的曲目,比较搜索信息、下载文件与云端记录。
批量前检查已存在歌曲如何处理。与 MelodyHub 分开保存配置,账号失效先停止任务。
Docker Compose
依据官方 README 的 docker run 示例转换为 Compose,保留 profile 与音乐目录的独立挂载。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/melody/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/melody /volume1/docker/melody/data /volume1/docker/melody/profile
cd /volume1/docker/melody
HALO_PREPARE
cd /volume1/docker/melody
services:
melody:
image: foamzou/melody:latest
restart: unless-stopped
ports:
- "5566:5566"
volumes:
- /volume1/docker/melody/profile:/app/backend/.profile
- /volume1/docker/melody/data:/app/melody-data
在项目目录保存为 compose.yaml 后,先检查配置,再启动:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
配置与常见问题
- 云盘账号状态和上游平台接口都会影响可用性;检索到名称不代表能取得对应音质文件。
- profile 可能含登录状态,不将其作为公开示例上传。
- 页面无法打开:先用
docker compose ps检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。 - 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。
更新与备份
同时保存 profile、音乐数据与操作记录;原始音乐单独备份,更新前保留配置副本。
更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。
参考资料
配图来自 foamzou/melody 官方仓库,按 Apache-2.0 许可 保留来源与许可;图片只做等比例缩小和压缩。