SongLoft

SongLoft GitHub 仓库: https://github.com/songloft-org/songloft

项目简介

SongLoft (songloft-org/songloft) 是一个轻量级的私有化音乐服务。它支持本地及网络歌曲管理，提供 Flutter 跨平台客户端（Android、iOS、macOS、Windows、Linux）以及 Web 界面，具备 WASM 插件体系与 REST API，非常适合在 NAS 等低功耗设备上部署。

可以让你家闲置的小爱同学，听上你自己搜集的音乐文件。

部署方法 (使用飞牛 OS Docker)

飞牛 OS 的 Docker 功能允许用户便捷地部署各类应用。SongLoft 可以通过 Docker 容器方式进行部署。

1. 准备工作

• 飞牛 OS 系统: 确保你的 NAS 已经安装并运行飞牛 OS。
• SSH 访问 (可选但推荐): 为了更灵活地管理和配置，建议通过 SSH 连接到飞牛 OS 后台 (sudo 命令可能需要)。
• 存储空间: 在飞牛 OS 的存储池中准备一个文件夹，用于存放 SongLoft 的配置文件和挂载的音乐库。例如，你可以在 Docker 或 Media 相关目录下创建一个名为 songloft 的文件夹。

2. 部署步骤

方法一：使用飞牛 OS Docker 图形界面 (推荐新手)

1. 打开飞牛 OS Docker 应用。
2. 拉取镜像:
   • 导航到 镜像仓库。
   • 搜索 songloft-org/songloft 或者项目中可能指定的镜像名 (如果 songloft-org/songloft 没有官方镜像，则查找 README 中提到的 image 名称，例如可能是 songloft/songloft:latest 或类似格式)。
   • 点击 下载 或 Pull 按钮，下载最新的镜像。
3. 创建容器:

# 🌟 完整版（推荐，包含 Web 前端，:latest 即完整版）
docker pull songloft/songloft:latest

# 📦 精简版（不含 Web 前端，需搭配 Flutter 客户端使用）
docker pull songloft/songloft:lite

# 运行容器
docker run -d \
  --name songloft \
  -p 58091:58091 \
  -v /path/to/music:/app/music \
  -v /path/to/data:/app/data \
  -e ADMIN_USERNAME=admin \
  -e ADMIN_PASSWORD='your_strong_password' \
  songloft/songloft:latest

3. 访问与配置

1. 访问 Web 界面: 打开浏览器，访问 http://<你的飞牛OS_IP>:58091 (这里的端口号 30000 对应你在部署步骤中设置的外部端口)。
2. 初始配置: 根据 Web 界面或项目文档的指引，完成 SongLoft 的初始设置，例如扫描音乐库路径（应为容器内挂载的路径，如 /app/music）。
3. 使用客户端: 如果需要使用移动端或桌面客户端，请按照项目文档配置连接地址（通常是你的飞牛 OS IP 和映射的端口）。