Songloft是一款专门给个人用户准备的轻量自托管音乐管理方案，装上之后直接扫描本地磁盘，MP3、FLAC、WAV、APE、OGG、M4A这些常见格式都能认出来，封面、歌手、专辑之类的内嵌信息也会同步提取好。如果手里有合法获取的网络音频直链，同样能把它拉到本地，再按歌单分好文件夹、理顺文件名，顺手把缺失的封面、歌词和标签补全，以后想找某首歌就省事多了。这工具还有权限管理、健康检查、热更新这些运维向功能，也支持扩展音源、元数据抓取和设备控制，对于喜欢折腾自托管音乐服务的人来说，可玩的地方不算少。把积攒多年的收藏导进去之后，用户可以按自己的习惯慢慢归置目录和歌单，那些散落在各个硬盘角落的歌，最终能变成一套完全归自己管的私人曲库。

Songloft的几个吸引人的地方

1、数据彻底握在自己手里

音乐文件、账号资料、播放历史全都留在本机，项目采用Apache-2.0协议开源，既没有遥测上报也没有广告打扰。

2、资源占用非常克制

后端用Go写的，编译出来就一个单文件，不依赖C库，10MB内存就能跑起来，放在NAS、树莓派或者迷你主机上都毫无压力。

3、六个平台客户端全覆盖

客户端基于Flutter开发，一套代码通吃Android、iOS、macOS、Windows、Linux和Web，换设备无缝衔接。

4、弹性的沙箱插件机制

插件跑在QuickJS隔离环境里，需要音源、元数据还是设备控制都能按需加装，权限模型加上热更新和健康检查，扩展起来心里有底。

5、常见音频格式通吃

MP3/FLAC/WAV/APE/OGG/M4A自动识别不在话下，封面、歌词、元数据也能一键抽取出来。

6、网络歌曲也能落盘

碰到喜欢的网络歌曲，点一下就能离线存到本地，自动按歌单归类目录，标签、封面和歌词也会一并写回去。

Songloft App功能速览

1、音频格式兼容性广：Songloft能处理MP3、FLAC、WAV、APE、OGG、M4A等20多种音频格式，封面、歌手、专辑这类元数据自动抽取。

2、玩法多样的扩展能力：基于QuickJS沙箱的JS插件体系，能自定义音源或设备控制，比如接上小爱音箱实现语音点歌这种操作。

3、跨平台播放体验：官方提供Android、iOS、macOS、Windows、Linux、Web六个端，多设备访问同一个音乐库很顺畅。

4、一些实用的加分项：支持DLNA/AirPlay投屏、网络音频URL和电台流接入、JWT多设备认证，还内置Swagger接口文档方便二次开发。

Songloft软件细节

本地音乐整理——扫描指定目录，自动把MP3/FLAC/WAV/APE/OGG/Opus/M4A/M4B/WMA/AIF/AIFF/MKA等格式的封面和元数据抓取出来

JWT认证——采用双Token机制（AccessToken配合RefreshToken），多设备管理不在话下

网络歌曲与电台——能加网络音频直链和电台流，播放时会透明缓存到服务端

视频文件支持——可扫描MP4/MOV/M4V/MKV/WebM/AVI/TS/MPG/MPEG/FLV/WMV/RM/RMVB/3GP等容器格式并能探测真实视频轨，客户端内直接渲染画面

JS插件体系——跑在QuickJS沙箱里，具备权限模型、健康检查和热更新，扩展音源、元数据、设备控制都随你

完整REST API——内置Swagger文档，想集成或做二次开发都很顺手

轻量高效——Go实现，CGO-free，无外部依赖，NAS或树莓派这类低功耗设备跑得动

跨平台客户端——Flutter编写，Android、iOS、macOS、Windows、Linux、Web六端齐活

Bundle本地模式——客户端内嵌Go后端，不部署服务器也能用，手机或电脑直接播本地文件

Kodi插件客户端——照顾Xbox、AppleTV、树莓派、AndroidTV这些大屏设备，交互为遥控器优化过，客厅里用着挺顺手

Web界面——完整版自带Web前端，装好即用，不用额外配