Swing Music：自托管音乐流媒体服务器

项目简介

Swing Music 是一个自托管的音乐流媒体服务器，用来播放你本地的音频文件。它把个人收藏的音乐库变成一个界面漂亮、响应快速的网页播放器，在浏览器里访问即可使用，风格类似 Spotify，但曲库完全由你自己提供。项目使用 Python 编写，采用 AGPL-3.0 协议开源。

主要功能

• 每日 Mix：根据收听活动每天生成推荐混音
• 元数据规范化：整理出干净统一的音乐库
• 专辑版本管理：关联 Deluxe、Remaster 等版本标签
• 关联艺术家与专辑推荐
• 文件夹视图：按目录浏览音乐库
• 基于浏览器的界面，打开网页即可使用
• 静音检测：与交叉淡入淡出配合，实现无缝播放
• Collections：按自己的偏好把专辑和艺术家分组
• 统计：查看收听活动数据
• Last.fm scrobbling
• 多用户支持
• 跨平台：Windows、Linux、macOS（即将推出），支持 arm64、x86

安装与使用

Linux 或 macOS 可以用官方脚本一键安装：

curl -fsSL https://setup.swingmx.com | bash

Windows 用户从下载页获取便携版直接运行。程序默认启动在 http://localhost:1970，在浏览器中打开该地址即可完成配置并使用。

Docker 方式拉取镜像：

docker pull ghcr.io/swingmx/swingmusic:latest

运行时把宿主机的音乐目录挂载到 /music、配置目录挂载到 /config，并映射 1970 端口；SWINGMUSIC_DEVICE_NAME 用于设置服务器在已连接客户端中显示的名称，如需换端口则同时修改端口映射和 SWINGMUSIC_PORT。想在 Android 手机上收听，可以配合官方的 Android 客户端使用。

在终端启动程序时可以附加参数调整运行时设置，使用 -h 查看全部支持的选项。

注意事项

• 从 v3.0.0 起，Mixes（每日混音）成为付费功能，需要购买许可证或在 GitHub 上赞助项目后才能使用。
• 网页客户端使用 Blurhash 前需要重新扫描音乐库。
• 项目仍在寻找贡献者，使用中遇到问题可查阅官方文档。

---

本作品整理自 GitHub 开源项目 swingmx/swingmusic，原作者 @swingmx，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。