黑糖音乐：中文自托管音乐中心
扫描本地音乐目录，在浏览器中管理歌手、专辑、歌曲、收藏和播放列表的中文私有音乐中心。
黑糖音乐是一套适合个人、家庭和小型团队部署的网页音乐中心。它可以扫描本地音乐目录，自动整理歌手、专辑和歌曲，并通过浏览器完成搜索、播放、收藏和播放列表管理。本次交付已完成简体中文核心界面适配，并用中文演示曲库验证真实媒体扫描、播放队列和音频分段传输。
真实界面
项目截图
共 10 张
Capabilities
核心功能
适用场景
适合谁
希望自托管个人音乐服务的用户、家庭影音爱好者、工作室与门店技术人员，以及学习 Rails、媒体扫描和音频流处理的开发者。
商业化思路
适合私有音乐库、家庭影音服务、门店内部曲库、Rails 媒体应用教学和二次开发。系统本身不附带商业音乐，使用者需要导入自己有权使用的媒体文件。
你会拿到什么
- ✓固定版本完整源码包
- ✓MIT 许可证
- ✓中文部署说明
- ✓十张真实中文功能截图
- ✓中文演示曲库生成脚本
- ✓运行与质量验证记录
部署流程
- 1安装并启动 Docker Desktop
- 2生成随机 SECRET_KEY_BASE 并通过环境变量注入
- 3将音乐目录挂载到容器 /media_data
- 4使用交付 Compose 构建并启动应用
- 5登录后在媒体曲库页面执行同步
- 6访问 /up 检查服务健康状态
真实验证结果
隔离环境已验证 Ruby 4.0.2、Rails 8.1.3 与 SQLite 完整运行；实际扫描 2 位中文歌手、2 张中文专辑和 6 首演示歌曲，创建含 4 首歌曲的播放列表；十个中文核心页面均为 HTTP 200；音频 Range 请求返回 HTTP 206、audio/mpeg；源码、归档、Compose、许可证、截图、汉化、CSS 和公开来源链接八门全部通过。
部署前须知
系统不附带商业音乐；元数据质量取决于原文件标签；大型多用户场景建议切换 PostgreSQL；外部元数据集成需要用户自行配置对应服务凭据。
部署难度
简单
最低配置
建议 2 核 CPU、2 GB 内存、5 GB 系统空间，并根据音乐文件与转码缓存额外预留磁盘。大型曲库或多用户场景建议使用 PostgreSQL。
开源许可证
MIT
最后验证
2026-08-13
技术栈
授权说明
源码根目录声明 MIT License。使用、修改或再分发时请保留原许可证及版权声明；第三方依赖和用户导入的音乐文件需分别遵守其许可与著作权要求。