wandergame/wandermusic repository overview

⁠WanderMusic 个人音乐服务器

Wander Music 是一个个人搭建的音乐服务器，允许用户管理和流式播放本地存储的音乐。该服务器通过简单的 API 提供音乐文件的管理和播放功能。

⁠功能特色

• 支持多种数据库（SQLite、MySQL、MariaDB）
• 配置灵活，通过环境变量即可轻松设置
• 本地文件存储，用于日志和数据库等
• 自动检索音乐文件和缓存专辑封面、歌词等

⁠一、镜像获取

你可以从 Docker Hub 获取该镜像，使用以下命令：

docker pull wandergame/wandermusic:[标签]

通常使用latest标签获取最新版本镜像，也可指定特定版本号以获取固定版本。

⁠二、镜像使用

⁠（一）启动容器

通过以下命令启动容器：

docker pull wandergame/wandermusic
docker run -d \
    --name wander-music \
    -p 4300:4300 \
    -v /your/local/data:/app/data \
    -v /your/local/music:/app/assets/music \
    -v /your/local/cache:/app/assets/cache \
    -e DB_TYPE=sqlite \
    wandergame/wandermusic

使用 docker-compose.yml 配置您的服务：

version: '3.7'

services:
  wandermusic:
    image: wandergame/wandermusic
    ports:
      - "4300:4300"
    volumes:
      - /your/local/data:/app/data
      - /your/local/music:/app/assets/music
      - /your/local/cache:/app/assets/cache
    environment:
      DB_TYPE: mysql
      DB_HOST: 192.168.1.100
      DB_PORT: 3306
      DB_USER: root
      DB_PASSWORD: ${DB_PASSWORD}
      DB_NAME: wandermusic

-d：使容器在后台运行。

-p [主机端口]:4300：将容器的 4300 端口映射到主机指定端口，以便通过主机该端口访问音乐服务器。请将[主机端口]替换为主机上未被占用的端口号。

-v [主机数据目录]:/app/data：将主机目录挂载到容器内的/app/data目录，用于存放日志、SQLite 数据库等本地数据文件。请将[主机数据目录]替换为实际的主机路径。

-v [主机音乐目录]:/app/assets/music：将主机上存放音乐文件的目录挂载到容器内的/app/assets/music目录，使服务器能够读取音乐文件。请将[主机音乐目录]替换为实际的音乐文件存储路径。

-v [主机缓存目录]:/app/assets/cache：将主机目录挂载到容器内的/app/assets/cache目录，用于存储音乐解析产生的专辑封面、歌词等缓存文件。请将[主机缓存目录]替换为实际的主机路径。

-e DB_TYPE=[数据库类型]：设置数据库类型，支持sqlite、mysql、mariadb。

若选择sqlite，服务器将使用内置的 SQLite 数据库，无需配置其他数据库相关环境变量。

若选择mysql或mariadb，需同时配置以下环境变量：

-e DB_HOST=[数据库地址]：数据库服务器的地址。

-e DB_PORT=[数据库端口]：数据库服务监听的端口。

-e DB_USER=[数据库用户]：用于连接数据库的用户名。

-e DB_PASSWORD=[数据库密码]：上述用户对应的密码。

-e DB_NAME=[数据库名字]：需提前创建好的数据库名称。

⁠（二）访问音乐服务器

容器启动成功后，在浏览器中输入http://主机IP:[主机端口]，即可打开音乐服务器界面。首次登录时，默认用户名和密码均为 admin。建议登录后尽快修改密码以确保服务器安全。

⁠（三）支持的音频格式

本音乐服务器支持多种常见音频格式，方便你将个人音乐库整合到服务器中，具体支持的格式如下：

• .mp3：广泛使用的有损音频格式，兼容性强。
• .flac：流行的无损音频格式，能保留原始音频的高音质。
• .m4a：常用于苹果设备的音频格式，音质表现出色。
• .wav：一种无损音频格式，常用于专业音频录制和编辑。
• .ogg：开源的音频格式，具有较好的压缩比和音质。
• .wma：微软开发的音频格式，在 Windows 系统上有良好支持。
• .ape：一种无损音频压缩格式，以高压缩比著称。

将上述格式的音乐文件放置在挂载的主机音乐目录 [主机音乐目录] 下，服务器会自动扫描更新音乐库。

⁠三、本地目录说明

/app/data：用于存放本地数据文件，例如日志文件以及 SQLite 数据库文件等。

/app/assets/music：此为音乐文件所在目录，服务器会自动扫描该目录下的音乐文件。

/app/assets/cache：该目录用于存放音乐解析过程中产生的专辑封面、歌词等缓存文件。