尧图网站建设 
Songloft完整使用指南从扫描曲库到手机播放的6步快速上手【免费下载链接】songloft 插件化、无广告的免费音乐服务器项目地址: https://gitcode.com/gh_mirrors/so/songloftSongloft 是一款插件化、无广告的免费音乐服务器开源自托管音乐服务器用 Go 编写无需 CGO 依赖扫描本地曲库、自动提取封面和元数据即可在手机、电脑、NAS、树莓派上随时随地播放自己的音乐。本文带你用 6 步从零搭起属于自己的音乐服务器。 第1步部署并启动 Songloft 音乐服务器Songloft 提供三种部署方式新手推荐Docker 部署NAS 用户尤其推荐docker run -d \ --name songloft \ -p 58091:58091 \ -v /path/to/music:/app/music \ -v /path/to/data:/app/data \ -e ADMIN_USERNAMEadmin \ -e ADMIN_PASSWORDyour_strong_password \ songloft/songloft:latest三个关键点/path/to/music指向你存放音乐的目录Docker 内挂载为/app/music/path/to/data存放数据库和缓存的目录 默认账号admin/admin仅适合本地测试对外访问前务必设置强密码Windows / macOS 用户可直接下载完整版二进制创建music与data目录后运行songloft.exe即可无需 Docker。⚠️ 安全提醒默认管理员账号admin / admin只能用于本地测试多设备访问的部署请先通过ADMIN_PASSWORD环境变量设置强密码再启动。 第2步登录 Web 界面并配置音乐目录服务启动后浏览器访问http://localhost:58091远程设备则填服务器 IP即可打开内置 Web 界面完整版开箱即用精简版需搭配 Flutter 客户端。用第 1 步设置的账号密码登录后进入「设置 → 音乐库管理」配置音乐目录Docker 部署音乐目录填/app/music二进制部署填你的音乐文件夹绝对路径同时在设置中可选择亮色 / 暗色主题以及开启哪些功能菜单歌曲库、歌单、智能音箱、插件等。 第3步一键扫描曲库自动提取封面与元数据在「音乐库管理」中点击扫描按钮Songloft 会异步扫描音乐目录下的所有音频文件 支持 MP3 / FLAC / WAV / APE / OGG / Opus / M4A / WMA / AIFF / MKA 等格式️ 自动提取封面、歌手、专辑、年份、流派等元数据 还能识别 MP4 / MKV / MOV 等视频文件并探测视频轨 扫描进度实时可见可随时取消扫描支持「自动创建歌单」「歌单归并模式」「自动计算音频指纹」等选项适合按艺术家 / 专辑整理曲库的用户。扫描逻辑实现于 internal/handlers/scan.go、扫描进度模型见 internal/services/scan_progress.go。 第4步浏览歌曲库管理你的歌单扫描完成后首页即展示「我的歌单」卡片墙进入歌曲库可按「全部 / 本地 / 网络 / 电台」筛选、搜索歌曲支持按封面、歌手、专辑浏览。歌单功能很完整✅ 新建 / 收藏 / 置顶歌单拖拽排序 歌单导入导出备份曲库结构很方便 支持添加网络歌曲 URL 与电台流播放时自动缓存到服务端 播放历史自动记录 第5步手机连接服务器开始播放手机上有三种玩法① 浏览器直接访问零安装 手机浏览器打开http://服务器IP:58091Web 界面自适应移动端可直接播放。② Flutter 客户端体验最佳 官方 Flutter 客户端支持 Android / iOS / macOS / Windows / Linux / Web 六端登录页填入服务器地址即可连接支持后台播放、本地缓存、锁屏 / 耳机媒体控制等 Web 端无法实现的能力。③ Bundle 本地模式无需服务器 下载songloft-bundled-*客户端首次启动点击「使用本地模式」→ 选择手机内的音乐目录 → 自动完成手机直接播放本地音乐随时可在设置中切换本地 / 远程模式。播放界面为沉浸式全屏设计大封面、进度条、播放控制一应俱全。⚙️ 第6步进阶配置让音乐服务器更强大基础流程跑通后这些进阶能力可以让 Songloft 更顺手功能说明设置入口 JS 插件QuickJS 沙箱运行可扩展音源 / 元数据 / 设备控制支持权限模型与热更新设置 → 扩展 自动扫描定时增量扫描新音乐自动入库设置 → 音乐库管理 缓存管理网络歌曲 / 电台透明缓存统计与清理设置 → 缓存管理 Subsonic API兼容 Subsonic 协议接入第三方客户端插件管理️ Kodi 插件Xbox / Apple TV / 树莓派等大屏遥控器操作官方 Kodi 插件仓库常用环境变量速查完整说明见仓库根目录 README.mdADMIN_USERNAME # 管理员用户名默认 admin ADMIN_PASSWORD # 管理员密码默认 admin LISTEN_PORT # 服务端口默认 58091 DB_PATH # 数据库文件路径默认 data/songloft.db BASE_PATH # 反向代理子路径部署如 /songloft MUSIC_DIR # 音乐目录非空时覆盖数据库默认值 需要克隆源码自行编译时仓库地址为https://gitcode.com/gh_mirrors/so/songloft克隆后执行make build即可得到完整版二进制。 总结6 步拥有自己的免费音乐服务器步骤操作耗时1️⃣ 部署Docker / 二进制启动挂载音乐目录5 分钟2️⃣ 登录浏览器访问 58091 端口配置音乐目录2 分钟3️⃣ 扫描一键扫描自动提取封面与元数据视曲库大小4️⃣ 管理浏览歌曲库创建 / 整理歌单随心5️⃣ 播放手机 Web / Flutter 客户端 / Bundle 模式2 分钟6️⃣ 进阶插件、自动扫描、缓存管理可选Songloft 完全免费、无广告、永久开源适合个人管理自己合法拥有的音乐。从docker run一条命令到手机上播放第一首歌整个过程不超过 10 分钟——现在就可以开始搭建你的私有音乐服务器了 更多界面截图与部署细节可参考文档docs/screenshots.md、常见问题 docs/faq.md【免费下载链接】songloft 插件化、无广告的免费音乐服务器项目地址: https://gitcode.com/gh_mirrors/so/songloft创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Songloft完整使用指南：从扫描曲库到手机播放的6步快速上手
Songloft完整使用指南从扫描曲库到手机播放的6步快速上手【免费下载链接】songloft 插件化、无广告的免费音乐服务器项目地址: https://gitcode.com/gh_mirrors/so/songloftSongloft 是一款插件化、无广告的免费音乐服务器开源自托管音乐服务器用 Go 编写无需 CGO 依赖扫描本地曲库、自动提取封面和元数据即可在手机、电脑、NAS、树莓派上随时随地播放自己的音乐。本文带你用 6 步从零搭起属于自己的音乐服务器。 第1步部署并启动 Songloft 音乐服务器Songloft 提供三种部署方式新手推荐Docker 部署NAS 用户尤其推荐docker run -d \ --name songloft \ -p 58091:58091 \ -v /path/to/music:/app/music \ -v /path/to/data:/app/data \ -e ADMIN_USERNAMEadmin \ -e ADMIN_PASSWORDyour_strong_password \ songloft/songloft:latest三个关键点/path/to/music指向你存放音乐的目录Docker 内挂载为/app/music/path/to/data存放数据库和缓存的目录 默认账号admin/admin仅适合本地测试对外访问前务必设置强密码Windows / macOS 用户可直接下载完整版二进制创建music与data目录后运行songloft.exe即可无需 Docker。⚠️ 安全提醒默认管理员账号admin / admin只能用于本地测试多设备访问的部署请先通过ADMIN_PASSWORD环境变量设置强密码再启动。 第2步登录 Web 界面并配置音乐目录服务启动后浏览器访问http://localhost:58091远程设备则填服务器 IP即可打开内置 Web 界面完整版开箱即用精简版需搭配 Flutter 客户端。用第 1 步设置的账号密码登录后进入「设置 → 音乐库管理」配置音乐目录Docker 部署音乐目录填/app/music二进制部署填你的音乐文件夹绝对路径同时在设置中可选择亮色 / 暗色主题以及开启哪些功能菜单歌曲库、歌单、智能音箱、插件等。 第3步一键扫描曲库自动提取封面与元数据在「音乐库管理」中点击扫描按钮Songloft 会异步扫描音乐目录下的所有音频文件 支持 MP3 / FLAC / WAV / APE / OGG / Opus / M4A / WMA / AIFF / MKA 等格式️ 自动提取封面、歌手、专辑、年份、流派等元数据 还能识别 MP4 / MKV / MOV 等视频文件并探测视频轨 扫描进度实时可见可随时取消扫描支持「自动创建歌单」「歌单归并模式」「自动计算音频指纹」等选项适合按艺术家 / 专辑整理曲库的用户。扫描逻辑实现于 internal/handlers/scan.go、扫描进度模型见 internal/services/scan_progress.go。 第4步浏览歌曲库管理你的歌单扫描完成后首页即展示「我的歌单」卡片墙进入歌曲库可按「全部 / 本地 / 网络 / 电台」筛选、搜索歌曲支持按封面、歌手、专辑浏览。歌单功能很完整✅ 新建 / 收藏 / 置顶歌单拖拽排序 歌单导入导出备份曲库结构很方便 支持添加网络歌曲 URL 与电台流播放时自动缓存到服务端 播放历史自动记录 第5步手机连接服务器开始播放手机上有三种玩法① 浏览器直接访问零安装 手机浏览器打开http://服务器IP:58091Web 界面自适应移动端可直接播放。② Flutter 客户端体验最佳 官方 Flutter 客户端支持 Android / iOS / macOS / Windows / Linux / Web 六端登录页填入服务器地址即可连接支持后台播放、本地缓存、锁屏 / 耳机媒体控制等 Web 端无法实现的能力。③ Bundle 本地模式无需服务器 下载songloft-bundled-*客户端首次启动点击「使用本地模式」→ 选择手机内的音乐目录 → 自动完成手机直接播放本地音乐随时可在设置中切换本地 / 远程模式。播放界面为沉浸式全屏设计大封面、进度条、播放控制一应俱全。⚙️ 第6步进阶配置让音乐服务器更强大基础流程跑通后这些进阶能力可以让 Songloft 更顺手功能说明设置入口 JS 插件QuickJS 沙箱运行可扩展音源 / 元数据 / 设备控制支持权限模型与热更新设置 → 扩展 自动扫描定时增量扫描新音乐自动入库设置 → 音乐库管理 缓存管理网络歌曲 / 电台透明缓存统计与清理设置 → 缓存管理 Subsonic API兼容 Subsonic 协议接入第三方客户端插件管理️ Kodi 插件Xbox / Apple TV / 树莓派等大屏遥控器操作官方 Kodi 插件仓库常用环境变量速查完整说明见仓库根目录 README.mdADMIN_USERNAME # 管理员用户名默认 admin ADMIN_PASSWORD # 管理员密码默认 admin LISTEN_PORT # 服务端口默认 58091 DB_PATH # 数据库文件路径默认 data/songloft.db BASE_PATH # 反向代理子路径部署如 /songloft MUSIC_DIR # 音乐目录非空时覆盖数据库默认值 需要克隆源码自行编译时仓库地址为https://gitcode.com/gh_mirrors/so/songloft克隆后执行make build即可得到完整版二进制。 总结6 步拥有自己的免费音乐服务器步骤操作耗时1️⃣ 部署Docker / 二进制启动挂载音乐目录5 分钟2️⃣ 登录浏览器访问 58091 端口配置音乐目录2 分钟3️⃣ 扫描一键扫描自动提取封面与元数据视曲库大小4️⃣ 管理浏览歌曲库创建 / 整理歌单随心5️⃣ 播放手机 Web / Flutter 客户端 / Bundle 模式2 分钟6️⃣ 进阶插件、自动扫描、缓存管理可选Songloft 完全免费、无广告、永久开源适合个人管理自己合法拥有的音乐。从docker run一条命令到手机上播放第一首歌整个过程不超过 10 分钟——现在就可以开始搭建你的私有音乐服务器了 更多界面截图与部署细节可参考文档docs/screenshots.md、常见问题 docs/faq.md【免费下载链接】songloft 插件化、无广告的免费音乐服务器项目地址: https://gitcode.com/gh_mirrors/so/songloft创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考