Go Music DL全网音乐搜索下载工具Go Music DL最新版v1.0.15

Go Music DL 是一款聚合多家主流音乐平台资源的开源音乐搜索与下载工具，旨在帮助用户一站式搜索、试听和下载来自不同平台的音乐，无需在多个 App 之间来回切换。

该项目基于 Go 语言开发，免费开源，无需注册，支持 Web界面、TUI终端和桌面应用三种使用模式，内置网易云、QQ音乐、酷狗、酷我、Bilibili、汽水音乐（Soda）等 10 余个主流平台，支持多源并发搜索和无损音质解析。该工具提供了三种使用模式——Web界面、TUI终端和桌面应用，无论是偏好图形界面的普通用户，还是钟情于命令行的高效极客，都能找到适合自己的使用方式。项目完全免费开源，无需注册即可使用，并且支持Docker一键部署，可以轻松部署在NAS或服务器上供多人访问。

一、主要功能一览

• 多平台聚合搜索：单曲、歌单、专辑均可搜索，一次拉取多站结果。

• 无损音质下载：支持网易云、QQ 音乐、Bilibili 的 FLAC 无损音乐下载。

• 加密音频解密：独家支持汽水音乐（Soda）等平台的加密音频解密。

• 本地自制歌单：可创建本地收藏夹，将不同平台的歌曲聚合收藏，数据持久化不丢失。

• 智能元数据嵌入：可开启 FFmpeg 支持，下载时自动将封面图和歌词写入音频文件。

• 智能换源：资源失效或音质不佳时，可一键换源，自动在其他平台匹配相似版本。

• Range 探测：显示文件大小与码率，支持断点/拖动播放。

• 每日歌单推荐：聚合各大平台的每日推荐歌单。

• 过滤付费资源：可设置过滤需要付费的歌曲。

• 批量操作：支持全选、批量下载、批量换源。

二、三种使用模式详解

🖥️ 模式一：桌面应用（推荐新手）

桌面应用是最简单、最开箱即用的方式，无需任何命令行操作，下载即用。

使用步骤：

1. 前往 GitHub Releases 页面，下载对应系统的 music-dl-desktop 压缩包（Windows/Mac/Linux 均可）。

2. 解压后，双击运行即可。

3. 如果是 Windows 用户无法打开，请确保已安装 WebView2 运行时。

桌面应用提供原生窗口体验，自动启动内置服务，智能管理缓存，单文件分发、绿色免安装。

🌐 模式二：Web 界面（推荐服务器/NAS 部署）

Web 模式适合部署在 NAS、VPS 或本地服务器上，通过浏览器访问，随时随地使用。

使用步骤：

1. 直接运行 Web 模式（本地快速启动）：

   ./music-dl web

   然后访问 http://localhost:8080 即可。

2. Docker 一键部署（推荐，真正的零配置）：
   项目已提供 docker-compose.yml 文件，直接拉取云端预编译镜像即可：

   docker compose up -d

   启动后访问 http://localhost:8080。

   Docker 部署会自动使用命名卷（Named Volumes）持久化下载目录、Cookie 配置和歌单数据，删除容器也不会丢失数据，且默认以非 root 用户运行，提高安全性。

   Web 端支持单曲、歌单、专辑三种搜索类型切换，可直接粘贴歌单链接或专辑链接，自动识别来源并进入详情。Web 试听按钮支持播放/停止切换，底部有全局播放与音量控制栏。

⌨️ 模式三：TUI 终端模式（推荐极客/批量操作）

TUI 模式适合习惯键盘操作的开发者，全键盘操作，极速搜索与下载，无需图形环境，SSH 远程也能用。

常用命令示例：

TUI 界面可在单曲、歌单、专辑之间切换，支持 r 键批量换源并显示换源进度。

三、实用建议

1. 关于 FFmpeg（元数据嵌入）

Web 端的“设置”中有一个“下载时内嵌元数据（封面/歌词）”开关。开启后，下载时会尝试将封面和歌词写入音频文件，但这需要依赖 FFmpeg。如果未安装 FFmpeg，会自动跳过内嵌并返回原始音频。

各系统安装 FFmpeg 的命令：

• Windows：winget install Gyan.FFmpeg

• macOS：brew install ffmpeg

• Ubuntu/Debian：sudo apt install ffmpeg

2. 关于 Cookie 设置

Web 端提供了“设置 Cookies”功能，可针对不同平台配置 Cookie。这对于访问某些需要登录验证的资源或提升搜索成功率有一定帮助。建议在常规使用中暂时无需配置，只有当发现某些平台的搜索或下载出现问题时再考虑设置。

3. 使用建议

4. 免责与法律提示

Go Music DL 是一个开源的搜索与下载工具，本身不提供任何音乐资源，所有音乐内容均来自各音乐平台的公开接口。请尊重音乐版权，下载的音乐仅用于个人学习、研究和欣赏，切勿用于商业用途或非法传播。