bitnik212/swingmusic

Swing Music Docker镜像文档

https://github.com/swing-opensource/swingmusic | https://github.com/Bitnik212/swingmusic-docker

截图展示

镜像概述

Swing是一款为本地音频文件设计的音乐播放器，兼顾视觉美观与功能实用性。它采用自托管模式，只需运行应用即可通过网页浏览器访问和管理您的音乐库，让本地音乐聆听体验重新变得有趣。

注意：该项目处于早期开发阶段，部分功能仍在完善中，更多特性将逐步添加。

核心功能和特性

• 本地音乐管理：支持播放本地存储的音频文件，自动整理音乐库
• 网页界面访问：通过浏览器即可访问，无需安装额外客户端
• 美观视觉设计：注重界面视觉效果，提供沉浸式音乐体验
• 灵活配置选项：支持自定义主机地址、端口及音乐标题显示格式
• 跨设备访问：可通过本地网络在多设备上访问音乐库

使用场景和适用范围

• 个人本地音乐库管理与播放
• 家庭网络内音乐共享
• 无需依赖第三方音乐服务的私有音乐解决方案
• 追求视觉体验的本地音乐爱好者

使用方法和配置说明

Docker CLI部署

1. 创建配置数据卷

bash
docker volume create swingmusic-config

2. 运行Docker容器

bash
docker run -p 1970:1970 \
  -v "本地音乐文件夹路径":/root/music \
  -v swingmusic-config:/root/.config/swingmusic \
  docker.xuanyuan.run/bitnik212/swingmusic:latest

参数说明：

• -p 1970:1970：端口映射，将容器的1970端口映射到主机的1970端口
• -v "本地音乐文件夹路径":/root/music：挂载本地音乐文件夹到容器内（需替换为实际音乐文件夹路径）
• -v swingmusic-config:/root/.config/swingmusic：挂载配置数据卷，保存应用设置

命令行选项

启动容器时可通过添加命令行参数自定义配置：

bash
docker run ... bitnik212/swingmusic:latest [选项]

支持的选项：

• --host：设置主机地址（如--host 0.0.0.0允许局域网访问）
• --port：设置端口号（如--port 8080更改访问端口）
• --show-feat, -sf：不从歌曲标题中提取合作艺术家
• --show-prod, -sp：不隐藏歌曲标题中的制作人信息
• --help, -h：显示帮助信息
• --version, -v：显示应用版本

局域网访问配置

要在局域网内访问Swing音乐播放器，需指定--host参数：

bash
docker run -p 1970:1970 \
  -v "本地音乐文件夹路径":/root/music \
  -v swingmusic-config:/root/.config/swingmusic \
  docker.xuanyuan.run/bitnik212/swingmusic:latest --host 0.0.0.0

启动后，终端会显示访问链接，可在局域网内其他设备的浏览器中打开该链接访问音乐库。

许可证

本软件基于MIT许可证开源，详细条款见项目根目录下的LICENSE文件。

https://opensource.org/licenses/MIT | Copyright (c) 2023 Mungai Njoroge