blackcandy-org/blackcandy

Что это?

Ключевые возможности

• 01Стримит музыку из папки с медиафайлами, подключённой к контейнеру.
• 02Предлагает веб-интерфейс и официальные приложения для iOS, Android и F-Droid.
• 03По умолчанию использует SQLite и поддерживает PostgreSQL в качестве альтернативы.
• 04Поддерживает учётные записи администраторов и обычных пользователей; в деморежиме доступ администратора ограничен.
• 05Получает изображения исполнителей и альбомов через Discogs API.
• 06Работает в Docker-контейнере с постоянным хранилищем и настраиваемыми переменными окружения.

Сценарии использования

• Разместить личную музыкальную библиотеку на домашнем сервере и слушать её в любом браузере.
• Запустить приватный сервис для стриминга музыки для семьи или небольшой группы.
• Получать доступ к своей коллекции с телефонов, не полагаясь на коммерческую подписку.
• Попробовать self-hosted приложение на Rails как пример развёртывания с Docker.

Быстрый старт

1. 1

   Запустите Black Candy с помощью Docker из GitHub Container Registry

   docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest
2. 2

   Откройте http://localhost в браузере и войдите под начальной учетной записью администратора

Что важно знать

• !По умолчанию используется база данных SQLite; для PostgreSQL требуются дополнительные переменные окружения и настройка.
• !Чтобы сервер мог видеть вашу музыкальную библиотеку, необходимо смонтировать медиафайлы в контейнер.

В подборках

Темы

Частые вопросы

Что такое blackcandy?

Сервер для самостоятельного стриминга музыки, который позволяет слушать свою библиотеку через браузер или мобильное приложение. Black Candy — self-hosted сервер для стриминга музыки, созданный на Ruby on Rails. Укажите папку с медиафайлами на компьютере или сервере, и он предоставит доступ к библиотеке через веб-интерфейс и официальные приложения для iOS и Android.

blackcandy можно использовать бесплатно? Какая у него лицензия?

blackcandy распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

blackcandy всё ещё поддерживается?

Активно поддерживается. Последний коммит в blackcandy — 21 окт. 2026 г..

Для чего можно использовать blackcandy?

Разместить личную музыкальную библиотеку на домашнем сервере и слушать её в любом браузере. Запустить приватный сервис для стриминга музыки для семьи или небольшой группы. Получать доступ к своей коллекции с телефонов, не полагаясь на коммерческую подписку. Попробовать self-hosted приложение на Rails как пример развёртывания с Docker.

Как установить blackcandy?

Запустите Black Candy с помощью Docker из GitHub Container Registry: docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest Откройте http://localhost в браузере и войдите под начальной учетной записью администратора

Где скачать blackcandy?

Исходный код и инструкции по установке — на GitHub: https://github.com/blackcandy-org/blackcandy