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首次配置
- 打开 Web 界面,创建管理员账号
- 在"设置 → 媒体库"添加媒体文件夹路径
- Kyoo 会自动扫描并刮削海报、简介、评分
- 创建子账号给家人
媒体文件夹建议
/media
/movies # 电影
/tv # 剧集
/anime # 动漫(文件名格式越标准刮削越准)🎯 适用场景
- 追番党:动漫文件名解析是刚需,不用再折腾手动改名。
- 高清 REMUX 收藏者:动态转码不卡顿,拖到哪里播到哪里。
- 家庭媒体中心:多账号体系+Jellyfin 类似的 UI,上手无门槛。
- 隐私敏感者:自托管不吃安利云服务数据。
- 讨厌插件维护的极客:内置功能够用,不想折腾插件兼容性问题。
🔍 对比 / 替代方案
| 项目 | 转码 | 动漫解析 | 插件系统 | 成熟度 |
|---|---|---|---|---|
| Kyoo | 内置动态转码 ✅ | 原生支持 ✅ | 内置无插件 | 5.5k commits |
| Jellyfin | FFmpeg 转码(偏慢) | 差 ❌ | 插件丰富 | 很成熟 |
| 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。