Koel：极简优雅的开源个人音乐流媒体服务器

项目简介

Koel 是一款精致的开源个人音乐流媒体服务，采用 Vue.js 前端 + Laravel 后端构建，在 GitHub 拥有超过 17100 颗星标。它可以将你硬盘上的音乐文件变成一个私有音乐库，通过浏览器或手机 App 随时随地聆听自己的音乐收藏。界面设计精致，支持歌词显示、播放列表、艺术家/专辑浏览等完整功能。

核心特色

• 界面精致：由专业设计师操刀，视觉体验媲美 Spotify/Apple Music。
• 全平台访问：通过浏览器访问，支持 Chrome、Safari、Firefox 等所有现代浏览器。
• 移动端 App：有官方 iOS/Android 应用 Koel Player，不依赖浏览器。
• 歌词支持：自动从 LRCLIB 等源抓取歌词并同步显示。
• 艺术家/专辑视图：自动刮削音乐元数据，形成完整的音乐库导航。
• Last.fm 集成：自动将播放记录同步到 Last.fm，积累音乐足迹。
• Docker 支持：一条命令完成部署，音乐数据持久化存储。
• 流媒体传输：支持多码率转码，适合在移动网络下使用。

安装步骤

Docker 快速部署（推荐）

# 创建数据目录
mkdir -p /path/to/music /path/to/data
chmod 777 /path/to/music /path/to/data

docker run -d --name koel \
  -p 8000:8000 \
  -v /path/to/music:/music \
  -v /path/to/data:/data \
  -e KOEL_ADMIN_EMAIL=admin@example.com \
  -e KOEL_ADMIN_PASSWORD=your-password \
  -e DB_CONNECTION=sqlite \
  phanan/koel:latest

# 访问 http://your-ip:8000 登录后，在设置中配置音乐目录路径
# 然后点击「扫描」让 Koel 索引你的音乐

手动安装

# 环境要求：PHP 8.1+ / Node.js 18+ / MySQL 8.0+ / Composer
git clone https://github.com/koel/koel.git
cd koel
cp .env.example .env
composer install
npm install
php artisan koel:init
php artisan serve

使用方法

首次登录后，进入「设置」配置音乐文件夹路径。Koel 支持手动指定目录或通过 WebDAV 挂载外部存储。配置完成后，点击「扫描」按钮，Koel 会自动读取音乐文件的 ID3 标签（歌手、专辑、封面、时长等），建立完整的音乐索引。

播放界面支持：随机播放、单曲循环、列表循环、创建播放队列、收藏歌曲、显示歌词等。所有界面都经过精心设计，真正做到了「技术服务于美感」。

适用场景

• 拥有大量本地音乐收藏，想搭建私有音乐库
• 不希望依赖 QQ音乐/网易云等平台的音乐爱好者
• 需要局域网内多设备共享音乐的家庭用户
• 极客用户，打造自己的音乐流媒体服务
• 配合 NAS 使用，打造家庭媒体中心

开源协议

Koel 采用 MIT 开源协议，可免费使用和二次开发。

总结

Koel 是那种「用一次就会爱上」的开源项目。它把一个复杂的流媒体服务，做得如此简洁优雅，让技术小白也能轻松拥有自己的 Spotify。如果你有大量本地音乐收藏，Koel 绝对是值得一试的最佳选择。

服务支持：如有兴趣不会搭建，可以联系微信：WRYD6166，开源项目搭建10-50元。