💠前言✨

• 国内各大音乐平台都是VIP，只能试听，不同平台，还得分别下载不同的APP，体验太差了，故而落雪音乐强势出击，造福音乐爱好者。
• 本教程整理了落雪音乐与music-assistant（MA）的docker部署方式，搭配HA智能家居中心，体验拉满。

💠开发环境✨

• 设备：N100
• 架构：X86_64
• 部署方式：docker_compose

💠资料✨

• 🎶落雪音源GitHub地址：https://github.com/hjy1728/mass-lxmusic-provider
• 🎶music-assistant（MA）的Gitee地址：https://gitee.com/andychao2020/music-assistant-providers

💠部署落雪服务器✨

• 全程在SSH终端中操作；
• 在软路由中，创建目录，命名为lxmusic；
• 进入刚才创建的目录；
• 创建Yaml配置文件：

vim docker-compose.yaml

• 输入i，进入编辑模式，粘贴以下配置信息：

services:
  lx-sync-server:
    image: xcq0607/lxserver:latest
    container_name: lx-sync-server
    restart: unless-stopped
    ports:
      - "9527:9527"  #左侧端口号可修改
    volumes:
      - /mnt/mydisk/docker/lxserver/data:/server/data
      - /mnt/mydisk/docker/lxserver/logs:/server/logs
      - /mnt/mydisk/docker/lxserver/cache:/server/cache
      - /mnt/mydisk/docker/lxserver/music:/server/music
    environment:
      - NODE_ENV=hygge
      # 给 MA 插件登录用的账号：用户名 admin，密码改成你自己的
      - LX_USER_admin=djkthaliebcsjg
      # 管理后台登录密码（浏览器访问 http://软路由IP:9527 时使用），默认 123456
      - FRONTEND_PASSWORD=123456
      # 关闭匿名统计，可留可去
      - DISABLE_TELEMETRY=true

• 配置信息没有问题，输入ESC退出键:wq，保存退出；
• 拉取项目

docker-compose pull

• 启动项目

docker-compose up -d

• 网页端访问后台

IP:9527

• 登录密码

123456

• 访问成功的界面
  
• 创建新用户，左侧菜单，选择--用户管理--添加用户

- 创建的用户名和密码，就是你Docker部署时录入的信息.

• 接着选择下方的【Web播放器▶️】，进入设置，添加音乐源（随时失效）

https://raw.githubusercontent.com/pdone/lx-music-source/main/lx/latest.js

• 落雪服务器，就部署完成。

💠部署网易云api✨

• 全程在SSH终端中操作；
• 在软路由中，创建目录，命名为lxmusic；
• 进入刚才创建的目录；
• 创建Yaml配置文件：

services:
  ncm-api:
    container_name: ncm-api
    image: moefurina/ncm-api:latest
    ports:
      - "9603:3000"  #左侧端口号建议修改为其余的，否则无法访问后台
    restart: always
    user: root
    environment:
      - TZ=Asia/Shanghai
    network_mode: bridge 

• 配置信息没有问题，输入ESC退出键:wq，保存退出；
• 拉取项目

docker-compose pull

• 启动项目

docker-compose up -d

• 网页端访问后台

IP:8095

• 首次访问，复制Base Url的地址，用于粘贴到music-assistant（MA）的NetEase开头的2个插件中。

💠部署music-assistant（MA）✨

• 全程在SSH终端中操作；
• 在软路由中，创建目录，命名为music_assistant；
• 进入刚才创建的目录；
• 创建Yaml配置文件：

vim docker-compose.yaml

• 输入i，进入编辑模式，粘贴以下配置信息：

