站点介绍

Go Music DL是一个基于Go语言开发的开源音乐搜索与下载工具，致力于为用户提供便捷的跨平台音乐获取体验。

项目支持Web界面、TUI终端和原生桌面应用三种使用模式，集成了网易云、QQ音乐、酷狗、Bilibili等10余个主流音乐平台的聚合搜索功能。

功能介绍

多模式支持: Web 界面、TUI 终端、桌面应用
本地自制歌单: 支持新建本地收藏夹，随时收藏、管理心仪歌曲，数据持久化不丢失
无损音乐支持: 支持网易云、QQ 音乐、Bilibili 的 FLAC 无损音乐下载
多平台聚合搜索与歌单搜索
试听、歌词、封面下载
Range 探测：显示大小与码率
汽水音乐等加密音频解密
过滤需要付费的资源
桌面应用特性: 原生窗口、自动服务启动、智能缓存管理

使用方法/界面展示

桌面应用是最简单的使用方式。用户只需从Releases页面下载music-dl-desktop.exe文件，解压后双击运行即可。桌面应用提供原生窗口体验，无需打开浏览器，支持自动启动内置Web服务器，使用罕见端口37777避免端口冲突。

下面是软件版本的相关截图演示：

Web模式适合需要浏览器操作的用户。启动方式为执行命令：

./music-dl web

启动后在浏览器访问 http://localhost:8080 即可使用。

Web界面支持设置Cookie以获取更高音质，右上角设置菜单中可配置内嵌元数据选项。

TUI终端模式提供了高效的命令行操作体验。基础搜索命令为：

./music-dl -k "搜索关键词"

TUI模式的常用按键包括：上下箭头移动、空格选择、a键全选或清空、r键对勾选项换源、Enter键下载、b键返回、w键查看每日推荐歌单、q键退出。

高级命令行用法包括指定搜索源：

./music-dl -k "周杰伦 晴天" -s qq,netease

指定下载目录：

./music-dl -k "周杰伦" -o ./my_music

下载时包含封面和歌词：

./music-dl -k "周杰伦" --cover --lyrics

查看完整帮助信息：

./music-dl -h

Docker部署提供了零配置快速启动方案。生产环境部署使用docker-compose.yml，直接拉取云端预编译镜像：

docker compose up -d
docker compose logs -f
docker compose down

开发环境部署使用docker-compose.dev.yml进行本地构建：

docker compose -f docker-compose.dev.yml up -d --build

纯命令行模式使用docker run：

docker run -d --name music-dl \
-p 8080:8080 \
-v music_data_downloads:/home/appuser/downloads \
-v music_data_cookies:/home/appuser/cookies.json \
-v music_data_favorites:/home/appuser/favorites.db \
-e TZ=Asia/Shanghai \
--user 1000:1000 \
--restart unless-stopped \
guohuiyuan/go-music-dl:latest

Docker部署的优势在于自动创建命名卷进行数据持久化，无需手动建立文件夹，下载的歌曲文件保存在Docker虚拟卷中，可通过Web端批量下载功能导出到本地。

额外补充

同类型的项目其实也不少，主要是看个人的需求，我个人对于这种比较喜欢，非常简单直接，支持docker直接部署，官方给的教程也是非常简洁明了，修改保存路径或者端口号之后直接运行即可，如果你不知道如何操作，可以尝试看看本站提供的搭建演示视频。