Music Assistant 原生云音乐插件

neqq3

# v0.1.0 - Music Assistant 原生云音乐插件



## 核心功能
- **原生集成**：作为 Music Assistant 的原生 Music Provider 运行。
- **扫码登录**：支持通过 MA 界面直接扫码登录云音乐账号。
- **功能支持**：
  - **我的歌单**：同步用户创建和收藏的歌单。
  - **搜索**：支持搜索歌曲、专辑、歌手和歌单。
  - **高清封面**：自动获取高清专辑和歌手封面。
  - **音质选择**：支持多种期望音质选择（实际播放音质取决于账号权益）。
  - **播放优化**：集成 API 的增强播放策略，提升播放成功率。

## 安装说明 (Music Assistant Docker)

1. 下载本 Release 中的 `ncloud_music.zip` 并解压。
2. 将解压出的 `ncloud_music` 文件夹上传到你的 NAS 或服务器（例如 `/volume1/docker/ma/providers/ncloud_music`）。
3. 修改music assistant的 `docker-compose.yaml`，添加挂载：
   ```yaml
   volumes:
     # ⚠️ 请将左侧的 /你的实际存放路径/ncloud_music 替换为你上传的真实路径
     - /你的实际存放路径/ncloud_music:/app/venv/lib/python3.13/site-packages/music_assistant/providers/ncloud_music
   ```
   *(注意：请根据你的 MA 版本确认 Python 路径，可能是 python3.11 或 python3.12)*

## 配置说明
1. 在 MA 设置 -> Providers 中添加 "NCloud Music"。


2. **API 服务地址**：填入你的 NeteaseCloudMusicApi 地址 (例如 `http://192.168.x.x:3000`)。
   > 本插件依赖 [NeteaseCloudMusicApi-Enhanced](https://github.com/neteasecloudmusicapienhanced/api-enhanced) 运行，请确保你已部署该服务。



3. 点击 "扫码登录" 按钮获取登录二维码，使用云音乐 APP 扫码登录。
4. **重要**：扫码成功后，**务必点击右上角的“保存”按钮**以保存登录状态。
   > 如需切换账号，请重新点击扫码登录，并在扫码后再次点击“保存”。

## 致谢
感谢 [Music Assistant](https://github.com/music-assistant/server) 团队提供的优秀平台。
感谢 [NeteaseCloudMusicApi-Enhanced](https://github.com/neteasecloudmusicapienhanced/api-enhanced) 提供的 API 支持。

容器挂载插件的路径参考的是https://bbs.hassbian.com/?114397 的 https://bbs.hassbian.com/thread-31141-1-1.html

chaosl

大佬牛逼
HAOS有没有方案哦？找了半天没找到addon的ma路径

neqq3

chaosl 发表于 2026-1-17 14:25
大佬牛逼
HAOS有没有方案哦？找了半天没找到addon的ma路径

你可以使用我的集成https://bbs.hassbian.com/thread-30947-1-1.html来接入
或者在haos里面安装docker的ma。
目前这个插件的定位还比较模糊，暂时定位是面向单独使用ma的人群的。

Andychao2025

支持这哥们，是你接入了云音乐 API 给 MA，所以才激发我写了补齐歌手专辑封面图的
歌词自动补全也在测试中了

lichao622

大佬，这是单独把云音乐的服务器放在nas了吧。不用那个集成接入了，对吧。

neqq3

lichao622 发表于 2026-1-17 20:22
大佬，这是单独把云音乐的服务器放在nas了吧。不用那个集成接入了，对吧。 ...

对的，但还是需要那个云音乐api的项目。

lichao622

neqq3 发表于 2026-1-17 20:26
对的，但还是需要那个云音乐api的项目。

通过加载项安装的ma不能用这个吧。

neqq3

Andychao2025 发表于 2026-1-17 16:01
支持这哥们，是你接入了云音乐 API 给 MA，所以才激发我写了补齐歌手专辑封面图的
歌词自动补全也在测试中 ...

现在头疼的是使用这种接入方式的话加载项怎么使用，感觉ha用户里使用haos的人会很多。不知道ma官方会不会接纳这种需要第三方api的项目呢。

lichao622

我用的是ha的ma加载项，其实需求是想通过加载项原生接入，哪怕单独建个服务也行，就是不太想用集成然后在转接ma的方式

neqq3

lichao622 发表于 2026-1-17 20:30
通过加载项安装的ma不能用这个吧。

是的。加载项安装的ma本质也是docker。你可以在haos里安装docker版本ma来使用。但是都用haos了，可能使用集成方式接入会更好。如果以后能接入ma官方可能会更好，但是概率不大。目前这个项目只是一个试水吧。