services:
  music-assistant-server:
    image: ghcr.nju.edu.cn/music-assistant/server:latest # 南京大学源可替换为beta版本以获取最新测试版
    container_name: music-assistant
    restart: unless-stopped
    # 网络模式必须设置为host，Music Assistant才能正常工作
    network_mode: host
    volumes:
      - ./providers/netease_metadata:/app/venv/lib/python3.14/site-packages/music_assistant/providers/netease_metadata  # 网易元数据
      - ./providers/musicbrainz:/app/venv/lib/python3.14/site-packages/music_assistant/providers/musicbrainz  # musicbrainz魔改版
      - ./providers/netease_lyrics:/app/venv/lib/python3.14/site-packages/music_assistant/providers/netease_lyrics  # netease_lyrics
      - ./providers/gd_studio_music:/app/venv/lib/python3.14/site-packages/music_assistant/providers/gd_studio_music # GD_Studio_music
      - ./providers/douban_metadata:/app/venv/lib/python3.14/site-packages/music_assistant/providers/douban_metadata # 豆瓣元数据
      - ./providers/amcfy_music:/app/venv/lib/python3.14/site-packages/music_assistant/providers/amcfy_music  #箭头音乐APP桥接器
      - ./data:/data #数据持久化
      - /mnt/mydisk/ssd/navidrome/music/folder:/music  #挂载本地音乐目录，根据自己的目录修改
      - /mnt/mydisk/docker/music_assistant/providers/lxmusic:/app/venv/lib/python3.14/site-packages/music_assistant/providers/lxmusic #落雪音乐源
    cap_add:
      - SYS_ADMIN
      - DAC_READ_SEARCH
    security_opt:
      - apparmor:unconfined
    environment:
      # 日志级别配置，默认值为info，可选值：critical、error、warning、info、debug
      - LOG_LEVEL=info
      - TZ=Asia/Shanghai
      

• 配置信息没有问题，输入ESC退出键:wq，保存退出；
• 拉取项目

docker-compose pull

• 启动项目

docker-compose up -d

• 网页端访问后台

IP:8095

• 首次访问，需要自行创建账户信息；
• 找到左下角的设置，选择调色盘的图标(用户界面)，把语音设置为中文.
• 设置好以后，停止容器：

docker-compose down

• 回到软路由文件管理界面，需要上传一份文件，内容链接：https://gitee.com/andychao2020/music-assistant-providers/releases/tag/v3.3.2
• 下载该压缩包，保存在电脑上，进行解压
• 解压后，上传到软路由的指定目录,目录如下：

/mnt/mydisk/docker/music_assistant/providers

• 顺便去把落雪音乐插件的压缩包，一并解压后上传到该目录，需要注意⚠️的是，解压后，修改为目录为lxmusic，再复制到这个目录即可，文件链接：https://github.com/hjy1728/mass-lxmusic-provider/releases/tag/v1.0.1
• 我们回到SSH终端上面，进行项目拉取和启动：
• 拉取项目

docker-compose pull

• 启动项目

docker-compose up -d

• 网页端访问后台，并且登录好：

IP:8095

• 左侧设置，找到音乐来源--添加音乐源，安装GDstudiomusic，这个项目是提供音乐数据的，有网易云会员，就可以用它，配置信息默认，保存即可；
• 左侧设置，找到元数据提供者--添加元数据提供商，分别安装NetEase lyrics，链接填写网易云api的Base URL链接即可;
• 安装NetEase Metadata，链接填写网易云api的Base URL链接即可;
• 安装Music Brainz，配置默认，保存即可.
• 需要禁用两个插件，分别为Fanart.tv、LRCLIB，因为我们是用网易云的音乐刮削插件.

添加音乐源

• 左侧设置，找到音乐来源--添加音乐源，选择Filesystem（Local disk）--路径（输入music），保存即可，音乐自动开始扫描
• 左侧设置，找到音乐来源--添加音乐源，选择LX music（落雪音乐服务端），地址输入刚才部署好的落雪音乐服务端ip，以及登录信息.
• 音乐源添加成功后，直接在首页搜索想听的歌曲，会出来绿色角标的歌曲，表示是落雪音乐的，播放成功，表示已经生效了.
• 
• 我们主要是利用网易云的音乐刮削，来整理落雪音乐的封面和歌词。开发者自研的GDstudiomusic，就可以不需要了。

💠容器全部重启✨

• 为保证服务全部生效，建议把MA的容器重启一次。
• 回到SSH终端，执行命令
• 停止项目：

docker-compose down

• 拉取项目

docker-compose pull

• 启动项目

docker-compose up -d

• 网页端访问后台，并且登录好：

IP:8095

💠音箱设备✨

• 博主是老式蓝牙音箱，不支持直接用MA播放歌曲，故而在闲鱼购买了AirPlayer和DLAN的音频接收器，插入到普通蓝牙音箱，MA就可以识别到该音箱了；
• 后续通过HA的语音，就可以直接播放落雪音乐，实现全屋听歌自由🎶.

💠折腾不止，热爱不停~✨

© 版权声明
文章版权归作者所有，未经允许请勿转载。