shlomip/swingmusic

Swing Music Docker镜像文档

镜像概述

Swing Music Docker镜像是基于GitHub仓库https://github.com/swing-opensource/swingmusic%E6%9E%84%E5%BB%BA%E7%9A%84%E5%8D%B3%E7%94%A8%E5%9E%8B%E5%AE%B9%E5%99%A8%EF%BC%8C%E6%97%A8%E5%9C%A8%E7%AE%80%E5%8C%96Swing Music应用的部署流程，提供便捷的音乐服务运行环境。

核心功能与特性

• 持久化存储：支持音乐文件（/music目录）和配置文件（/config目录）的持久化，确保数据不丢失
• 固定端口暴露：默认通过1970端口提供服务，便于网络访问
• 自动重启：支持容器退出后的自动重启策略（除非手动停止）
• 快速部署：提供Docker CLI和Docker Compose两种部署方式，开箱即用

使用场景

• 个人音乐库管理与播放服务部署
• 本地音乐服务搭建
• 需要便捷运行Swing Music应用的场景

使用方法

Docker CLI部署

通过以下命令快速启动容器：

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/shlomip/swingmusic:latest

参数说明：

• -d：后台运行容器
• --name=swingmusic：指定容器名称为swingmusic
• -p 1970:1970：将容器1970端口映射到主机1970端口（主机端口可根据需要修改，如-p 8080:1970）
• -v /path/to/music:/music：挂载本地音乐目录到容器内，替换/path/to/music为实际音乐文件路径
• -v /path/to/config:/config：挂载本地配置目录到容器内，替换/path/to/config为实际配置文件存储路径
• --restart unless-stopped：容器退出时自动重启（手动停止除外）

Docker Compose部署

创建docker-compose.yml文件，内容如下：

yaml
version: "3.8"
services:
  swingmusic:
    image: docker.xuanyuan.run/shlomip/swingmusic:latest
    container_name: swingmusic
    volumes:
      - /path/to/music:/music  # 本地音乐目录映射
      - /path/to/config:/config  # 本地配置目录映射
    ports:
      - 1970:1970  # 端口映射
    restart: unless-stopped  # 重启策略

执行以下命令启动服务：

bash
docker-compose up -d

配置说明

• 音乐目录：需将/path/to/music替换为本地实际存放音乐文件的目录，容器将读取该目录下的音乐文件
• 配置目录：/path/to/config为配置文件存储目录，用于保存应用的设置和状态信息
• 端口修改：如需使用不同主机端口，修改ports配置中的主机端口部分（如8080:1970表示使用主机8080端口）
• 重启策略：默认使用unless-stopped，可根据需求调整为always、on-failure等