前言
也许是版权的问题,NAS上一直没有特别好用的音乐播放功能,各种docker应用也都尝试过,基本都是navidrome变种或增强版,没有什么特色。之前用过一段时间xiaomusic,可以联动小米音箱直接播放音乐,还是很方便的,但应用本身太难用。最近发现xiaomusic的开发者hanxi发布了第二款应用MiMusic,一款免费的个人音乐服务器,可以通过插件扩展功能,既保留了联动小米音箱的功能,还可以添加音乐源,一键下载无损音乐,快速刮削,客户端支持全平台,实用性拉满。
核心功能
- 🎵 本地音乐管理 — 扫描本地目录,自动提取 MP3/FLAC/WAV/APE/OGG/M4A 等格式的封面和元数据
- 🧩 WASM 插件体系 — WebAssembly 沙箱运行,支持洛雪音源、音乐标签刮削、小米音箱控制等扩展插件
- 📱 跨平台客户端 — Flutter 客户端支持 Android、iOS、macOS、Windows、Linux、Web 六端
- 🌐 Web 界面 — 完整版内置 Web 前端,开箱即用
- 🔑 JWT 认证 — 双 Token 机制(Access Token + Refresh Token),支持多设备管理
- 📡 网络歌曲 & 电台 — 支持添加网络歌曲和网络电台
- 🔌 完整 REST API — 内置 Swagger 文档,方便集成和二次开发
- ⚡ 轻量高效 — Go 编写,CGO-free,无外部依赖,适合 NAS / 树莓派等低功耗设备
项目说明
项目地址:https://github.com/mimusic-org/mimusic
MiMusic 提供两种版本:完整版包含web页面,开箱即用;精简版只有后端服务,必须搭配客户端使用。
项目提供Linux、macOS、windows等多种安装方式,我会使用docker compose的方式部署到NAS上。
项目部署
- 创建
docker-compose.yml文件
version: '3.8'
services:
mimusic:
image: hanxi/mimusic:full
container_name: mimusic
restart: always
ports:
- "58091:58091" #端口
volumes:
- /vol3/1000/Music:/app/music # 音乐文件目录,修改为自己NAS上的目录
- ./data:/app/data # 数据存储目录,可以保持默认
environment:
- ADMIN_USERNAME=admin # 管理员用户名
- ADMIN_PASSWORD=admin # 管理员密码
- LISTEN_PORT=58091
- MUSIC_DIR=/app/music
- DATA_DIR=/app/data
- 环境变量
- 创建docker项目
使用方法
- 服务启动后,访问
http://localhost:58091即可打开 Web 界面
- 使用配置的管理员账号密码登录
- 在 Web 界面中点击”扫描”按钮,系统会自动扫描音乐目录中的音频文件并提取元数据
- 扫描完成后,即可在界面中浏览和播放音乐
插件系统
官方目前提供四款插件包括音乐刮削、小米音箱、洛雪、Cloudflared 隧道,
插件地址:https://mimusic.hanxi.cc/issues/4.html
洛雪不方便演示,大家自己找使用方法。内容穿透也不需要用插件。
- 音乐标签刮削
从其他平台提取歌曲元数据(标题、专辑、艺术家、歌词、封面)
- 小米音箱插件
小米账号登录和小爱音箱控制,支持多账号管理
- 洛雪音源
管理洛雪音源,搜索和导入网络歌曲
客户端使用
- 作者提供了全平台客户的开源软件
mimusic
下载地址:https://mimusic.hanxi.cc/issues/8.html - 登录客户端
- 界面和其他音乐app差不多
- 可以通过客户端操作小米音箱播放音乐
结尾
如果需要外网使用还是建议ddns用IPv6直连,作者提供的cf隧道穿透,播放无损音乐会卡。这款应用的功能包括小爱音箱、音源、刮削等都能满足我的要求,这点很满意。唯一不足的就美观和易用度,这点道理鱼做的不错,也十分推荐。





















