MiMusic 常见问题解答 (FAQ)

安装与部署

Q: 我应该如何下载 MiMusic？

A: 从 GitHub Releases 下载适合您系统的版本。支持 Linux、macOS 和 Windows 平台，提供二进制文件和 Docker 镜像两种部署方式。

Q: 支持哪些操作系统和架构？

A: 支持以下平台：

• Linux: x86_64、ARM64、ARMv7
• macOS: x86_64 (Intel)、ARM64 (Apple Silicon)
• Windows: x86_64、ARM64

Q: Docker 部署时容器无法访问音乐文件怎么办？

A: 确保使用绝对路径挂载卷：

docker run -d \
  -v /absolute/path/to/music:/app/music \
  -v /absolute/path/to/data:/app/data \
  hanxi/mimusic:latest

配置与运行

Q: 如何修改服务端口？

A: 有两种方式：

1. 使用命令行参数：./mimusic --port 8080
2. 使用环境变量：PORT=8080 ./mimusic

默认端口为 58091。

Q: 如何配置管理员账号？

A: 通过环境变量设置：

export ADMIN_USERNAME=admin
export ADMIN_PASSWORD=your_secure_password

或在 Docker 中使用 -e 参数传递。

Q: 支持哪些音乐文件格式？

A: 支持主流音频格式：MP3、FLAC、WAV、APE、OGG、M4A 等。

使用问题

Q: 音乐文件无法播放怎么办？

A: 检查以下几点：

1. 确认音乐文件格式是否受支持
2. 确保音乐文件路径配置正确
3. 检查文件权限是否允许读取
4. 可选安装 ffprobe 以获取更完整的音频技术参数

Q: 如何扫描音乐库？

A: 启动服务后，在 Web 界面中点击 "扫描" 按钮，系统会自动扫描配置的音乐目录并提取元数据。

升级与维护

Q: 如何升级或更新 MiMusic？

A:

1. 下载最新版本的二进制文件或 Docker 镜像
2. 停止当前服务
3. 替换二进制文件或更新 Docker 镜像
4. 重新启动服务

如果升级后出现异常，可尝试删除 data/mimusic.db 后重启（会丢失用户数据）。

Q: 如何验证下载文件的完整性？

A: 每个 Release 都包含 checksums.txt 文件：

wget https://github.com/mimusic-org/mimusic/releases/latest/download/checksums.txt
sha256sum -c checksums.txt

Q: 如何查看当前版本？

A:

• 命令行：./mimusic -help（查看帮助信息和可用参数）
• API: curl http://localhost:58091/api/v1/version

注意：MiMusic 不支持 --version 参数，请使用 -help 查看命令行帮助。

API 使用

Q: 如何通过 API 获取访问令牌？

A:

curl -X POST http://localhost:58091/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"your_password"}'

响应中包含 access_token，用于后续 API 请求的认证。

Q: 如何在 API 请求中使用 Token？

A: 在请求头中添加 Authorization：

curl -X GET http://localhost:58091/api/v1/songs \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

系统要求

Q: 必须安装 ffprobe 吗？

A: 不是必须的。MiMusic 可以不依赖 ffprobe 正常运行，但安装后可以获取更完整的音频技术参数信息。

---

获取帮助

• GitHub Issues: https://github.com/mimusic-org/mimusic/issues
• 项目主页: https://github.com/mimusic-org/mimusic

评论

没有评论。 链接到 GitHub Issue