可部署的观影神器：用现代Web技术栈打造隐私优先的私人影院

01 引言

快过年了，想找几个好用的观影神器。之前一直用电视家，随着电视家的下线，一时找不到好用的APP。

于是，想从技术人的角度看看Github上有没有大神开源出直接可用的神器。你还别说，真被为找到了。测试了一下效果，还不错！

02 KVideo

KVideo是一个高性能、现代化的视频聚合与播放应用，专注于提供极致的用户体验和视觉设计。本项目利用 Next.js 16 的最新特性，结合 React 19 和 Tailwind CSS v4，打造了一个既美观又强大的视频浏览平台。采用独特的 "Liquid Glass" 设计语言，提供流畅的视觉体验和强大的视频搜索功能。

GitHub地址：github.com/KuekHaoYang…

2.1 设计理念

项目的视觉设计基于 "Liquid Glass"（液态玻璃） 设计系统，这是一套融合了以下特性的现代化 UI 设计语言：

• 玻璃拟态效果：通过 backdrop-filter 实现的磨砂半透明效果，让 UI 元素如同真实的玻璃材质
• 通用柔和度：统一使用 rounded-2xl 和 rounded-full 两种圆角半径，创造和谐的视觉体验
• 光影交互：悬停和聚焦状态下的内发光效果，模拟光线被"捕获"的物理现象
• 流畅动画：基于物理的 cubic-bezier 曲线，实现自然的加速和减速过渡
• 深度层级：清晰的 z-axis 层次结构，增强空间感和交互反馈

2.2 核心功能

其内部有点类似于TVBox、影视仓类似的盒子，可以订阅资源。但是该软件内置了56个源。

• 智能视频播放：HLS 流媒体支持，提供流畅的视频播放体验，增加了智能缓存机制以及播放的控制
• 多源并行搜索：聚合搜索引擎、自定义视频源
• 豆瓣集成：支持在电影和电视剧之间无缝切换，方便查找不同类型的影视资源，自动获取豆瓣评分、演员阵容、剧情简介等详细信息
• 观影历史：自动记录观看进度和历史，断点续播，隐私保护
• 响应式设计：全端适配，完美支持桌面、平板和移动设备
• 主题系统：支持系统级主题切换，主题切换时的平滑过渡动画
• 无障碍设计：完整的键盘快捷键支持，符合 WCAG 2.2 标准的无障碍实现
• 广告过滤：支持关闭、关键词过滤、智能启发式过滤(Beta)和激进模式
• 隐私保护：本地存储，无服务器数据，自定义源，密码保护

03 部署

官方提供了四种部署方式：

• Docker部署
• Vercel 部署
• Cloudflare Pages 部署
• Node.js部署

我们采用Docker部署的方案。

3.1 Docker Hub 拉取

可以直接使用已经上传的镜像，也可以自己自行构建。我们直接拉取即可：

# 拉取最新版本
docker pull kuekhaoyang/kvideo:latest

3.2 启动

无限制启动：

docker run -d -p 3000:3000 --name kvideo kuekhaoyang/kvideo:latest

这样的启动，只要知道部署的服务器IP和端口，就可以直接访问。

我们来增加一些定制信息以及限制信息：定制平台的展示以及密码

docker run -d -p 3000:3000 
  -e NEXT_PUBLIC_SITE_NAME="私人观影平台" 
  -e NEXT_PUBLIC_SITE_TITLE="私人影院 - 聚合播放平台" 
  -e NEXT_PUBLIC_SITE_DESCRIPTION="专门定制的私人观影平台" 
  -e ACCESS_PASSWORD=private 
  -e PERSIST_PASSWORD=false 
  --name kvideo kuekhaoyang/kvideo:latest

3.3 体验

直接访问：

因为我们设置可密码private，并且每次访问都需要输入。如果PERSIST_PASSWORD=true，则只需要访问一次即可。

输入密码之后，我们就可以进入首页了：

进去之后，我们发现设置NEXT相关的环境变量并没有生效，可能是BUG。我们暂且不关注，下面是默认的变量。

我们看看播放效果：

影片播放非常流畅，还有实时字幕，可以切换语言。

未来，作者可能会加入投屏、弹幕的功能。喜欢的可以期待一下。

这个可以绕开公司的上网策略！！！

04 小结

想部署属于自己的私人影院，不妨试试这个项目。测试下来感觉TVBOX、影视仓类似的电视盒子的资源流畅的多。今天的分享就到这里，我要去寻找关于直播源的相关APP和项目了。