Go Music DL：全能音乐搜索与下载神器，支持 Web/TUI/桌面三模式

Go Music DL 是一款功能强大的开源音乐工具，它打破了平台壁垒，将网易云、QQ 音乐、Bilibili、汽水音乐等主流平台的资源聚合在一起。无论你是喜欢图形界面的普通用户，还是钟情于命令行的高效极客，它都能提供完美的体验。

• GitHub：https://github.com/guohuiyuan/go-music-dl
• 地址：https://music.kukuqaq.com

🚀 三大使用模式，总有一款适合你

1. 🖥️ 桌面应用 (推荐新手)
   • 原生体验：独立的窗口应用，无需打开浏览器。
   • 开箱即用：下载即运行，自动启动内置服务，智能管理缓存。
   • 绿色免安装：单文件分发，不写注册表，随时带走。
2. 🌐 Web 界面 (推荐服务器部署)
   • 随时随地：部署在 NAS 或服务器上，通过浏览器访问。
   • 功能完整：支持试听、歌单管理、批量下载、每日推荐。
   • Docker 一键部署：真正的零配置，数据自动持久化。
3. ⌨️ TUI 终端模式 (推荐极客/批量操作)
   • 键盘流：全键盘操作，极速搜索与下载。
   • 脚本友好：轻松集成到自动化工作流中。
   • 轻量级：无需图形环境，SSH 远程也能用。

🌟 核心亮点功能

• 🎵 多平台聚合搜索：一次性搜索网易云、QQ、酷狗、酷我、咪咕、Bilibili、汽水音乐等 10+ 平台，不再为找歌切换应用。
• 🎧 无损音质下载：支持 FLAC 无损格式 下载（视平台资源而定），还原音乐细节。
• 🔓 加密音频解密：独家支持 汽水音乐 (Soda) 等平台的加密音频解密，让付费/会员歌曲也能正常播放。
• 📝 智能元数据嵌入：
  • 可选开启 FFmpeg 支持，下载时自动将 封面图 和 歌词 写入音频文件内部。
  • 兼容各大播放器，展示完美专辑信息。
• 📂 本地自制歌单：
  • 创建本地收藏夹，将不同平台的歌曲聚合在一起。
  • 数据持久化存储，永不丢失。
• 🔄 智能换源：
  • 当某平台资源失效或音质不佳时，一键“换源”，自动在其他平台寻找相似度最高、时长最接近的可播放版本。
  • 自动过滤无效源（如 Soda/Fivesing 的不可播资源）。
• 📅 每日歌单推荐：聚合各大平台的每日推荐算法，发现新音乐。

🛠️ 快速开始指南

方式一：桌面应用 (Windows/Mac/Linux)

1. 前往 GitHub Releases 页面下载对应系统的 music-dl-desktop 压缩包。
2. 解压后双击运行即可。
   • 注：Windows 用户若打不开，请确保已安装 WebView2 运行时。

方式二：Docker 部署 (NAS/服务器首选)

这是最推荐的部署方式，零配置、数据自动持久化。

# 1. 创建 docker-compose.yml (或直接使用项目自带的)
# 2. 一键启动
docker compose up -d

# 3. 访问 http://localhost:8080

• 数据保护：自动使用 Docker Named Volumes 存储下载文件 (downloads)、Cookie (cookies.json) 和歌单数据 (favorites.db)，删除容器也不会丢失数据。
• 安全性：默认以非 root 用户 (UID 1000) 运行。

方式三：命令行 (CLI/TUI)

# 搜索并交互式下载
./music-dl -k "周杰伦 晴天"

# 指定平台搜索 (qq, netease)
./music-dl -k "陈奕迅" -s qq,netease

# 直接下载并嵌入封面歌词 (需安装 ffmpeg)
./music-dl -k "林俊杰" --cover --lyrics

# 解析分享链接直接下载
./music-dl -k "https://music.163.com/#/song?id=123456"

TUI 常用快捷键：

• ↑/↓：移动光标
• 空格：选择/取消选择
• a：全选/清空
• r：对选中项智能换源
• Enter：下载选中项
• w：查看每日推荐歌单
• q：退出

📊 支持平台一览表

💡 进阶技巧

1. 获取更高音质：
   • 在 Web 端“设置”中填入对应平台的 Cookie，可解锁会员专享音质或更高 bitrate 的资源。
2. 批量管理：
   • Web 端支持“全选”、“批量换源”、“批量下载”，一次性整理整个歌单。
3. 内嵌元数据开关：
   • 若追求极致下载速度，可在 Web 设置中关闭“内嵌元数据”，走纯流式下载。
   • 若需收藏整理，请确保系统已安装 FFmpeg 并开启该选项。

❓ 常见问题

• Q: 桌面应用启动慢？
  • A: 首次运行可能需要下载 WebView2 组件。建议提前安装官方 Evergreen 版本。
• Q: 提示“另一个程序正在使用此文件”？
  • A: 上次进程未正常退出。Windows 用户可运行 taskkill /F /IM music-dl.exe 清理残留进程。
• Q: 某些歌搜不到？
  • A: 可能是平台严格限制付费资源或未上架。尝试“换源”功能或检查 Cookie 设置。