Kyoo 是开源自托管媒体库,支持电影、剧集、动漫全格式。内置动态转码秒切码率不卡顿、动漫文件名智能解析变态命名如 Some-Stuffs 系列,支持多用户独立账号和权限管理,完全替代 Jellyfin、Plex、Emby,一个 Docker 搞定,开源免费部署。

🎤 引言

用 Jellyfin / Plex 追剧党都知道几个痛点:转码慢得要命(尤其是 REMUX 片源)、外挂字幕匹配全靠手、动漫文件名各种 [Some-Stuffs] Jojo's Bizarre Adventure Stone Ocean 24 (1920x1080 Blu-Ray Opus) [2750810F].mkv 根本刮削不到、多用户权限管理还得折腾插件……

最近在 GitHub 上发现一个项目 Kyoo,2.5k stars,口号就是"做 Jellyfin / Plex 的替代方案"。看了下 commits(5,594 次)——比很多成熟项目都勤快,不是那种"写完就跑"的开源。HN 上还有专门的 Show post,有人评价"Looks very pretty and the demo is nice"。


⭐ 核心功能

🎞️ 全格式媒体库

电影、剧集、动漫一手抓。扫描本地媒体文件夹后自动整理成海报墙,支持季/集结构、多音轨、多字幕轨。剧集支持 season pack(整季打包),不用一个个手动匹配。

🔄 动态转码(Dynamic Transcoding)

这是 Kyoo 和 Jellyfin 拉开差距的核心功能。Jellyfin 转码是"先等 buffer 填完再播",Kyoo 可以"随时切码率、随便拖进度",不用等转码器追上。内置 Go 写的转码服务,支持 H.264 / H.265 / VP9 等常见编码,输出质量自动适应网络带宽(adaptive bitrate)。

🌸 动漫文件名解析

Jellyfin / Plex 碰到 [Some-Stuffs] Jojo's Bizarre Adventure Stone Ocean 24 (1920x1080 Blu-Ray Opus) [2750810F].mkv 这种文件名基本挂掉。Kyoo 专门训练了文件名解析逻辑,这类变态命名能直接识别出:作品名 + 集数 + 分辨率 + 编码格式,不用手动改名也不用写正则。

📺 多平台客户端

目前已有 Web 端(浏览器直接用),Android 客户端在 v5 中会推出。不想装 App 的直接浏览器访问就行,体验接近原生 App。

👥 多用户 + 权限体系

支持多账号体系,可以给家人建独立账号,各看各的互不干扰。也有管理员权限体系,不像 Plex 那样个人版功能阉割严重。

📦 无插件架构(Built-in Everything)

Kyoo 的路线是"所有功能都内置",不做插件系统。这样升级维护简单,不用担心某个插件作者跑路导致安全漏洞。官方列出的一屏功能列表(见 README)基本覆盖了追剧党 90% 的需求。


📥 安装使用

前提

  • Docker + Docker Compose
  • 媒体文件目录(准备好用来存电影 / 剧集 / 动漫的文件夹)
  • PostgreSQL 数据库(docker-compose 会自动带)

快速部署

# 1. 克隆仓库
git clone https://github.com/zoriya/Kyoo.git
cd Kyoo

# 2. 创建环境变量
cp .env.example .env
# 编辑 .env,填入数据库密码和域名

# 3. 启动
docker compose up -d

# 4. 访问
# http://your-server:5000

首次配置

  1. 打开 Web 界面,创建管理员账号
  2. 在"设置 → 媒体库"添加媒体文件夹路径
  3. Kyoo 会自动扫描并刮削海报、简介、评分
  4. 创建子账号给家人

媒体文件夹建议

/media
  /movies        # 电影
  /tv            # 剧集
  /anime         # 动漫(文件名格式越标准刮削越准)

🎯 适用场景

  • 追番党:动漫文件名解析是刚需,不用再折腾手动改名。
  • 高清 REMUX 收藏者:动态转码不卡顿,拖到哪里播到哪里。
  • 家庭媒体中心:多账号体系+Jellyfin 类似的 UI,上手无门槛。
  • 隐私敏感者:自托管不吃安利云服务数据。
  • 讨厌插件维护的极客:内置功能够用,不想折腾插件兼容性问题。

🔍 对比 / 替代方案

项目转码动漫解析插件系统成熟度
Kyoo内置动态转码 ✅原生支持 ✅内置无插件5.5k commits
JellyfinFFmpeg 转码(偏慢)差 ❌插件丰富很成熟
Plex硬件加速差 ❌插件丰富很成熟(闭源)
Emby依赖硬件差 ❌插件一般成熟
Seanime有(自托管)较新

Kyoo 最大优势在动态转码动漫解析这两块,是竞品明显短板的地方。适合有高清片源收藏习惯的用户。


⚠️ 注意事项

  • v5 Android 客户端还未发布:目前只有 Web 端,Android 要等 v5。如果必须用手机 App 追剧,现阶段 Jellyfin / Plex 体验更完整。
  • 生态不如 Jellyfin:没有插件意味着没有那么多第三方元数据源(某些冷门动漫可能刮削不到)。
  • PostgreSQL 必装:Jellyfin 用 SQLite 轻量很多,Kyoo 必须配 PostgreSQL,增加了运维复杂度。
  • 中文资源:项目英文为主,中文文档/社区较少。
  • 已知 Bug:动漫解析在某些变态命名格式下仍有误识别,55 个 open issues 里此类问题占不少(来源:GitHub Issues)。

✅ 总结

Kyoo 是一个野心不小的项目——"所有功能内置"的路线让它比 Jellyfin 更统一、比 Plex 更开源。2.5k stars + 5,594 commits 的维护力度,在同类新兴项目里算相当勤快的。

推荐指数:⭐⭐⭐½(3.5/5)

适合人群:有高清 REMUX 收藏的追番党、讨厌 Jellyfin 插件地狱的极客玩家。

不适合人群:主要用手机 App 看剧的人(Android 客户端还在开发中)、需要丰富插件生态的用户(冷门元数据源需求)。

如果你受够了 Jellyfin 转码卡顿或者动漫文件名匹配失败,可以试试 Kyoo。部署一个 Docker 的事,不满意随时回滚 Jellyfin。

GitHub:https://github.com/zoriya/Kyoo