Koel：一款颜值超赞的音乐流媒体服务器，NAS必备，配合App使用更佳！

Koel（发音为“cool”），是一个由Vue.js和Laravel框架共同打造的开源音乐服务器。它允许用户在自己的服务器上托管音乐库，随时随地享受音乐，无需依赖任何第三方服务。Koel以其简洁的设计和流畅的用户体验著称，特别适合家庭媒体中心、音乐爱好者和重视隐私的用户。笔者此前也介绍过几款类似的系统，不得不说，还是这款看起来颜值更高，而且还内置了多套主题，并且官方也提供了移动端App。由于官方的文档写的过于繁琐，笔者就简单介绍下Koel的相关功能和安装方法。

🏓 技术栈

• 前端：使用Vue.js进行界面渲染，提供响应式设计，确保在各种设备上的良好表现。

• 后端：基于Laravel PHP框架，提供了RESTful API来与前端交互，处理文件上传、元数据解析等任务。

• 数据库：支持SQLite、MySQL、PostgreSQL，用于存储歌曲信息、元数据及用户的播放历史。

🎭 功能特性

Koel不仅是一个音乐播放器，更是一个功能丰富的音乐管理系统，其主要特性包括：

• 个性化元数据：自动抓取专辑封面和歌词，支持手动调整歌曲信息，打造个性化的音乐体验。

• 播放列表管理：创建、编辑和分享播放列表，自由安排聆听顺序。

• 跨平台播放：无论你在PC、Mac还是移动设备上，只要有网络连接，都能访问你的音乐库。

• 离线模式：下载歌曲到本地，在无网络环境下也能享受音乐。

• 社交功能（可选）：公开你的音乐库，让朋友也能欣赏你的收藏。

• 音频流：通过HTML5的Audio对象实现实时流媒体播放，兼容大部分现代浏览器。

安装Koel

Docker的安装方式极大地简化了Koel的部署过程，使其在不同环境中都能轻松运行。Koel需要依赖数据库才能正常部署，所以除了确保你的NAS支持Docker和Docker Compose之外，你还需要先安装好数据库（MySQL/MariaDB/PostgreSQL），虽然官方提到也支持SQLite，但是没说清楚到底怎么设置，所以笔者建议直接使用MySQL拉到！

1. 安装MySQL

如果还没有安装MySQL，可以使用下面compose.yml启动一个MySQL示例：

启动：

docker compose up -d

2. 安装Koel

启动：

docker compose up -d

3. 初始化Koel

启动Koel容器后，需要先进行初始化，主要用来完成三个事项：

• 生成APP_KEY

• 创建管理员账户

• 初始化数据库

首先进入Koel容器：

docker exec -it koel /bin/bash

然后执行：

php artisan koel:init --no-assets

最后，会提醒设置音乐文件目录，保持不变，直接回车即可，然后就可以看到初始化是自动创建的默认管理员账户的用户名和密码了，记得复制下来。

4. 开启Koel

等待几秒钟，然后在浏览器中打开http://ip:7000，你应该就能看到Koel的登录页面了，使用上面初始化时的用户名和密码登录，即可开始使用。

登录之后就是熟悉的环节了，UI界面确实非常哇塞，并且对移动端浏览器适配的也不错！