影音与下载

Melody:音乐检索与云盘整理

  • 0 次阅读
  • 0 条评论
文章摘要

Melody 用来管理音乐检索与云盘整理流程。它与 MelodyHub 是不同项目,登录配置与数据目录不能混用;平台接口是否可用会随上游变化。 检索取得曲目信息,保存和云盘上传负责后续整理。不同来源与音质可能对应同名不同版本,需要明确重复规则。 适合已有音乐云盘使用习惯的用户。先核对单曲与账户权限,再处理歌单。

项目介绍

Melody 用来管理音乐检索与云盘整理流程。它与 MelodyHub 是不同项目,登录配置与数据目录不能混用;平台接口是否可用会随上游变化。

检索取得曲目信息,保存和云盘上传负责后续整理。不同来源与音质可能对应同名不同版本,需要明确重复规则。

适合已有音乐云盘使用习惯的用户。先核对单曲与账户权限,再处理歌单。

核心功能

功能 作用与使用方式
多源搜索 查找对应歌曲
链接解析 识别支持的单曲歌单
本地保存 检查文件路径与音质
云盘上传 核对自己账号的结果
信息整理 统一命名与标签

界面展示

Melody 官方项目配图

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

Melody 官方界面示例
项目官方界面示例,展示上游演示数据。

项目信息

项目 说明
类型 Docker
分类 影音与下载
项目仓库 foamzou/melody
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 创建 /volume1/docker/melody/profile 与 data,按下面配置启动,打开 http://NAS_IP:5566。
  2. 先检查设置与支持的平台,用自己有权处理的一首音乐测试搜索、保存与元数据,不立即进行整歌单批量任务。
  3. 需要关联云盘时只使用自己的账号,检查凭据保存位置和上传结果。对重名文件、不同版本和已存在歌曲采用明确规则。

首次使用与操作检查

选一首自己可保存的曲目,比较搜索信息、下载文件与云端记录。

批量前检查已存在歌曲如何处理。与 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 许可 保留来源与许可;图片只做等比例缩小和压缩。