绿联云部署go-music-dl，实现音乐自由

Go Music DL：一款基于 Go 语言的全网音乐搜索与下载工具，支持 Web 界面、TUI 终端 和 桌面应用 三种使用模式。内置网易云、QQ、酷狗、Bilibili、汽水音乐等 10+ 个主流平台，支持多源并发搜索与无损音质解析。

主要功能：

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

Docker Compose示例

1. services:
   
2.   music-dl:
   
3.     image: guohuiyuan/go-music-dl:latest
   
4.     container_name: music-dl
   
5.     command: [ "./music-dl", "web", "--port", "8080", "--no-browser" ]
   
6.     ports:
   
7.       - "8080:8080"
   
8.     environment:
   
9.       - TZ=Asia/Shanghai
   
10.       # 适配NAS文件权限，避免下载无写入权限
    
11.       #- PUID=0
    
12.       #- PGID=0
    
13.     volumes:
    
14.       # 配置、登录缓存、本地歌单持久化
    
15.       - /volume1/docker/music-dl/data:/home/appuser/data
    
16.     restart: unless-stopped

复制代码

总结
音乐下载默认路径为 /volume1/docker/music-dl/data/downloads文件夹下

默认下载歌曲音质比较一般，但是界面倒是很清爽挺不错的，适合部署提供对外服务，有兴趣对音乐要求不高的可以部署试试。

可以，安排上，谢谢分享

启动不起来啊兄弟

初始化令牌是什么啊~

yOJf7T 发表于 2026-7-11 10:43
初始化令牌是什么啊~

初始化令牌在控制台里面看，一般是一串字符

不爱思考 发表于 2026-7-10 14:29
启动不起来啊兄弟

兄弟你倒是贴出报错啊，有可能端口8080被占用了或者volumes里的地址不对

m8oTQB 发表于 2026-7-11 11:24
初始化令牌在控制台里面看，一般是一串字符

没有找到呢，本地不过不登录也可以用。

冷知识没有音乐平台会员账号，也就mp3

部署失败

services:
  music-dl:
    image: guohuiyuan/go-music-dl:latest
    container_name: music-dl
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      # 🌟 核心修正：挂载到程序实际的运行目录 /home/appuser/data 下
      - ./data:/home/appuser/data
    environment:
      - TZ=Asia/Shanghai
    command: [ "./music-dl", "web", "--port", "8080", "--no-browser" ]


启动失败的，添加镜像加速器


这个错误是因为你的绿联 NAS 无法连接到 Docker Hub 官方服务器（registry-1.docker.io）来下载镜像。这在国内网络环境下非常常见，通常是由于网络限制或不稳定导致的连接超时。
要解决这个问题，最有效的方法是为 Docker 配置一个镜像加速器。
🛠️ 解决方法：配置 Docker 镜像加速器
你可以按照以下步骤在绿联 NAS 的 Docker 设置中添加一个镜像加速地址。
. 找到 Docker 设置
打开绿联 NAS 的“Docker”应用。
在左侧菜单中找到并点击“设置”或“Docker 设置”（通常在“注册表”、“镜像”、“容器”等选项附近）。
. 添加镜像加速地址
在设置页面中，找到“镜像加速器”或“Registry Mirror”相关的选项。
在输入框中，添加一个可用的镜像加速地址。你可以尝试使用以下地址之一：
https://docker.m.daocloud.io
https://dockerproxy.com
https://hub-mirror.c.163.com
点击“保存”或“应用”按钮。
. 重新部署项目
设置保存后，返回到“项目”页面。
找到你之前创建的 go-music-dl 项目。
点击“重新部署”或“启动”按钮。
Docker 将会通过你配置的镜像加速器来拉取 guohuiyuan/go-music-dl:latest 镜像，速度会快很多，并且能成功下载。