xiaodid/swingmusic

Swing Music Docker镜像

概述

Swing Music Docker镜像是Swing Music应用的容器化部署方案，旨在简化个人音乐服务器的搭建过程。通过该镜像，用户可快速部署一个支持Web界面的音乐服务，实现本地音乐库的管理、播放与访问。

核心功能和特性

• Web界面访问：通过端口1970提供Web界面，支持音乐播放、库管理等操作
• 本地音乐库集成：支持挂载本地音乐目录，自动识别并管理音乐文件
• 持久化存储：配置文件和音乐数据分别通过卷挂载实现持久化，确保数据不丢失
• 简易部署：通过单条Docker命令即可完成部署，无需复杂配置

使用场景和适用范围

• 个人音乐收藏管理与播放
• 家庭局域网内音乐共享服务
• 需要轻量级音乐服务器的用户
• 希望通过Web界面访问本地音乐库的场景

使用方法

基本部署命令

通过以下Docker命令快速部署Swing Music服务：

bash
docker run -d \
  --name=swingmusic \
  -p 1970:1970 \
  -v /path/to/music:/music \
  -v /path/to/config:/config \
  --restart unless-stopped \
  docker.xuanyuan.run/xiaodid/swingmusic

参数说明

• -d：后台运行容器
• --name=swingmusic：指定容器名称为swingmusic
• -p 1970:1970：端口映射，将容器内1970端口映射到主机1970端口（Web访问端口）
• -v /path/to/music:/music：挂载本地音乐目录到容器内/music，替换/path/to/music为实际音乐文件路径
• -v /path/to/config:/config：挂载本地配置目录到容器内/config，用于持久化配置文件，替换/path/to/config为实际配置存储路径
• --restart unless-stopped：设置容器重启策略，除非手动停止，否则自动重启
• xiaodid/swingmusic：使用的Docker镜像名称

访问服务

部署完成后，通过浏览器访问 http://主机IP:1970 即可打开Swing Music的Web界面。

配置说明

• 音乐目录：/music 目录用于存放音乐文件，支持常见音频格式（具体支持格式请参考Swing Music官方文档）
• 配置目录：/config 目录用于存储应用配置文件，包括用户设置、播放列表等数据
• 如需自定义端口，可修改 -p 参数，格式为 主机端口:1970（容器内端口固定为1970）

更多信息

项目源代码及详细文档：https://github.com/swing-opensource/swingmusic