�� MusicFree 播放器插件 — 给飞牛上的 MusicFree 服务器配个客户端
背景
看到论坛里有朋友部署了 MusicFree 音乐服务器，但一直缺个好用的手机客户端。Web 界面管理还行，日常听歌切歌还是不够方便。
其实 MusicFree 服务器原生支持 OpenSubsonic 协议（兼容 Navidrome 的 API），而手机端正好有个叫 MusicFree 播放器 的开源项目（maotoumao/MusicFree），支持插件扩展、无广告、免费。但它默认不带 Subsonic 协议的插件，所以需要一个桥梁连接起来。
这个小插件就是为了解决这个问题写的。
插件能做什么
装了这个插件后，直接用 MusicFree 播放器 App 连接飞牛上的 MusicFree 服务器，功能全部可用：
| 功能 | 说明 |
|------|------|
| �� 搜歌 | 搜索歌曲、专辑、艺术家 |
| ▶️ ** | 点歌即播，支持 FLAC / MP3 |
| �� 歌词 | 自动加载服务器端歌词 |
| �� 专辑浏览 | 查看专辑内所有曲目 |
| �� 排行榜 | 最新专辑、随机歌曲、最常播放等 |
| �� 每日推荐 | 随机歌单推荐 |
| �� 多用户 | 支持配置不同的服务器地址和账号 |
部署方式
服务端（已在飞牛部署的跳过）
services:
music-free:
image: ansgoo/music-free:latest
container_name: music-free
restart: unless-stopped
ports:
- "4555:4533"
volumes:
- /vol1/docker/music-free:/app/data
- /vol1/music:/app/music
客户端（手机）
1. 下载 MusicFree 播放器
2. 导入插件
打开 MusicFree → 设置 → 插件管理 → 导入插件 → 选择下载好的 musicfree.js
插件文件见附件��
3. 填写服务器信息
| 参数 | 填写 |
|------|------|
| 地址 | http://飞牛IP:端口 |
| 用户 | MusicFree Web 登录用户名 |
| 密码 | MusicFree Web 登录密码 |
4. 开始使用
回到首页搜索歌曲，或进入「排行榜」页面浏览榜单，点击即可播放。
注意事项
- 请确保手机和飞牛 NAS 在同一网络，或配置了公网访问 / DDNS
- 第一次部署 MusicFree 服务器后记得先在 Web 界面改密码
- 插件地址、用户名、密码三个参数必填，否则无法连接
附件
插件文件：musicfree.js（见附件下载）
版本号：v1.0.5
兼容性：MusicFree 播放器 v0.1.0-alpha 以上
有问题欢迎回帖交流，时间原因不一定秒回，但看到会回复 ��
附件：musicfree.zip
