koel.dev

Koel是什么网站?

Koel 是一个自托管的音乐流媒体服务器，核心用途是让你在自己的服务器上托管、管理和串流个人音乐库。它开源、界面现代，定位是“真正能用”的私有音乐流媒体方案，而不是把音乐交给第三方平台。

主要用途

• 把本地音乐上传到自己的服务器，跨设备播放和同步。
• 管理媒体库：编辑标题、艺术家、专辑、曲目、碟号等元数据，支持合辑、封面、播放列表文件夹、流派分类。
• 通过 MusicBrainz、Wikipedia、Last.fm、Spotify、YouTube 等集成自动补全元数据、专辑封面和视频。
• 内置无损支持、跨设备播放同步、收藏、智能播放列表、多用户、均衡器、可视化、电台和播客等功能。

适合谁、什么场景

• 想自己掌控音乐库、不愿依赖商业流媒体的人。
• 有较大本地音乐收藏，需要快速检索和多设备播放的用户。
• 需要多用户共享一套音乐库的家庭或小团队。

与其他方式的区别 Koel 兼容 Subsonic 和 OpenSubsonic API，所以你不必被锁在网页界面里，可以拿任意支持 Subsonic 的客户端连接自己的库。它同时提供 iOS 和 Android 的原生应用 Koel Player，安装后登录即可使用，无需额外配置。这一点是它区别于纯网页播放器的主要地方：库是你的，客户端也由你选。

收费情况 社区版永久免费且开源。若需要额外增强功能，可一次性购买 Koel Plus，官方说明为“一次付费，无订阅、无持续费用”，支付通过 Lemon Squeezy 完成。

下一步 想自建音乐流媒体，可先从社区版入手；确认需要 Plus 的增强功能后，再考虑在 Koel 购买。

如何在自己的服务器上部署Koel并开始串流音乐?

在服务器上部署 Koel 的路径是：用 Docker 或源码方式跑起服务，指向你的音乐目录，登录后台扫描媒体库，然后通过 Web 界面或任意 Subsonic 客户端播放。Koel 定位是自托管的音乐串流服务器，支持无损、跨设备同步、多用户、智能歌单等开箱功能（Koel）。

部署前需要准备什么

• 一台可长期运行的服务器（VPS、NAS 或家用主机均可），有固定访问地址或域名。
• 存放音乐的目录，Koel 会扫描并管理其中的文件。
• 数据库（Koel 使用 MySQL/MariaDB 一类关系型数据库）和运行环境；若用 Docker，这些通常随容器编排一起配置。
• 想省事就用官方 Docker 镜像与 compose 配置，想改代码或深度定制就按文档走源码安装。

部署后怎么开始串流

1. 首次打开会进入初始化流程，创建管理员账号。
2. 在设置里指定音乐目录，触发扫描，Koel 会读取标签、封面并归类。
3. 扫描完成后即可在网页端播放；需要移动端体验时安装 Koel Player（iOS/Android），登录同一账号即可，无需额外配置。
4. 如果不想被网页界面绑住，Koel 兼容 Subsonic / OpenSubsonic API，把任意 Subsonic 客户端指向你的 Koel 地址就能串流。

哪些场景适合用它

• 自己的音乐收藏量大、想统一管理元数据和封面，而不是把文件散在多个网盘或播放器里。
• 家里多个人共用一套曲库，需要多用户、收藏和歌单相互独立。
• 想在不同设备间同步播放进度，或希望有无损和均衡器、可视化等播放增强。
• 已经有习惯的 Subsonic 客户端，不想换 App。

免费版和 Koel Plus 怎么选

社区版永久免费且开源，标准串流、媒体管理、Subsonic 兼容、移动端这些核心能力都在其中。Koel Plus 是一次性买断、无订阅的付费版本，用于在默认安装上叠加额外功能，购买入口在官方商店（Koel）。判断标准很简单：先用社区版跑通并确认满足日常使用，再决定是否需要 Plus 的增强项。

和同类方案比较时的侧重点

• 与通用媒体服务器相比：Koel 专注音乐，界面和交互按音乐播放器习惯设计，不掺视频库管理。
• 与纯 Subsonic 服务端相比：Koel 自带现代化 Web 界面和移动 App，同时仍兼容 Subsonic 生态，客户端选择不被锁死。
• 与托管式音乐服务相比：Koel 的差异在于曲库归你自己、存储在你自己服务器上，代价是需要自己维护部署和备份。

下一步动作

先按官方文档的 Docker 方式起一个最小实例，导入一小部分音乐验证扫描和播放，再逐步把完整曲库接进来；确认稳定后配置好备份与远程访问（如反向代理加 HTTPS），最后再评估是否需要 Koel Plus。

Koel Plus付费版相比免费社区版多了哪些功能?

Koel Plus 是 Koel 的一次性买断版本，社区版永久免费开源。资料中明确列出的 Plus 差异点主要是存储驱动：免费版用默认存储，Plus 提供“Extensive storage drivers”，即更多存储后端选择，便于把音乐放到不同位置或接入云存储。购买走 Lemon Squeezy，页面写的是“Pay once – no subscriptions, no recurrent fees”，没有订阅或续费。

