一键部署MelodyHub全攻略：打造私人音乐流媒体服务

April 4, 2026

MelodyHub 是一款基于 lx-music-desktop 核心逻辑开发的 Web 版音乐服务平台。它支持多平台音乐搜索、下载与管理，并通过 Docker 提供一键部署功能，非常适合在 NAS 或服务器上本地搭建私人音乐库，实现听歌自由。

核心功能特性：

🎵 多音源支持：兼容 lx-music-desktop 自定义源，支持网易云音乐、QQ音乐、酷我音乐、酷狗音乐等主流平台。
🌐 Web 访问：直接通过浏览器即可使用，支持跨设备访问，无需安装额外客户端。
📥 服务器端下载：支持断点续传、下载队列管理以及多任务并行处理，提升效率。
🔄 实时推送：基于 WebSocket 技术实时推送下载进度，让用户随时掌握任务状态。
🛡️ 防盗链代理：自动处理音乐平台的防盗链机制，确保资源可访问。
💾 数据持久化：使用 SQLite 数据库存储用户数据和配置信息，轻量且可靠。
🎨 现代化 UI：采用 Vue 3 结合 Element Plus 构建，界面简洁美观。
🎯 歌曲管理：内置强大的歌曲管理器，支持元数据编辑和整理。
🔍 智能搜索：实现多平台聚合搜索功能，快速找到所需音乐资源。

Docker Compose 部署指南

通过 Docker Compose 可以快速部署 MelodyHub。以下是一个标准的配置示例：

services:  
  melodyhub:  
    image: geelonn/melodyhub:latest  
    container_name: melodyhub  
    ports:  
      - 3000:3000  
    environment:  
      - JWT_SECRET=your-secure-secret-key  
      - PORT=3000  
      - DATA_DIR=/app/data  
      - MUSIC_DIR=/app/music  
      - TZ=Asia/Shanghai  
    volumes:  
      - ./data:/app/data  
      - ./music:/app/music  
    restart: unless-stopped

关键参数说明（更多高级配置建议查阅官方文档）：

3000（端口）：此为 Web 用户界面的访问端口，可通过浏览器输入对应地址进入。
JWT_SECRET（环境变量）：用于加密认证的安全密钥，请务必修改为自定义的复杂字符串。
/app/data（路径）：映射到本地的数据存储目录，用于存放配置和数据库文件。
/app/music（路径）：映射到本地的音乐存储目录，所有下载的音乐文件将保存在此。

MelodyHub 使用教程与技巧

部署完成后，在浏览器中输入 http://您的服务器IP地址:3000 即可访问 MelodyHub 的主界面。

由于 MelodyHub 本身不内置音乐源，因此首次使用需要手动上传自定义音乐源文件。

如何获取音乐源文件？ 您可以访问 lx-music-desktop 项目的 GitHub 页面（lyswhut/lx-music-desktop），在 Issues 板块中搜索其他用户分享的可用音乐源。

下载到音乐源（通常为 .js 文件）后，在 MelodyHub 界面中点击“上传自定义源”按钮即可导入。

提示：如果上传后系统提示 500 错误，可能是该音乐源文件存在兼容性问题，建议尝试更换其他用户分享的源文件。

在实际测试中，部分音乐源的在线播放功能可能无法正常工作（具体表现因源而异），但这并不影响核心的下载功能。

下载音乐的功能通常稳定可用，这证实了音乐源本身是有效的。

您可以随时在“下载管理”页面查看当前进行中的下载任务及其进度。

下载完成后，前往之前 Docker 配置中映射的本地音乐目录，即可查看已下载的文件。根据文件格式和大小判断，通常可以获取到高质量甚至无损音质的音乐。

MelodyHub 支持直接搜索并添加在线歌单。其最实用的功能之一是“订阅下载”，您可以订阅整个歌单，系统便会自动处理其中的所有歌曲。

成功订阅歌单后，您可以在“计划任务”页面中看到相应的订阅项。

系统默认会在每天凌晨自动执行订阅任务，但您完全可以自定义定时规则。例如，您可以手动触发“立即执行”来快速下载。

此时返回“下载管理”页面，就能看到该歌单中的所有歌曲已被加入下载队列并开始自动下载。

如果您不知道听什么，可以直接订阅各大音乐平台的实时榜单，让系统自动为您更新和下载热门歌曲。

MelodyHub 有一个非常出色的优化功能：下载的音乐文件会自动进行元数据刮削。您可以在歌曲管理器中看到带有封面、歌词、专辑信息等完整数据的音乐文件。

体验总结与推荐

许多用户一直苦于寻找便捷的音乐资源获取方式，MelodyHub 的出现提供了一套完整的解决方案。通过订阅歌单或音乐榜单，配合定时自动下载和元数据刮削，您只需部署一次，即可持续享受整理好的私人音乐库。

当然，也需要指出其用户界面仍有较大的优化空间。如果未来能在UI美观度和交互体验上进一步提升，这款工具将更具竞争力。对于有听歌需求的用户，强烈建议尝试部署。获取和配置有效的音乐源是主要门槛，如果不熟悉此过程，建议仔细阅读本文的相关步骤。

综合推荐指数：⭐⭐⭐⭐（提供从搜索、下载到管理的一站式音乐服务，非常值得推荐）

实际使用体验：⭐⭐⭐（核心功能强大，但用户界面有待改进）

部署难易程度：⭐⭐（过程相对简单，遵循教程即可完成）