影音娱乐个人工具家庭服务软件开发

黑糖音乐：中文自托管音乐中心

扫描本地音乐目录，在浏览器中管理歌手、专辑、歌曲、收藏和播放列表的中文私有音乐中心。

黑糖音乐是一套适合个人、家庭和小型团队部署的网页音乐中心。它可以扫描本地音乐目录，自动整理歌手、专辑和歌曲，并通过浏览器完成搜索、播放、收藏和播放列表管理。本次交付已完成简体中文核心界面适配，并用中文演示曲库验证真实媒体扫描、播放队列和音频分段传输。

真实界面

项目截图

共 10 张

Capabilities

核心功能

✓本地音乐目录扫描与增量同步

✓歌手、专辑、歌曲三级曲库浏览

✓歌曲名称、歌手和专辑联合搜索

✓当前播放队列与顺序管理

✓自定义播放列表和收藏列表

✓浏览器在线播放与 HTTP Range 分段传输

✓多种媒体格式识别与 FFmpeg 转码

✓浅色、深色及跟随系统主题

✓多用户与管理员权限管理

✓SQLite 与 PostgreSQL 双数据库支持

适用场景

个人或家庭私有音乐库

局域网音乐文件统一管理

工作室或门店内部曲库

Rails 媒体应用学习与二次开发

适合谁

希望自托管个人音乐服务的用户、家庭影音爱好者、工作室与门店技术人员，以及学习 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

技术栈

Ruby 4.0Rails 8.1SQLiteTurboStimulusFFmpegDocker Compose

授权说明

Release notes

版本记录

1 个已发布版本

vcn-52cc8b04e31828b38319aa4c35c5d92e0d580afc 当前推荐

2026-08-13

固定源码中文交付版本：核心界面简体中文化、恢复容器入口执行权限、增加中文演示曲库脚本和十张功能截图。

部署要求：Docker 24+、Compose v2；建议 2 核 CPU、2 GB 内存，另行预留媒体空间。

已知问题：不附带商业音乐；大型曲库或多用户场景建议使用 PostgreSQL。

登录后领取