平时听歌，你是不是也遇到过这种情况：好不容易找到喜欢的歌，想下下来，结果各种App、广告、跳转，烦都烦死了。

今天给大家推荐一个特别适合NAS用户的开源项目：COCO Downloader（COCO音乐下载站）。它用Next.js 16开发的，可以让你很方便地搜索和下载音乐。这个工具界面简洁，没有广告，支持多个音乐平台一起搜索，还能在线试听和批量下载。而且，它还有酷炫的暗黑模式和过渡动画。

🧾 项目简介

COCO Downloader 就像一个网页版的音乐下载器，干干净净的，没有任何广告。它的目标很简单：不用装任何软件，直接在浏览器里搜索、试听、下载音乐。它能同时搜索多个音乐平台，你可以在不同的平台之间切换，或者一起搜索，还能一次性选择多首歌曲，一起打包下载。

如果你不想自己安装，可以直接用开发者提供的在线版本：https://cocodownloader.markqq.com

提醒一下：有NAS用户测试过，这个工具在界面右侧可以一键下载，左侧可以勾选批量下载。不过，通常只支持标准音质，不支持无损音质（这是之前的版本，现在可能会有变化）。

✨ 主要功能

  • 🔎 多平台搜索：可以同时搜索很多平台的音乐，内置了多种音乐源，想换哪个点一下就行。

  • 🎧 在线试听：自带播放器，可以播放、暂停、拖动进度条、调节音量，还能切换歌曲。

  • ✅ 操作方便：列表里的歌曲可以双击播放，鼠标放上去或者选中时，会有一些小效果，用起来很流畅。

  • ⬇️ 批量下载：可以一次选择多首歌曲，然后一键打包下载。

  • 🌗 暗黑模式+过渡动画：切换页面的时候，会有涟漪扩散的动画，看起来很舒服。

  • 🧩 容易增加音乐源：后端用的是策略模式，想加新的音乐源，只需要简单设置一下，不用改很多代码。

📁 使用前的准备工作

1）创建一个文件夹来存放项目文件

建议在你的NAS上创建一个文件夹（比如：/volume1/docker/coco-downloader/），用来存放docker-compose.yml文件和备份说明等。

0-Hdiv

一般来说，这个项目通过浏览器来下载文件，所以不一定需要把音乐文件放到NAS的文件夹里（这取决于你的使用习惯和浏览器的下载路径设置）。

2）准备Docker环境

如果你的NAS是群晖、威联通、飞牛等，它们都自带Docker管理器，直接用就行。如果你用的是自己搭建的Linux系统，装好Docker和Compose就可以开始使用了。

🐳 部署方法（两种方式，建议 Compose）

COCO Downloader 官方 README 给出了本地与 Docker 部署方案：可以本地 npm run build 后 npm start，也可以 Docker build 再 run。下面我按“NAS 更常用”的方式写成可直接照抄版本。

✅ 方式 A：Docker 命令一把梭（最快）

docker run -d \
  --name coco-downloader \
  --restart unless-stopped \
  -p 3060:3000 \
  markcxx/coco-downloader:latest

✅ 方式 B：Docker Compose（更适合 NAS 长期运行）

docker-compose.yml：

services:
  coco-downloader:
    image: markcxx/coco-downloader:latest
    container_name: coco-downloader
    restart: unless-stopped
    ports:
      - "3060:3000"

1. 在飞牛主页面找到 Docker 切换菜单 Compose -> 新增项目

0-wGpb

2. 填写项目名称与路径，将 docker-compose.yml 内容粘贴到来源框

0-WHlM

3. 返回 Docker管理页面，在 容器菜单，就可以看到运行情况

0-Zhem

📖 使用方法（上手 30 秒）

打开：http://你的NAS_IP:3060 你会看到一个非常干净的首页：中间搜索框输入歌名/歌手即可，下方展示列表。

0-aOnh

🎵 1）搜索与切换音乐源

项目支持 多源聚合搜索，并允许切换不同音乐源渠道。
有介绍文章提到目前支持包含 歌曲宝、歌曲海、布谷、QQ音乐、QQMP3、咪咕、力音 等在内的多个音乐源（以项目当时实现为准）。

0-TeGm

🎧 2）双击试听

列表支持 双击播放，底部有悬浮播放器可进行播放控制与进度/音量调整。

0-kPCl

⬇️ 3）单曲下载 / 批量下载

  • 右侧按钮可对单曲进行下载；

  • 左侧勾选后可 批量下载，项目特性中也明确支持“多选歌曲一键批量打包下载”。

    0-zWIh
    0-gtJE

下载是通过浏览器完成的，因此通常不需要把下载目录映射到 NAS（你可以在浏览器设置下载路径到 NAS 共享目录/映射盘）。

🔧 常见问题（NAS 场景高频）

1）启动正常但访问不了？

  • 检查 NAS 防火墙/安全组是否放行 3060 端口。

  • 确认容器端口映射为 3060:3000

2）为什么没有无损/Hi-Res？

有体验文章提到该站点下载“仅支持标准音质，不支持无损格式”（具体取决于音乐源和项目实现）。

⚠️ 免责声明

本项目为开源项目，仓库标注使用 MIT License。仅供技术交流学习，请勿用于商业用途。请合理使用并尊重版权与平台规则。

🎉 总结

如果你想要的是一个 “能用、好看、纯净、无广告、并且能多源搜歌 + 先试听再下载” 的网页工具，那 COCO Downloader 的定位非常清晰：轻量、现代、交互顺滑，尤其适合家庭服务器/NAS 自建。