Kyoo
自托管的视频媒体服务器，专注电影/剧集/动漫，无需整理文件夹结构，动态转码、片头片尾检测、动漫文件名解析，低维护替代Jellyfin/Plex。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
扔文件就能播，自动识别动漫乱码名的自建影音库
核心功能
- 动态转码：自动画质调整、即时跳转，无需等待
- 视频预览缩略图：悬停进度条即看视频片段
- 片头/片尾自动检测：基于音频指纹或章节标题
- 强劲字幕：支持 PGS/VODSUB/SSA/ASS，使用内嵌字体
- 动漫文件名解析：再乱的命名也能正确识别
避坑指南
- •⚠️ 目前只有 Web 客户端可用，Android 客户端尚未完成（v5 重写中），iOS/tvOS 暂无计划,⚠️ 不支持音乐、电子书、游戏等非视频内容,⚠️ 无插件系统，功能扩展全部依赖内置开发，新功能需等待更新,⚠️ 实时字幕预览在部分浏览器可能性能不佳（SSA/ASS 动画效果）
适用场景
- 个人/家庭影音库：一站式管理电影、剧集、动漫
- NAS/服务器部署：配合 Docker 或 Kubernetes 实现全平台访问
- 海外剧/动漫爱好者：自动识别各种命名规范的媒体文件
详细介绍
Kyoo 是一款自托管的视频媒体服务器，专门针对电影、电视剧和动漫。与 Jellyfin 或 Plex 不同，它不需要你手动重命名文件或遵循特定的文件夹结构——直接将下载目录丢给它即可工作。内置功能包括：动态转码（支持自动画质、即时跳转）、视频预览缩略图、通过音频指纹识别片头/片尾、增强的字幕支持（PGS/VODSUB/SSA/ASS，支持内嵌字体）、以及强大的动漫文件名解析（能轻松处理像 '[Some-Stuffs] Jojo...' 这样的乱码文件名）。Kyoo 没有插件系统，所有功能都已内建。支持 OIDC 认证（Google、Discord、Authelia），并提供官方 Helm Chart 用于 Kubernetes 部署。目前仅有 Web 客户端（React-Native/Expo），Android 客户端开发中；iOS/tvOS 因硬件和年费问题暂无计划。翻译由社区通过 Weblate 贡献。
常见问题与排障 (1)
故障排除如何修复 Kyoo transcoder 在有集成 GPU 时不使用专用 NVIDIA GPU 的问题？
修改你的 docker-compose.yml 中的 **transcoder-nvidia** 服务，通过指定设备 ID 来明确使用专用 GPU。将 capabilities: [gpu] 替换为：
devices:
- driver: nvidia
device_ids: ['0']
capabilities: [gpu]或者，如果你的 Docker 运行时支持 CDI，请使用：
deploy:
resources:
reservations:
devices:
- driver: cdi
device_ids:
- nvidia.com/gpu=all此问题存在于 Kyoo v4.7.0 中，并已在 master 分支中修复。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：根据官方安装指南（INSTALLING.md）使用 Docker 或 Helm 部署
步骤2：映射你的媒体目录到 Kyoo 容器（无需特定结构）
步骤3：启动后通过 Web 浏览器访问，配置用户和 OIDC 登录（可选）
- 步骤1：根据官方安装指南（INSTALLING.md）使用 Docker 或 Helm 部署
- 步骤2：映射你的媒体目录到 Kyoo 容器（无需特定结构）
- 步骤3：启动后通过 Web 浏览器访问，配置用户和 OIDC 登录（可选）
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止并删除运行的容器/Helm release，移除数据卷（注意备份配置和数据库）。若使用 Docker Compose，执行 `docker compose down -v` 清理全部资源。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