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: 如何修改默认密码

A: 如果是 Docker 启动的，可以设置环境变量 ADMIN_PASSWORD，比如：

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:full

如果是 docker compose 启动的，也可以修改 ADMIN_PASSWORD ，比如：

version: '3.8'

services:
  mimusic:
    image: hanxi/mimusic:full
    container_name: mimusic
    restart: always
    ports:
      - "58091:58091"
    volumes:
      - /path/to/music:/app/music
      - /path/to/data:/app/data
    environment:
      - ADMIN_USERNAME=admin
      - ADMIN_PASSWORD=your_secure_password
      - LISTEN_PORT=58091

如果是命令行启动的，可以用 -password 参数，比如：

./mimusic -password your_password

如果是 Windows 平台，可以新建一个 mimusic.bat 文件放到 mimusic.exe 同一个目录，里面写入：

mimusic.exe -password your_password

然后双击 mimusic.bat 文件启动，注意不是双击 mimusic.exe 文件。

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 查看命令行帮助。

系统要求

Q: 必须安装 ffprobe 吗？

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

---

获取帮助

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

评论

没有评论。 链接到 GitHub Issue