音乐下载

一、简介

今天无意间在B站上刷到一个可以免费下载音乐文件的项目，项目免费开源，支持docker、命令行、ui方式下载音乐。

项目地址：GitHub - guohuiyuan/go-music-dl: 一个基于 Go 语言的全网音乐搜索与下载工具。支持 CLI 命令行与 Web 服务双模式，内置网易云、QQ、酷狗、Bilibili、汽水音乐等 10+ 个主流平台，支持多源并发搜索与无损音质解析。music-dl交流群：1074285005 · GitHub

下载地址：Tags · guohuiyuan/go-music-dl · GitHub

二、使用

2.1 桌面应用 (推荐)

1. 从 Releases 下载 music-dl-desktop.exe

2. 解压，双击运行

3. 享受原生桌面体验

2.2 Web 模式

./music-dl web

2.3 TUI 模式

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

2.4 Docker 部署

本项目提供了多种 Docker 部署方式，已全面升级为 Docker 命名卷 (Named Volumes) 管理数据，彻底告别权限报错和手动建文件夹的烦恼，实现真正的零配置一键启动。

项目包含 docker-compose.yml 文件，直接拉取云端预编译镜像，无需在本地构建：

# 后台启动服务
docker compose up -d

# 查看日志
docker compose logs -f

# 停止服务
docker compose down


浏览器访问 http://localhost:8080。

说明：

自动拉取 guohuiyuan/go-music-dl:latest 镜像
支持后台运行和自动重启
真·零配置：自动创建 Docker 命名卷来持久化 downloads (下载目录)、cookies.json (配置) 和 favorites.db (收藏夹数据)，无需手动干预
设置时区为亚洲上海
以非root用户(uid=1000)运行，提高安全性

纯命令行模式
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


# 查看帮助
./music-dl -h

# 指定搜索源
./music-dl -k "周杰伦 晴天" -s qq,netease

# 指定下载目录
./music-dl -k "周杰伦" -o ./my_music

# 下载时包含封面和歌词
./music-dl -k "周杰伦" --cover --lyrics