NAS一键部署私人音乐服务器，小米音箱联动，全平台畅听

前言

也许是版权的问题，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上。

项目部署

1. 创建 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

2. 环境变量

   

3. 创建docker项目

   

使用方法

1. 服务启动后，访问 http://localhost:58091 即可打开 Web 界面

   

2. 使用配置的管理员账号密码登录

   

3. 在 Web 界面中点击"扫描"按钮，系统会自动扫描音乐目录中的音频文件并提取元数据

   

4. 扫描完成后，即可在界面中浏览和播放音乐

   

插件系统

官方目前提供四款插件包括音乐刮削、小米音箱、洛雪、Cloudflared 隧道， 插件地址：https://mimusic.hanxi.cc/issues/4.html

洛雪不方便演示，大家自己找使用方法。内容穿透也不需要用插件。

1. 音乐标签刮削 从其他平台提取歌曲元数据（标题、专辑、艺术家、歌词、封面）

   

2. 小米音箱插件 小米账号登录和小爱音箱控制，支持多账号管理

   

3. 洛雪音源 管理洛雪音源，搜索和导入网络歌曲

   

客户端使用

1. 作者提供了全平台客户的开源软件mimusic 下载地址：https://mimusic.hanxi.cc/issues/8.html

2. 登录客户端

   

3. 界面和其他音乐app差不多

   

4. 可以通过客户端操作小米音箱播放音乐

   

结尾

如果需要外网使用还是建议ddns用IPv6直连，作者提供的cf隧道穿透，播放无损音乐会卡。这款应用的功能包括小爱音箱、音源、刮削等都能满足我的要求，这点很满意。唯一不足的就美观和易用度，这点道理鱼做的不错，也十分推荐。