type
Post
status
Published
date
Feb 19, 2026
slug
kvideo
summary
KVideo 是一款主打现代化 UI 设计的视频聚合平台
tags
建站
开发
教程
category
技术分享
password
icon
文章来源于网络,AI总结
KVideo 是一款主打现代化 UI 设计的视频聚合平台,部署非常简单,主要通过 Docker 进行。以下是针对不同设备的详细安装步骤:
🐳 通用部署方法(Docker)
如果你的设备(如 Windows 电脑、Linux 服务器)已安装 Docker,可以使用命令行一键部署。
- 打开终端 (Windows 用户可以使用 PowerShell 或 CMD)。
- 复制并运行以下命令:
- 请将
你的访问密码替换成你想要设置的密码。 - 如果端口
3000被占用,可以将命令中的3000:3000修改为其他端口:3000(例如3027:3000)。
- 完成!
部署成功后,在浏览器中访问
http://你的设备IP:3000即可开始使用。
📺 群晖 (Synology) NAS 部署
群晖用户可以通过图形化界面轻松完成部署。
- 打开 Docker (Container Manager) 应用。
- 进入 映像 (Images) 页面,在套件内置的镜像库中搜索
kuekhaoyang/kvideo并下载。
- 镜像下载完成后,点击 启动 (Run) 来创建容器。
- 配置容器:
- 端口设置:将容器的
3000端口映射到一个你指定的本地端口(例如3000)。 - 环境变量:添加一个名为
ACCESS_PASSWORD的变量,并设置你的访问密码。 - 卷/文件夹:(可选但推荐)将容器内的
/app/data文件夹映射到 NAS 的一个本地文件夹,以持久化保存数据(如设置、播放记录)。
- 确认无误后,点击 完成 启动容器。
📦 威联通 (QNAP) NAS 部署
威联通用户通常使用 Container Station 进行部署。
- 打开 Container Station 应用。
- 点击 创建 -> 从 Dockerfile 或 docker-compose.yml 创建。
- 选择 Compose,然后将下面的配置代码复制粘贴到编辑框中:
- 修改配置中的密码和存储路径,然后点击 部署。
📱 飞牛 OS (FnOS) 部署
飞牛 OS 用户同样可以通过 Docker Compose 部署。
- 进入飞牛 OS 主界面,找到并打开 Docker 应用。
- 切换到 Compose 菜单,然后点击 新增项目。
- 填写项目名称(如
kvideo),然后将上述威联通部署中的 YAML 配置代码粘贴到编辑框中。
- 修改密码和端口映射后,点击 创建 即可。
⚠️ 重要提示
部署完成后,首次访问 KVideo 时,你会发现片库是空的。配置视频源是让它有内容的关键一步!
- 访问 KVideo 的 Web 界面,输入你设置的密码进入。
- 点击右上角的 设置 (⚙️) 图标。
- 在设置页面底部,找到并点击 导入设置。
- 你可以通过此功能导入他人分享的配置文件或视频源链接,导入后即可搜索和播放影片。
演示:
致谢:
有关Notion安装或者使用上的问题,欢迎您在底部评论区留言,一起交流~
- 作者:RipnCN
- 链接:https://blog.lovou.pw/article/kvideo
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。



