OpenSource-Hub
K

Koel

17.1k stars·システム最適化·SHA-256 チェックサム確認済み

Web ベースの個人用音楽ストリーミングサービス。美しいインターフェースを備え、セルフホスト型で、マルチプラットフォームに対応。

スマートダウンロード

プロジェクトのホームページへ

インストーラはまだありません — ソースリポジトリをご覧ください

自分だけのプライベート音楽サーバーを構築して、いつでもどこでもあなたの音楽を聴きましょう。

主な機能

  • Vue + Laravel ベースのモダンな Web インターフェース、高速な応答
  • 複数のオーディオフォーマット(MP3、FLAC、OGG など)をサポート
  • プレイリスト管理、検索、アーティスト/アルバムのブラウジング
  • 公式モバイルアプリ(iOS および Android)
  • セルフホスト型、データプライバシーを完全に管理

できないこと

  • •一定のサーバー運用・保守の知識が必要であり、非開発者にとっては一定のハードルがあります。デフォルトでは音楽ファイルは含まれていないため、自分でアップロードする必要があります。モバイル端末のWeb版は機能が制限されているため、公式アプリの使用をお勧めします。

使用例

  • プライベート音楽サーバーを構築し、网易云/Spotify などの商用サービスを代替する
  • ホームネットワーク内で音楽ライブラリを共有し、複数のデバイスで同期再生する

詳細説明

Koel は Web ベースのパーソナルオーディオストリーミングサービスで、いつでもどこでも自分の音楽コレクションを楽しむことができます。フロントエンドには Vue.js、バックエンドには Laravel を採用し、美しくレスポンシブなインターフェースで音楽の閲覧、検索、再生が可能です。複数のオーディオフォーマットに対応し、プレイリスト管理機能を備え、公式の iOS および Android モバイルアプリも提供されています。Koel は Web 開発者や音楽愛好家を対象としており、サードパーティのクラウドサービスに依存することなく、自分の音楽ライブラリを完全にコントロールできます。

トラブルシューティング & FAQ (2)

トラブル対応
Koel のスキャンで削除された曲がデータベースから削除されない問題を修正するにはどうすればよいですか?

これは、必要な Laravel の環境変数(特に QUEUE_CONNECTION)が不足しているために、スキャン後のイベントリスナーが実行されない場合に発生します。.env ファイルを .env.example と比較し、サンプルファイルの下部にある Laravel 固有の変数を追加してください。別のキューワーカーを使用しない標準的な Koel/Docker セットアップでは、QUEUE_CONNECTION=sync に設定してください。その後、コンテナを再起動して再スキャンします:

docker restart <koel-container>
docker exec -it <koel-container> php artisan koel:scan

スキャン後、ストレージからファイルが削除された楽曲は songs テーブルから削除され、Web インターフェースからも消えるはずです。

参照 Issue #2466
トラブル対応
Koelに大きなFLAC/オーディオファイルをアップロードする際に発生する「Server error」(50MB制限)を修正する方法

Koelのデフォルトの50MBアップロード上限は、PHPのupload_max_filesizeおよびpost_max_size設定に由来しています。引き上げるには:

1. Koelリポジトリのルートにある.htaccess.exampleを.htaccessにコピーします(まだ存在しない場合)。
2. ファイル下部の値を編集し、50Mを希望する上限に変更します。例:

php_value upload_max_filesize 800M
   php_value post_max_size 800M

3. ファイルを保存します — Apacheは.htaccessの変更を即座に反映するため、再起動は不要です。

注意:公式のKoel Dockerイメージを使用している場合、同梱のphp.iniではすでに上限が800Mに設定されているため、.htaccessもその値に合わせてください。また、Cloudflare経由でプロキシしている場合、無料プランではリクエスト/レスポンスサイズが100MBに制限されています — それを超えるファイルをアップロードする際は、Cloudflareプロキシを一時的に無効化(DNSのみモード)してください。

参照 Issue #2664

タグ

musicstreamingself-hostedlaravelvue

はじめ方

1

インストーラをダウンロード

上のボタンをクリックして、お使いのシステム用のインストーラをダウンロード

2

ソフトウェアをインストール

ダウンロードしたインストーラをダブルクリックし、指示に従ってください

3

ステップ1:PHP 8.1+、MySQL/MariaDB、Composer 環境を準備する

4

ステップ2:プロジェクトをクローンし、composer install を実行して依存関係をインストールする

5

ステップ3:php artisan koel:init を実行して設定とデータベースを初期化する

インストールガイド
  1. ステップ1:PHP 8.1+、MySQL/MariaDB、Composer 環境を準備する
  2. ステップ2:プロジェクトをクローンし、composer install を実行して依存関係をインストールする
  3. ステップ3:php artisan koel:init を実行して設定とデータベースを初期化する
ファイルの整合性

チェックサムがありません

このプロジェクトは GitHub Release ページに SHA-256 チェックサムを公開していません

SHA256 チェックサム

チェックサムなし

GitHub Releases から直接ダウンロードし、ファイルの整合性をご自身で確認してください

本プラットフォーム上のすべての SHA-256 チェックサムは、プロジェクトの公式 GitHub Release ページから抽出されたもので、一切の改変はありません。GitHub Releases ページで独自に検証できます。

オープンソースの透明性

GitHub ソースを見る
環境ガイド

アンインストール情報

プロジェクトディレクトリを削除し、対応するデータベースを削除するだけです。Docker でデプロイした場合は、コンテナとイメージを削除してください。

追加の依存関係なし

ダウンロード後すぐに使用可能。追加のランタイムは不要です。

プロジェクト情報
ライセンスMIT
最終更新2026-10-20 17:57:29
GitHub リポジトリ

問題が発生?以下のFAQを確認

2 FAQs

類似プロジェクト