Kyoo 开源媒体服务器使用教程

1. 项目介绍

Kyoo 是一个自托管的媒体服务器，专注于视频内容（电影、电视剧和动漫）。它是一个替代 Jellyfin 或 Plex 的解决方案，旨在减少维护需求（无需特定的文件夹结构或手动元数据编辑）。Kyoo 不使用插件系统，所有功能都内置于系统中。

主要特点

• 动态转码：支持将媒体转码为任何质量，实时调整并立即跳转。
• 视频预览缩略图：悬停在视频进度条上即可预览视频内容。
• Meilisearch 驱动的搜索：提供高级、抗拼写错误的搜索系统。
• OIDC 连接：支持使用任何符合 OIDC 的服务（如 Google、Discord、Authelia 等）进行连接。
• 观看列表同步：自动将观看列表同步到连接的服务（如 SIMKL）。
• 下载和离线支持：支持下载视频以离线观看，进度会自动同步。
• 增强的字幕支持：支持 SSA/ASS 字幕，并使用视频嵌入字体。
• 动漫名称解析：能够匹配奇怪的动漫名称。
• 云原生：支持分布式运行或在单个设备上运行。

2. 项目快速启动

安装 Kyoo

Kyoo 可以通过 Docker 快速启动。以下是基本安装步骤：

1. 克隆仓库：

   git clone https://github.com/zoriya/Kyoo.git
   cd Kyoo
   

2. 启动 Docker 容器：

   docker-compose up -d
   

3. 访问 Kyoo： 打开浏览器，访问 http://localhost:8080 即可开始使用 Kyoo。

启用 OIDC 和硬件转码

1. 编辑 docker-compose.yml 文件：

   version: '3.8'
   services:
     kyoo:
       image: zoriya/kyoo:latest
       environment:
         - OIDC_ENABLED=true
         - HARDWARE_TRANSCODING=true
       ports:
         - "8080:8080"
       volumes:
         - ./data:/data
   

2. 重启容器：

   docker-compose down
   docker-compose up -d
   

3. 应用案例和最佳实践

应用案例

• 家庭媒体服务器：Kyoo 可以作为家庭媒体服务器，集中管理所有电影、电视剧和动漫，支持多设备访问。
• 小型媒体工作室：媒体工作室可以使用 Kyoo 来管理和分发内部制作的媒体内容。

最佳实践

• 定期更新：定期更新 Kyoo 以获取最新的功能和安全补丁。
• 备份数据：定期备份媒体文件和 Kyoo 的数据库，以防止数据丢失。
• 优化硬件：根据需求配置硬件转码，以提高性能和节省资源。

4. 典型生态项目

Kyoo 作为一个自托管的媒体服务器，可以与其他开源项目结合使用，以增强功能和扩展生态系统。

• Meilisearch：用于增强 Kyoo 的搜索功能。
• FFmpeg：用于视频转码和处理。
• React Native：用于开发 Kyoo 的前端应用。
• Docker：用于容器化部署和管理 Kyoo。

通过这些生态项目的结合，Kyoo 可以提供更强大和灵活的媒体管理解决方案。