🎵 快速下载和使用 MiMusic 发布版本
🏠 GitHub • 📥 下载 • 💬 问题反馈 • 👥 微信群
| 平台 | 架构 | 下载链接 |
|---|---|---|
| 🐧 Linux | x86_64 | mimusic-linux-amd64 |
| 🐧 Linux | ARM64 | mimusic-linux-arm64 |
| 🐧 Linux | ARMv7 | mimusic-linux-armv7 |
| 🍎 macOS | x86_64 (Intel) | mimusic-darwin-amd64 |
| 🍎 macOS | ARM64 (Apple Silicon) | mimusic-darwin-arm64 |
| 🪟 Windows | x86_64 | mimusic-windows-amd64.exe |
| 🪟 Windows | ARM64 | mimusic-windows-arm64.exe |
| 平台 | 下载链接 |
|---|---|
| 🐧 Linux x86_64 | mimusic-docker-linux-amd64.tar |
| 🐧 Linux ARM64 | mimusic-docker-linux-arm64.tar |
| 🐧 Linux ARMv7 | mimusic-docker-linux-armv7.tar |
# 1️⃣ 下载对应平台的二进制文件
# 例如 Linux x86_64:
wget https://github.com/mimusic-org/mimusic/releases/latest/download/mimusic-linux-amd64
# 2️⃣ 添加执行权限
chmod +x mimusic-linux-amd64
# 3️⃣ 创建必要目录
mkdir -p music data
# 4️⃣ 运行
./mimusic-linux-amd64# 1️⃣ 下载对应平台的二进制文件
# 例如 Windows x86_64: mimusic-windows-amd64.exe
# 2️⃣ 创建必要目录
mkdir music
mkdir data
# 3️⃣ 运行
.\mimusic-windows-amd64.exe# 拉取镜像
docker pull hanxi/mimusic:latest
# 或指定版本
docker pull hanxi/mimusic:1.0.0 # 替换为具体版本号
# 运行容器
docker run -d \
--name mimusic \
-p 58091:58091 \
-v /path/to/music:/app/music \
-v /path/to/data:/app/data \
-e ADMIN_USERNAME=admin \
-e ADMIN_PASSWORD=your_secure_password \
hanxi/mimusic:latest# 1️⃣ 下载对应平台的 Docker 镜像 tar 文件
wget https://github.com/mimusic-org/mimusic/releases/latest/download/mimusic-docker-linux-amd64.tar
# 2️⃣ 导入镜像
docker load -i mimusic-docker-linux-amd64.tar
# 3️⃣ 查看导入的镜像
docker images | grep mimusic
# 4️⃣ 运行容器（使用导入的镜像标签）
docker run -d \
--name mimusic \
-p 58091:58091 \
-v /path/to/music:/app/music \
-v /path/to/data:/app/data \
-e ADMIN_USERNAME=admin \
-e ADMIN_PASSWORD=your_secure_password \
hanxi/mimusic:latest| 变量名 | 说明 | 默认值 |
|---|---|---|
ADMIN_USERNAME |
👤 管理员用户名 | admin |
ADMIN_PASSWORD |
🔐 管理员密码 | admin |
PORT |
🔌 服务端口 | 58091 |
MUSIC_DIR |
🎵 音乐文件目录 | ./music |
DATA_DIR |
💾 数据存储目录 | ./data |
# 查看帮助
./mimusic-linux-amd64 -help
# 指定端口
./mimusic-linux-amd64 -port 8080
# 指定管理员用户名
./mimusic-linux-amd64 -username admin
# 指定管理员密码
./mimusic-linux-amd64 -password your_password
# 指定数据库文件路径
./mimusic-linux-amd64 -db data/mimusic.db
⚠️ 注意：MiMusic 使用单横杠参数（如-help），不支持双横杠参数（如--help）。
服务启动后，访问 http://localhost:58091 即可打开 Web 界面。
使用配置的管理员账号密码登录。
在 Web 界面中点击"扫描"按钮，系统会自动扫描音乐目录中的音频文件并提取元数据。
扫描完成后，即可在界面中浏览和播放音乐。
curl -X POST http://localhost:58091/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"username":"admin","password":"your_password"}'响应示例：
{
"access_token": "eyJhbGci...",
"refresh_token": "eyJhbGci...",
"expires_in": 604800,
"token_type": "Bearer"
}# 获取歌曲列表
curl -X GET http://localhost:58091/api/v1/songs \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
# 获取歌单列表
curl -X GET http://localhost:58091/api/v1/playlists \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"# 查看帮助信息（MiMusic 不支持 --version 参数）
./mimusic-linux-amd64 -help
# 或通过 API 检查版本
curl http://localhost:58091/api/v1/version每个 Release 都包含 checksums.txt 文件，用于验证下载文件的完整性：
# 下载校验和文件
wget https://github.com/mimusic-org/mimusic/releases/latest/download/checksums.txt
# 验证文件
sha256sum -c checksums.txt遇到问题？请查看 常见问题与解决方案 💬
- 操作系统: 🐧 Linux / 🍎 macOS / 🪟 Windows
- 架构: x86_64 / ARM64 / ARMv7
- 可选依赖: 🔧 ffprobe（用于获取音频技术参数，不安装也可正常运行）
- GitHub: mimusic-org/mimusic
- Issues: 问题与反馈
- 💬 加入微信群交流：微信群二维码
- 🐧 QQ群: 979995241
如果这个项目对你有帮助，欢迎通过以下方式支持：
点击右上角的 ⭐ Star 按钮，让更多人发现这个项目
- 💝 爱发电 - 持续支持项目发展
- 扫码请作者喝杯奶茶 ☕
- 📢 分享给更多需要的朋友
- 🐛 提交 Bug 报告和功能建议
- 📝 贡献文档