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

本文最后更新于 2025-10-23，文章内容可能已经过时。

在数字娱乐日益丰富的今天，拥有一个属于自己的影视站，不仅能满足个性化观影需求，还能提升资源管理效率。而 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

在飞牛主页面找到 Docker 打开后，切换菜单 Compose -> 新增项目。
创建项目页面根据实际情况定义 项目名称、选择 路径，选中 创建 docker-compose.yml 后，把上面 yml 文件内容粘贴到文本框中。检查无误后点击 确定 按钮进行部署。
等待部署完成，在容器管理中查看运行状态。