Black Candy
自托管的音乐流媒体服务器，让你轻松搭建个人专属音乐中心。
スマートダウンロード
プロジェクトのホームページへ
インストーラはまだありません — ソースリポジトリをご覧ください
一键部署的私有音乐流媒体服务，自带移动端 App。
主な機能
- 一键 Docker 部署，无需复杂配置
- 自带 iOS 和 Android 官方应用
- 支持 SQLite 和 PostgreSQL 双数据库
- 挂载本地音乐目录，自动扫描导入
- 响应式 Web 界面，移动端友好
できないこと
- •默认使用 SQLite，若音乐库超过几千首建议改用 PostgreSQL 提升性能,升级前务必阅读官方升级指南，新版可能有不兼容变更,运行时需持久化 /app/storage 目录，否则重启后所有数据丢失,SECRET_KEY_BASE 环境变量建议自定义，否则每次重启 session 都会失效
使用例
- 在家自建私有音乐云，随时听自己的收藏
- 替代网易云、Spotify 等第三方服务，保护隐私
- 多设备（手机、电脑、平板）同步播放同一音乐库
Black Candy 是一款自托管的音乐流媒体服务器，适合个人或家庭使用。它可以将你的本地音乐库变成类似 Spotify 的私有流媒体服务，支持通过浏览器或专属 iOS/Android 应用播放。服务器以单个 Docker 镜像形式提供，部署极其简单；默认使用 SQLite 数据库（可选 PostgreSQL）。功能包括用户认证、媒体文件挂载、后台任务处理，以及通过环境变量灵活配置。官方移动应用已上架 App Store 和 F-Droid，无需额外客户端即可享受无广告、无追踪的音乐体验。
タグ
はじめ方
ソフトウェアをインストール
ダウンロードしたインストーラをダブルクリックし、指示に従ってください
步骤1：运行命令 docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest
步骤2：浏览器访问 http://localhost，用默认管理员账号登录（admin@admin.com / foobar）
步骤3：在设置中添加上传音乐目录，或通过 Web 界面上传文件
- 步骤1：运行命令 docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest
- 步骤2：浏览器访问 http://localhost，用默认管理员账号登录（admin@admin.com / foobar）
- 步骤3：在设置中添加上传音乐目录，或通过 Web 界面上传文件
チェックサムがありません
このプロジェクトは GitHub Release ページに SHA-256 チェックサムを公開していません
SHA256 チェックサム
チェックサムなし
GitHub Releases から直接ダウンロードし、ファイルの整合性をご自身で確認してください
本プラットフォーム上のすべての SHA-256 チェックサムは、プロジェクトの公式 GitHub Release ページから抽出されたもので、一切の改変はありません。GitHub Releases ページで独自に検証できます。
オープンソースの透明性
GitHub ソースを見るアンインストール情報
停止并删除容器：docker stop <容器名> && docker rm <容器名>，同时删除挂载的持久化数据目录即可完全卸载。
追加の依存関係なし
ダウンロード後すぐに使用可能。追加のランタイムは不要です。
問題が発生？以下のFAQを確認
5 FAQs