NAS + Docker 快速部署 OuonnkiTV，打造你的专属观影平台！

在数字娱乐日益丰富的今天，拥有一个属于自己的影视站，不仅能满足个性化观影需求，还能提升资源管理效率。而 OuonnkiTV 正是这样一个开源利器，它让“搭建个人影视平台”变得前所未有地简单和优雅。

🧩 项目简介

OuonnkiTV 是一个由 React + Vite + TypeScript 打造的现代化前端应用，用于聚合搜索与播放网络视频资源，支持跨端播放、搜索与观看历史、以及可配置的视频源管理。项目在 LibreSpark/LibreTV 的基础上进行了重构与优化，提升了模块化设计、状态管理和交互体验。

✨ 核心亮点

功能类别

描述

🔍 搜索体验

实时提示、历史记录、智能联想

▶️ 播放支持

基于 xgplayer，支持 HLS / MP4

📝 内容展示

清晰呈现标题、封面、简介

🕒 历史追踪

自动保存观看与搜索记录

🔄 视频源导入

支持文件、文本、URL 多种方式

⚙️ 个性化设置

主题、偏好自由配置

📱 响应式布局

移动端与桌面端自适应

🧪 状态管理

使用 Zustand，结构清晰稳定

🐳 安装指南

下面介绍通过 Docker Compose 进行部署, 其它部署方式请参考OuonnkiTV 官方说明文档。

命令部署

docker run -d -p 3000:80 -e VITE_PROXY_URL="https://api.codetabs.com/v1/proxy?quest=" ghcr.io/ouonnki/ouonnkitv:latest

3000：冒号前面的端口可以根据自己喜好进行定义，例如：3300:80

Docker Compose 部署

docker-compose.yml 文件内容：

services: ouonnkitv: image: ghcr.io/ouonnki/ouonnkitv:latest container_name: ouonnkitv ports: - "3000:80" environment: NODE_ENV: production VITE_PROXY_URL: ${VITE_PROXY_URL:-https://api.codetabs.com/v1/proxy?quest=} VITE_INITIAL_VIDEO_SOURCES: ${VITE_INITIAL_VIDEO_SOURCES:-} restart: unless-stopped healthcheck: test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:80"] interval: 30s timeout: 10s retries: 3 start_period: 40s

3000：冒号前面的端口可以根据自己喜好进行定义，例如：3300:80

1. 在飞牛主页面找到 Docker 打开后，切换菜单 Compose -> 新增项目。

1. 创建项目页面根据实际情况定义 项目名称、选择 路径，选中 创建 docker-compose.yml 后，把上面 yml 文件内容粘贴到文本框中。检查无误后点击 确定 按钮进行部署。

1. 等待部署完成，在容器管理中查看运行状态。

📖 使用

1. 在浏览器地址输入：http://:3000 可访问 OuonnkiTV 服务

1. 点击页面右上角设置按钮，打开 个性化设置

1. 点击 添加视频源 进行视频源添加

• 新增视频源：增加单个视频源。

• 导入源：支持导入多个视频源的json格式文件。

1. 搜索/播放

⚠️ 免责声明

本文章仅用于技术学习与部署参考，不构成任何使用建议或商业推广。使用者需自行判断资源合法性，遵守所在地区的法律法规。 文章作者不对任何因使用该项目或部署相关服务所引发的法律问题承担责任。

🧾 总结

OuonnkiTV 不只是一个工具，更是一种自由探索的方式。你可以 fork 它、部署它、改造它，甚至参与贡献。如果你正在寻找一个现代化、开源、易部署的影视站解决方案，OuonnkiTV 值得你一试！

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～