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
  1. 环境变量
  2. 创建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隧道穿透,播放无损音乐会卡。这款应用的功能包括小爱音箱、音源、刮削等都能满足我的要求,这点很满意。唯一不足的就美观和易用度,这点道理鱼做的不错,也十分推荐。

作者:无辣
感谢大家的支持
暂无评论

发送评论 编辑评论


				
|´・ω・)ノ
ヾ(≧∇≦*)ゝ
(☆ω☆)
(╯‵□′)╯︵┴─┴
 ̄﹃ ̄
(/ω\)
∠( ᐛ 」∠)_
(๑•̀ㅁ•́ฅ)
→_→
୧(๑•̀⌄•́๑)૭
٩(ˊᗜˋ*)و
(ノ°ο°)ノ
(´இ皿இ`)
⌇●﹏●⌇
(ฅ´ω`ฅ)
(╯°A°)╯︵○○○
φ( ̄∇ ̄o)
ヾ(´・ ・`。)ノ"
( ง ᵒ̌皿ᵒ̌)ง⁼³₌₃
(ó﹏ò。)
Σ(っ °Д °;)っ
( ,,´・ω・)ノ"(´っω・`。)
╮(╯▽╰)╭
o(*////▽////*)q
>﹏<
( ๑´•ω•) "(ㆆᴗㆆ)
😂
😀
😅
😊
🙂
🙃
😌
😍
😘
😜
😝
😏
😒
🙄
😳
😡
😔
😫
😱
😭
💩
👻
🙌
🖕
👍
👫
👬
👭
🌚
🌝
🙈
💊
😶
🙏
🍦
🍉
😣
Source: github.com/k4yt3x/flowerhd
颜文字
Emoji
小恐龙
花!
上一篇