Koel

產品說明

Koel (命名自一種亞洲杜鵑鳥) 是一款採用現代技術棧（Vue 於前端，Laravel 於後端）編寫的個人音樂串流服務。它的出現是為了讓那些不願將音樂託管於大型訂閱平台，卻又想隨時隨地透過瀏覽器聆聽收藏的使用者提供解決方案。

Koel 最大的優勢在於其極致美觀的介面。它不像傳統的檔案瀏覽器，而是完全模擬了主流串流媒體的操作邏輯，支援專輯封面自動抓取、動態歌單、以及極簡的播放控制。只要將它部署在你的伺服器上，你的所有 MP3, FLAC 或 OGG 檔案都能瞬間變身為具備專業質感的串流媒體庫。

核心特色：

• 現代化 Web 介面：完全基於 Vue 開發，提供流暢的 SPA（單頁應用）體驗，支援拖放上傳與即時搜尋。
• 多平台相容：除了電腦瀏覽器，其響應式設計確保在手機平板上也有優秀表現，並提供原生行動 App 支援。
• 雲端儲存支援：除了本機硬碟，支援將音樂存放於 AWS S3 儲存桶，降低本地端存儲壓力。
• 智慧歌單功能：支援「最近播放」、「最常播放」等動態清單，並可與 Last.fm 進行同步 (Scrobbling)。
• 歌詞整合：整合外部 API，可在播放時自動顯示對應的歌曲歌詞。

常用指令

Koel 建議透過 Docker 部署以簡化繁瑣的環境設定。以下是啟動與基礎管理指令：

部署與基礎操作

# 透過 Docker Compose 啟動服務
docker-compose up -d

# 初始化管理員帳號 (首次安裝使用)
docker exec -it koel_php php artisan koel:init

# 強制重新掃描音樂資料夾
docker exec -it koel_php php artisan koel:sync

# 建立新使用者
docker exec -it koel_php php artisan koel:user:create

進階技巧

• 行動 App 連結：在個人設定頁面可以掃描 QR Code，快速將行動裝置 App 連接到你的個人伺服器。

• 遠端掛載 (S3)：如果你家中的上傳頻寬不足，可將音樂上傳至 S3，Koel 僅負責介面呈現，流量則由雲端供應商承擔。

• 反向代理配置：強烈建議搭配 Nginx 搭配 SSL，不僅提升安全性，還能讓瀏覽器支援 PWA (Progressive Web App) 模式。

操作介面