Music Assistant的Unraid Docker安装配置

Fri, 05 Jun 2026 00:00:00 +0000

安装

有官方应用直接在应用里面网络只要通正常安装

添加一个路径
本机路径指向音乐库
容器路径填写/media

配置

启动容器进行常规配置登录

配置中文显示

选择侧边栏的Settings - User Interface - 第二个框Language拉到底就是

添加媒体库

设置里面第一个 Music source
右上角添加选择Filesystem(local disk)
由于默认的路径名称就是/media所以直接拉到底点保存
稍等，也可以点开设置里面的系统再点击服务器日志记录查看进度

网易云元数据&歌词插件

资源下载

资料地址：https://gitee.com/andychao2020/music-assistant-providers

其实只用到两个
歌词：netease_lyrics
元数据： netease_metadata、

拷贝插件

下载下来后通过SSH连接Unraid

先退回到根目录接下来依次进入
mnt - user - appdata - music-assistant
创建一个providers文件夹将插件粘贴进去

配置music-assistant 服务

然后回到Unraid Docker界面编辑 music-assistant

添加路径
网易云歌词插件：
容器路径：/app/venv/lib/python3.13/site-packages/music_assistant/providers/netease_lyrics

主机路径：/mnt/user/appdata/music-assistant/providers/netease_lyrics/

网易元数据插件：
容器路径：/app/venv/lib/python3.13/site-packages/music_assistant/providers/netease_metadata
主机路径：/mnt/user/appdata/music-assistant/providers/netease_metadata/

插件加载和配置

进入music-assistant网页
点击设置-元数据提供者
将能禁用的都禁用掉

点击右上角添加选择需要的两个都添加先不配置直接点击保存

创建本地网易云API服务

用SSH粘贴以下代码

docker run -d \
  --name=ncm-api \
  --network=bridge \
  -p 3003:3000 \
  -e TZ=Asia/Shanghai \
  -u root \
  --restart=always \
  moefurina/ncm-api:latest

回车保持网络等待完成

返回Unraid查看是否已成功运行

粘贴后面的IP地址和端口到网页看看是否成功运行

回到Music Assistant的元数据提供者页面
分别点击我们添加的两个插件
将刚才的IP地址跟端口替换相应内容

随便点开一个歌手的页面等一会然后刷新页面看看是否成功
它元数据加载由于免费API有CD所以平常有空就随便点开一个就好

跟Home Assistant连通

进入Music Assistant的设置
再次进入Plugins点击右上角然后输入HASS的内网地址

然后如果想导入HASS控制的设备给Music Assistant
点击设置里的播放器提供者右上角添加Home Assistant MediaPlayers选择HASS中的实体就好

然后想管理Music Assistant 播放设备
进入设置里的播放器，可以配置是否在MASS里面隐藏和是否向HASS暴露
还有DPS等设置

Music Assistant全平台数播系统方案