koel

应用介绍

Koel 是一款基于 Web 的个人音频流媒体服务，允许你在自己的 NAS 上搭建私人音乐库，随时随地流式播放你收藏的音乐。它采用 Vue 作为前端框架，Laravel 作为后端框架，界面美观现代，功能丰富，是自托管音乐服务的优秀选择。

Koel 支持从指定目录扫描你的音乐文件，自动获取歌曲封面、歌词、艺术家信息等元数据，支持创建播放列表、收藏喜欢的歌曲、搜索音乐，还有移动端适配，可以在手机上随时播放。同时还有官方的移动应用 Koel Player 支持 iOS 和 Android，体验更好。如果你有大量的音乐收藏，想要在自己的 NAS 上搭建私人音乐流媒体服务，Koel 非常值得尝试。

安装说明

前提依赖

Koel 支持 Docker 部署，需要你的 NAS 支持 Docker 和 Docker Compose。由于需要运行 PHP 和数据库，建议至少分配 1 CPU 核心和 1GB 内存，扫描大量音乐时可能需要更多资源。

安装配置

下面是一份可用的 docker-compose.yml 配置：

version: "3"
services:
  koel:
    image: koel/koel:latest
    container_name: koel
    restart: unless-stopped
    ports:
      - "8080:8000"
    environment:
      - DB_CONNECTION=mysql
      - DB_HOST=db
      - DB_DATABASE=koel
      - DB_USERNAME=root
      - DB_PASSWORD=password
    volumes:
      - ./music:/music
      - ./uploads:/var/www/html/public/uploads
    depends_on:
      - db
  db:
    image: mysql:8.0
    container_name: koel-db
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=password
      - MYSQL_DATABASE=koel
    volumes:
      - koel-mysql:/var/lib/mysql

volumes:
  koel-mysql:

你需要将本地的音乐目录挂载到容器的 /music 目录，修改对应的端口和密码，然后执行 docker-compose up -d 即可启动服务。

使用说明

首次启动后，Koel 会自动初始化数据库，你可以通过浏览器访问 http://your-nas-ip:8080 进入安装向导，创建管理员账号。登录后，你可以扫描你的音乐目录，Koel 会自动导入所有音乐文件并获取元数据。

导入完成后，你就可以在 Web 界面中浏览、搜索和播放你的音乐。你可以创建播放列表、收藏歌曲、查看艺术家和专辑信息。如果你使用手机访问，界面会自动适配移动端，你也可以下载官方的 Koel Player 移动应用获得更好的体验。

Koel 支持流式播放，不需要下载全部音乐到本地，节省移动设备空间，你可以随时在任何地方播放你 NAS 上的音乐收藏。

开源信息

项目 GitHub 地址：https://github.com/koel/koel
官方网站：https://koel.dev
项目文档：https://docs.koel.dev
开源协议：MIT License
Star 数量：超过 17.1k