swingmx/swingmusic

这是什么？

核心功能

• 01扫描本地音频文件，并通过规范化元数据和专辑版本标签进行整理。
• 02提供每日推荐歌单、相关艺人与专辑，以及用于分组的收藏集。
• 03支持按文件夹浏览音乐库。
• 04提供收听统计，并支持 Last.fm 上报。
• 05结合淡入淡出与静音检测，实现无缝播放。
• 06支持多用户，并提供 Windows、Linux、macOS 的 x86 与 arm64 版本。

适用场景

• 不依赖订阅服务，在浏览器或家庭网络中播放个人的 MP3 或 FLAC 音乐库。
• 为家庭搭建音乐服务器，并为每位成员设置独立账户。
• 通过配套的 Android 客户端在手机上播放自托管的音乐库。

快速上手

1. 1

   拉取 Docker 镜像

   docker pull ghcr.io/swingmx/swingmusic:latest
2. 2

   运行容器，并将音乐和配置路径替换为你自己的路径

   docker run --name swingmusic -p 1970:1970 -e SWINGMUSIC_PORT=1970 -e SWINGMUSIC_DEVICE_NAME="Host Name Here" -v /path/to/music:/music -v /path/to/config:/config --restart unless-stopped ghcr.io/swingmx/swingmusic:latest
3. 3

   在浏览器中打开 http://localhost:1970 以配置并使用 Swing Music

使用前须知

• !许可证为 AGPL-3.0，这是一种 Copyleft 许可证，要求基于其修改的网络服务公开源代码。
• !README 的跨平台功能列表中将 macOS 支持标注为“即将推出”，但其安装说明也提到了 macOS。

收录于专题

标签

常见问题

swingmusic 是什么？

一款自托管的音乐流媒体服务器，附带浏览器端播放器，用于播放你自己的本地音乐文件。 Swing Music 是一款自托管的音乐服务器，会索引你指定的本地音频文件夹，并通过浏览器端播放器提供播放。它面向希望获得类似 Spotify 听歌体验、同时完全掌控自己音乐库的用户。

swingmusic 可以免费使用吗？用的什么许可证？

swingmusic 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

swingmusic 还在维护吗？

活跃维护中。swingmusic 最近一次提交是在 2026年11月6日。

swingmusic 适合用来做什么？

不依赖订阅服务，在浏览器或家庭网络中播放个人的 MP3 或 FLAC 音乐库。 为家庭搭建音乐服务器，并为每位成员设置独立账户。 通过配套的 Android 客户端在手机上播放自托管的音乐库。

swingmusic 怎么安装和运行？

拉取 Docker 镜像: docker pull ghcr.io/swingmx/swingmusic:latest 运行容器，并将音乐和配置路径替换为你自己的路径: docker run --name swingmusic -p 1970:1970 -e SWINGMUSIC_PORT=1970 -e SWINGMUSIC_DEVICE_NAME="Host Name Here" -v /path/to/music:/music -v /path/to/config:/config --restart unless-stopped ghcr.io/swingmx/swingmusic:latest 在浏览器中打开 http://localhost:1970 以配置并使用 Swing Music

在哪里获取 swingmusic？

源代码和安装说明在 GitHub 上：https://github.com/swingmx/swingmusic