guohuiyuan/go-music-dl

这是什么？

核心功能

• 01跨多个平台同时搜索单曲、歌单和专辑
• 02提供 Web、终端界面和桌面、移动端四种使用方式
• 03支持 Cookie 与扫码登录，用于个人歌单和更高音质
• 04管理本地音乐，读取元数据、封面与歌词
• 05安装 FFmpeg 后可在下载时内嵌封面和歌词
• 06下载内容可同步到 WebDAV

适用场景

• 在某个音乐平台找不到歌曲时，跨平台搜索并下载
• 整理带标签和歌词的本地音乐库
• 在家庭服务器上用 Docker 自建音乐搜索下载页面
• 在终端中浏览各平台排行榜和歌单

快速上手

1. 1

   从 Releases 下载桌面端安装包

2. 2

   启动 Web 界面

   ./music-dl web
3. 3

   或在终端中搜索

   ./music-dl -k "周杰伦"
4. 4

   或使用 Docker 启动

   docker compose up -d --pull always --remove-orphans

使用前须知

• !采用 AGPL-3.0 许可证，衍生的网络服务需要开放源代码。
• !部分平台需要 Cookie 或登录才能获取更高音质、个人歌单或会员整曲。
• !部分平台的搜索或下载结果不稳定或不完整，例如 Apple Music 仅能下载试听片段。
• !桌面、iOS 和 CLI 版本如需封面和元数据功能，需要自行安装 FFmpeg。

标签

常见问题

go-music-dl 是什么？

基于 Go 的多平台音乐搜索与下载工具，支持 Web、终端和桌面端使用。 Go Music DL 可在网易云、QQ 音乐、酷狗、酷我、咪咕、Bilibili、Apple Music、JOOX 等十多个平台中搜索单曲、歌单、专辑和排行榜，支持多源同时搜索、试听、批量下载，并可在原曲不可用时换源。

go-music-dl 可以免费使用吗？用的什么许可证？

go-music-dl 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

go-music-dl 还在维护吗？

活跃维护中。go-music-dl 最近一次提交是在 2026年10月19日。

go-music-dl 适合用来做什么？

在某个音乐平台找不到歌曲时，跨平台搜索并下载 整理带标签和歌词的本地音乐库 在家庭服务器上用 Docker 自建音乐搜索下载页面 在终端中浏览各平台排行榜和歌单

go-music-dl 怎么安装和运行？

从 Releases 下载桌面端安装包 启动 Web 界面: ./music-dl web 或在终端中搜索: ./music-dl -k "周杰伦" 或使用 Docker 启动: docker compose up -d --pull always --remove-orphans

在哪里获取 go-music-dl？

源代码和安装说明在 GitHub 上：https://github.com/guohuiyuan/go-music-dl