软件详细介绍
Koel 是一款免费开源的个性化音乐流媒体解决方案,基于 Laravel 和 Vue 构建,可将你的本地音乐收藏转化为一个现代化、基于网页的聆听体验。它能够扫描音乐库,并通过快速、现代的界面在任何浏览器中播放音乐。
核心功能:
- 音乐库扫描与播放:自动扫描本地音乐文件,支持常见音频格式。
- 播放列表与智能播放列表:创建和管理播放列表,支持基于规则的智能列表。
- 播客与电台:集成播客订阅和网络电台功能。
- 外部服务集成:支持 Last.fm 记录播放历史(scrobbling)、Spotify 和 MusicBrainz 元数据整合。
- AI 助手:通过自然语言命令控制播放(如“播放周杰伦的歌”)。
- 移动端应用:官方 Koel Player 支持 iOS 和 Android,提供比移动网页更完整的体验。
- 多用户与协作(Koel Plus 付费版):支持多用户音乐库、协作、单点登录、云存储驱动、自定义主题和白标定制。
典型使用场景:
- 个人音乐收藏管理:将本地音乐库变为可远程访问的流媒体服务。
- 家庭媒体中心:在家庭网络内共享音乐,多设备播放。
- 小型团队或组织:通过 Koel Plus 搭建内部音乐平台。
与商业软件相比的优势与不足:
优势:完全开源、数据自主可控、无订阅费用、高度可定制、活跃的社区支持。
不足:需要自行搭建和维护服务器,对非技术用户有一定门槛;免费版缺少多用户和云存储等高级功能;移动端依赖官方应用,功能可能不如商业软件全面。
系统要求
Windows
- 操作系统:Windows 10 或更高版本(64 位)
- CPU 架构:x86_64
- 内存:至少 2 GB RAM(推荐 4 GB 以上)
- 磁盘空间:至少 500 MB 可用空间(不含音乐文件)
- 可选依赖:Web 服务器(如 Apache/Nginx)、PHP 8.1+、Composer、Node.js(用于开发)
macOS
- 操作系统:macOS 10.15 (Catalina) 或更高版本
- CPU 架构:x86_64 或 Apple Silicon
- 内存:至少 2 GB RAM(推荐 4 GB 以上)
- 磁盘空间:至少 500 MB 可用空间(不含音乐文件)
- 可选依赖:Web 服务器、PHP 8.1+、Composer、Node.js(用于开发)
Linux
- 操作系统:主流发行版(如 Ubuntu 20.04+、Debian 11+、CentOS 8+)
- CPU 架构:x86_64 或 ARM64
- 内存:至少 2 GB RAM(推荐 4 GB 以上)
- 磁盘空间:至少 500 MB 可用空间(不含音乐文件)
- 可选依赖:Web 服务器(Nginx/Apache)、PHP 8.1+、Composer、Node.js(用于开发)
安装教程
Windows
- 从本页面的夸克网盘下载
koel-v9.15.0.zip安装包。 - 解压 ZIP 文件到目标目录(如
C:\koel)。 - 确保已安装 PHP 8.1+ 和 Composer,并在解压目录中运行
composer install安装依赖。 - 复制
.env.example为.env,配置数据库连接信息(如 SQLite 或 MySQL)。 - 运行
php artisan key:generate生成应用密钥。 - 运行
php artisan migrate --seed初始化数据库。 - 配置 Web 服务器(如 Apache 或 Nginx)指向
public目录,或使用php artisan serve启动开发服务器。 - 首次启动后,访问
http://localhost:8000,使用默认账号(邮箱admin@koel.dev,密码Koel)登录,并立即修改密码。 - 验证安装:登录后进入设置页面,扫描音乐库,确认歌曲显示并可播放。
macOS
- 从本页面的夸克网盘下载
koel-v9.15.0.tar.gz安装包。 - 解压:
tar -xzf koel-v9.15.0.tar.gz,进入解压目录。 - 确保已安装 PHP 8.1+ 和 Composer,运行
composer install安装依赖。 - 复制
.env.example为.env,配置数据库连接信息。 - 运行
php artisan key:generate生成应用密钥。 - 运行
php artisan migrate --seed初始化数据库。 - 配置 Web 服务器指向
public目录,或使用php artisan serve启动开发服务器。 - 首次启动后,访问
http://localhost:8000,使用默认账号(邮箱admin@koel.dev,密码Koel)登录,并立即修改密码。 - 验证安装:登录后进入设置页面,扫描音乐库,确认歌曲显示并可播放。
Linux
- 从本页面的夸克网盘下载
koel-v9.15.0.tar.gz安装包。 - 解压:
tar -xzf koel-v9.15.0.tar.gz,进入解压目录。 - 确保已安装 PHP 8.1+ 和 Composer,运行
composer install安装依赖。 - 复制
.env.example为.env,配置数据库连接信息。 - 运行
php artisan key:generate生成应用密钥。 - 运行
php artisan migrate --seed初始化数据库。 - 配置 Web 服务器(如 Nginx 或 Apache)指向
public目录,并设置适当的权限(如storage和bootstrap/cache目录可写)。 - 首次启动后,访问服务器地址,使用默认账号(邮箱
admin@koel.dev,密码Koel)登录,并立即修改密码。 - 验证安装:登录后进入设置页面,扫描音乐库,确认歌曲显示并可播放。
软件信息
- 开发语言
- PHP
- 开源协议
- MIT
- GitHub
- koel/koel
- Stars
- 1.7万
- 发布时间
- 2026-09-28
- 收录时间
- 2026-11-19
可替代
SpotifyApple MusicPlexSubsonicNavidrome