Songloft · 开源自托管的个人音乐服务器
歌单灰掉的那一天
你在手机上装了三四个音乐 App,每个都充了会员。上周打开最常听的那个歌单,十几首变成了灰色——版权换了家,平台悄悄下架,你连备份都没有。与此同时,电脑硬盘深处那两百多 G 自己买来的 CD 抓轨、下载的无损文件,已经静静躺了五年:想听,得先开电脑、找目录、拷贝到手机。你也试过在 NAS 上装开源音乐服务器,结果一个周末耗在 Docker、数据库和反向代理的报错里,最后曲库封面还是半空白。
听歌这件小事,硬生生被你过成了三项杂活。
一个只放你自己音乐的服务器
Songloft 是开源自托管的个人音乐服务器,它接手的是「自有音乐文件的整理和随处播放」这一段活。
你把音乐文件放进服务器目录,它自动扫描、识别封面和元数据,生成一个带 Web 界面的私人曲库;手机、电脑、电视上的客户端连上就能听,歌单和播放到哪了都跟着账号走。
边界也说清楚:
- 它做:自有音乐文件的扫描、整理、歌单、多端播放、智能音箱和大屏接入
- 它不做:不提供任何音乐内容——出厂曲库是空的,需要自己上传合法拥有的文件;也不是下载或破解工具
通过阿里云计算巢部署,约 2 分钟开箱可用,无需自行安装 Docker、配置数据库和反向代理。

它解决了什么问题
| 你原来怎么干 | 代价 | 用它之后 |
|---|---|---|
| 在流媒体平台开会员听歌 | 到期歌单灰一片,音质受限,平台下架就没得听 | 自有文件随时听,平台政策不再影响你的收藏 |
| 音乐文件散在电脑和 NAS,换设备重新拷贝 | 手机里永远只有"最近想听的那几张" | 一处部署,手机、电脑、电视、音箱连的都是同一个曲库 |
| 自己折腾开源音乐服务器 | 一个周末耗在 Docker、数据库、反向代理报错上 | 一键部署,传文件、点扫描,直接听 |
回到开头那个场景:歌单再灰也不怕了——你的收藏在自己的服务器上,扫一次目录,封面、歌单、播放进度全齐,手机点开就听。
而更深一层的变化是:音乐从「跟着平台走」变成了「跟着自己走」。会员到期、版权搬迁、服务关停,从此都动摇不了你的曲库;收藏这件事,第一次有了"买断"的感觉。
核心能力
曲库整理:扫目录就出封面
把存放音乐的目录给它,MP3、FLAC、WAV、APE、OGG、DSD 等格式的封面和元数据自动提取归档,不用手工给每首歌补信息。
- 格式覆盖广 —— 无损、DSD、有声读物混在一起扫,各归各位
- 网络歌曲与电台 —— 音频 URL 和电台流也能加进曲库,播放时透明缓存到服务端
随处播放:一个曲库,六端客户端
Web 界面开箱即用,Flutter 客户端覆盖 Android、iOS、macOS、Windows、Linux,Kodi 插件接管电视和盒子。
- 六端同库 —— 手机上听到一半,电脑上打开从同一秒继续
- 客厅大屏 —— 遥控器操作的 Kodi 插件,专为电视场景优化

歌单与续播:听到哪都算数
歌单和歌曲共用自定义标签,普通歌单记住歌曲、毫秒级位置和播放模式。
- 有声书续听 —— 听到 32 分 17 秒关掉,下次任何设备打开接着听
- 多设备管理 —— JWT 双 Token 登录,永久访问 Token 给设备集成用,可单独撤销
插件扩展:功能不够,不用等排期
插件基于 QuickJS 沙箱运行,带权限模型和热更新。
- 插件体系 —— Subsonic 兼容接口、WebDAV 等能力以插件形式提供,想扩展音源、元数据、设备控制自己动手
- REST API —— 内置 Swagger 文档,方便接入自己的自动化
谁最该用
| 用户类型 | 典型场景 | 用它拿到什么 |
|---|---|---|
| 音乐收藏者 | 硬盘里躺着多年攒下的无损文件 | 十分钟变成随时可听的私人曲库 |
| 家庭影音玩家 | 电视、音箱、手机都想放同一批音乐 | 一个服务器喂饱全屋设备 |
| NAS / 低功耗设备玩家 | 想在树莓派或 NAS 上跑服务 | Go 编写、无外部依赖,低功耗设备也带得动 |
技术支持
- 官方仓库:https://github.com/songloft-org/songloft
- 官方网站与文档:https://songloft.hanxi.cc/
- 问题反馈:GitHub Issues
🚀 立即体验
→ 一键部署 Songloft
部署完成后,用 admin 和实例输出里的初始密码登录,先把音乐文件上传到实例的音乐目录,再到设置页触发一次扫描,你的曲库就活了。