KVideo一键部署完整指南：替代LibreTV的现代视频聚合平台

近年来，类似MoonTV和LibreTV的视频播放聚合平台项目层出不穷，数量显著增多。

这些早期项目通常内置视频源，部署完成后即可直接观看。而后续涌现的OmniBox、冬瓜TV、MoonTVPlus等平台，虽然功能更加强大、界面更为美观、使用也更加便捷，但多数属于空壳应用，需要用户自行导入视频源才能正常使用。

至于这些平台不内置视频源的原因，大家应该都心知肚明。

本期内容将介绍一个新项目：KVideo，它可以作为LibreTV的替代品。这个平台不仅能观看常规内容，还提供了高阶用法。关于订阅信息和高阶用法的详细内容，可通过文末提示获取。

项目概述

完整项目名称是KuekHaoYang/KVideo。该项目兼容ARM和X86这两种主流处理器架构。

KVideo是一款高性能、现代化的视频聚合与播放应用，致力于提供卓越的用户体验和视觉设计。项目采用Next.js 16的最新特性，结合React 19和Tailwind CSS v4，构建了一个既美观又功能强大的视频浏览平台。

主要特性与功能

以下内容根据项目主页进行了精简和总结。

🎥 智能视频播放器

支持HLS流媒体播放，具备缓存和后台下载功能，提供断点续播、倍速播放、全屏模式等完整的播放控制选项，并针对移动设备进行了深度优化。

🔍 多源并行搜索系统

能够同时搜索多个视频源，支持自定义源管理和统一解析，提供搜索历史记录以及多维度的结果排序功能。

🎬 豆瓣信息集成模块

自动获取豆瓣评分、演员信息、剧情简介和相关推荐，让用户在观看前对内容有全面了解。

💾 本地观看历史管理

在本地记录观看进度和历史记录，支持断点续播和一键清理功能，所有数据均不上传服务器，充分保障用户隐私。

📱 全端响应式界面设计

适配桌面和移动设备，触控操作友好，并优先优化移动端的使用体验。

🌙 主题与无障碍辅助功能

支持深色和浅色模式切换，符合WCAG无障碍标准，提供完整的键盘操作支持和高对比度显示选项。

详细部署步骤

以威联通NAS为例，通过Docker Compose方式部署KVideo。

部署代码如下所示：

services:  kvideo:    image: kuekhaoyang/kvideo:latest    container_name: kvideo    ports:      - "5655:3000" # 冒号左侧可改    environment:      - ACCESS_PASSWORD=qnap1234 # 密码访问控制    restart: always

将上述代码根据个人需求修改后，打开威联通的Container Station应用，创建新的应用程序。

实际操作与界面展示

视频源的相关信息，请参考文末提示。

按照上述代码部署完成后，在浏览器中输入NAS_IP:5655即可访问服务。由于设置了访问控制，首次访问需要输入预设密码。

登录后界面如下图所示。平台支持搜索功能、热门分类浏览，右侧还设有观看历史按钮。

随意点击一个分类或视频，但由于尚未配置视频源，页面不会显示任何内容。

接下来点击右上角的齿轮图标进入配置界面。滚动到底部，点击“导入设置”选项。

在“订阅管理”部分，填写订阅名称，在订阅链接栏输入通过提示获取的内容，然后点击“添加”按钮即可完成配置。

返回首页后，再次点击相同内容，视频列表就会正常显示，延迟较低的源会自动排列在前。浏览常规内容时，可以发现其视频源与之前介绍的其他平台相差不大。

播放器支持收藏、速度调整、全屏模式、跳过片头等常用且实用的功能。

总结与获取资源

总体而言，KVideo是一个表现不错的平台。

感谢阅读本篇文章，至此内容结束。

有关订阅和高阶用法的详细信息，可通过特定提示获取。