需要留意的是，Koel 官网对 Plus 的功能清单展示得比较克制，除了存储驱动，其余像无损支持、跨设备同步、收藏、智能播放列表、多用户、均衡器、可视化、电台和播客、Subsonic/OpenSubsonic API、移动端 App 这些，页面都写在社区版“Batteries-included”里，并未标注为 Plus 专属。所以如果你主要用这些常规功能，社区版通常就够。

适合买 Plus 的情况：

• 你的音乐库很大或分散在多处，需要更灵活的存储方案。
• 你希望一次付费、长期使用，不想订阅。
• 你已经在用社区版，只缺存储驱动这一块。

下一步可以先去 Koel 的 Demo 体验界面，再对照 Docs 确认你的存储需求是否必须 Plus；如果只是自建一台机器放本地音乐，社区版先跑起来更划算。

Koel如何与Subsonic客户端配合使用来播放音乐?

Koel 内置了 Subsonic 和 OpenSubsonic API 服务端支持。你不需要额外装插件，只要 Koel 本身在运行，任何兼容 Subsonic 的客户端都能连上它来播放音乐。

具体怎么用

1. 在服务器上部署并启动 Koel，确认网页端能正常访问、音乐库已扫描。
2. 打开一个 Subsonic 兼容客户端（手机、桌面或网页版均可）。
3. 在客户端里添加服务器，地址填你的 Koel 地址（带 / 路径，按客户端要求填写），端口按 Koel 实际监听端口填。
4. 用户名和密码用你在 Koel 里的账号登录。
5. 登录后即可浏览、搜索、播放 Koel 库里的音乐，播放列表、收藏等也会通过 API 同步。

为什么值得这样用

Koel 官方把“Speaks Subsonic”作为一项独立能力列出来，意思是你不必被锁在它的网页界面里。你可以继续用自己习惯的客户端，同时把库放在 Koel 上管理。原作者的原话是“Point any Subsonic-compatible client at your Koel library and stream away”，即把任意 Subsonic 客户端指向你的 Koel 库，直接开播。

适合谁、什么场景

• 已经在用某个 Subsonic 客户端（比如手机上装了某款），不想换 App，但想换后端。
• 想在电视、车机、桌面等多设备上用同一套账号听同一个库。
• 想让家人或朋友用他们熟悉的客户端连你的 Koel，而不用教他们用新界面。

选择条件

• 客户端必须支持 Subsonic 或 OpenSubsonic API，纯本地播放器不行。
• Koel 需要能被客户端网络访问到；外网使用要自行处理端口或反向代理。
• 官方另有 Koel Player（iOS 和 Android），装好登录即可，不需要额外配置，适合不想折腾第三方客户端的人。

下一步

先拿一个你已有的 Subsonic 客户端试连，能登录并列出曲库就说明配置正确。如果只是想快速在手机上听，直接装 Koel Player 更省事。想要更多功能（如无损、跨设备同步、智能歌单等）可考虑 Koel Plus，官方商店显示为一次性买断，通过 Lemon Squeezy 支付，无订阅。

Koel能自动从MusicBrainz、Last.fm等平台获取专辑封面和元数据吗?

可以。Koel 会自动从 MusicBrainz、Last.fm、Spotify、YouTube、Wikipedia 等平台抓取并补全音乐库信息。

具体表现：

• 元数据：标题、艺术家、专辑、曲目、碟片等字段可自动填充，也可手动编辑。
• 专辑封面与艺人图片：自动获取，合辑、播放列表封面同样支持。
• 附加内容：还会拉取相关视频等资料，让资料库更完整。

适用场景：你本地已有一堆音频文件，但标签混乱、缺封面。把文件导入 Koel 后，它会自动匹配并补全，省去手动整理。

需要注意：自动匹配的准确度取决于文件本身的标签质量；如果原始标签错误或过于模糊，匹配结果可能不准，此时可用 Koel 的媒体管理界面手动修正。

如果你更在意元数据来源的可控性，可对比 beets（命令行、规则驱动、可精细配置匹配源）和 MusicBrainz Picard（专注 MusicBrainz 指纹匹配）。Koel 的侧重点是把匹配和播放整合在一个自带界面的流媒体服务里，而不是做最专业的标签整理工具。

Koel Player移动端应用支持哪些平台,需要额外配置吗?

Koel Player 移动端应用支持 iOS 和 Android 两个平台。根据官网说明，它不需要额外配置：安装后直接登录即可访问你的音乐库。

具体使用情境

• 你已经在服务器上部署好 Koel，想在手机上听自己的音乐：装 Koel Player，登录账号就能用，不用再单独配服务器地址或做别的设置。
• 除了官方 App，Koel 还兼容 Subsonic / OpenSubsonic API，所以也可以用任意支持该协议的第三方客户端连接你的 Koel 音乐库。

选择条件

• 想要官方原生体验：用 Koel Player（iOS / Android）。
• 已有习惯的 Subsonic 客户端：直接指向 Koel 即可，不必换 App。

下一步

在 iOS App Store 或 Android 应用商店搜索 Koel Player，安装后登录你的 Koel 账号。