Songloft：自托管音乐服务器

项目简介

Songloft 是一款面向个人用户的自托管音乐服务器，插件化、无广告、完全免费。项目用 Go 编写，CGO-free，无外部依赖，适合在 NAS、树莓派等低功耗设备上运行。它本身不提供任何音乐内容，仅用于管理你合法拥有的本地音乐文件。

主要功能

• 本地音乐管理：扫描本地目录，自动提取 MP3/FLAC/WAV/APE/OGG/Opus/M4A/M4B/WMA/AIF/AIFF/MKA/DSF（DSD）等格式的封面和元数据。
• 视频支持：扫描 MP4/MOV/M4V/MKV/WebM/AVI/TS/MPG/MPEG/FLV/WMV/RM/RMVB/3GP 等视频容器并探测真实视频轨，客户端内渲染画面。
• JS 插件体系：基于 QuickJS 沙箱运行，支持权限模型、健康检查、热更新，可扩展音源、元数据、设备控制等能力。
• 跨平台客户端：Flutter 客户端覆盖 Android、iOS、macOS、Windows、Linux、Web 六端，支持后台播放、本地缓存、媒体控制。
• Bundle 本地模式：客户端内嵌 Go 后端，无需部署服务器，手机/电脑直接播放本地音乐。
• Kodi 插件：支持 Xbox、Apple TV、树莓派、Android TV 等大屏设备，专为遥控器操作优化。
• Web 界面：完整版内置 Lynx Web 前端，支持根路径与子路径部署，开箱即用。
• JWT 认证：双 Token 机制（Access Token + Refresh Token），支持多设备管理。
• 网络歌曲 & 电台：支持添加网络音频 URL 与电台流，播放时透明缓存到服务端。
• 完整 REST API：内置 Swagger 文档，方便集成和二次开发。

安装与使用

Songloft 提供三种版本：完整版（含 Web 前端，开箱即用）、精简版（-lite，不含 Web 前端，体积更小）、Bundle 版（客户端内嵌后端，无需服务器）。

二进制文件可从 Releases 下载，按系统和架构选择。Docker 在线安装使用 songloft/songloft:latest（完整版）或 songloft/songloft:lite（精简版），开发版为 :dev、:dev-lite，配置 58091:58091 端口及 /app/data、/app/music 挂载。

直接运行服务器（Linux/macOS）：

chmod +x songloft-linux-amd64
./songloft-linux-amd64

默认端口为 58091，首次启动可通过 ADMIN_USERNAME / ADMIN_PASSWORD 设置管理员账号与密码，未设置时初始账号为 admin/admin。数据保存在运行目录的 data/，升级时保留数据目录。

Windows 用户可通过 Scoop 安装：

scoop bucket add songloft https://github.com/songloft-org/songloft-scoop
scoop install songloft-server

注意事项

• Songloft 不内置、不分发、不存储任何受版权保护的音乐资源，请仅管理自己合法获得的音乐文件。
• 第三方 JS 插件由社区维护，主仓库不预置、不分发任何第三方音源插件成品，使用网络音源等功能时须自行承担版权合规责任。
• 仅供个人非商业使用，严禁用于商业用途或搭建面向不特定多数人的公共服务。
• 官方构建仅上报匿名运行统计（版本号、崩溃栈），自编译版本零遥测。

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