自建網飛Netflix？別再滿世界找片了，一鍵部署冬瓜TV解決問題。

想看點東西，打開一堆 App，來回切換像在做 K 線交易；好不容易找到資源，又卡成 PPT。於是你開始懷疑人生：我是不是缺的不是會員，而是一個「聚合入口」？

這時候，冬瓜TV（dongguaTV）就來了：主打全網聚合搜索、多源聚合、實時測速、熱門推薦、後臺管理、JSON 持久化配置。它更像一個“聚合檢索 + 播放入口”，而不是Plex/Jellyfin/emby那種以本地媒體庫爲核心的刮削管理器。

一句話：讓你少折騰，點搜索，點開就看。

⚠項目免責聲明：本項目僅供學習研究使用，請勿用於商業用途。使用本項目產生的任何法律問題由使用者自行承擔。請支持正版影視內容。

過去寫過類似的項目還有「MoonTV」、「MoonTV PLUS」、「LibreTV」、「OmniBox」。不過冬瓜TV應該是目前最精緻的，雖然功能可能不是最多。

項目介紹

完整項目名：Minerchu/dongguaTV3。

冬瓜TV是一個基於Node.js + Vue 3的視頻聚合平臺，集成了衆多站點的API，提供智能搜索、資源聚合、實時測速等功能，打造你的私人 Netflix！支持「TMDb智能刮削」+「全網聚合」+「極速播放」。

🎬 雙引擎數據驅動

TMDb (The Movie Database)：提供高質量的電影/劇集元數據（海報、背景圖、評分、簡介、演職員表）。
CMS 聚合源 (Maccms)：集成 48+ 個第三方站點 API，自動進行全網測速，智能過濾失效源，確保播放流暢。

🔍 智能搜索與聚合

實時流式搜索 (SSE)：採用 Server-Sent Events 技術，搜索結果邊搜邊顯，即時反饋，無需等待所有源響應。
自動分組與實時合併：同一影片的不同線路自動聚合，新搜索到的源實時合併到已有卡片，右上角源數量實時跳動。
SQLite 永久緩存：內置高性能 SQLite 數據庫緩存，支持無限存儲，讀寫速度極快，熱搜詞秒級響應。

📺 沉浸式播放體驗

影院模式：全新設計的播放詳情頁，採用暗色系沉浸佈局，支持劇集網格選擇。
智能線路測速：支持用戶端直連測速和服務器代理測速，真實反映視頻可用性。
自動故障轉移：播放失敗時自動切換到下一個可用線路，無需手動操作。
投屏支持：集成 DLNA/AirPlay 本地投屏功能（需瀏覽器支持）。

🌏 大陸用戶優化

智能 IP 雙重檢測：採用 Cloudflare Trace + ipapi.co 雙重檢測機制，準確率高且無 API 速率限制，自動切換到 TMDB 反代模式。
本地資源優先：核心依賴庫（Vue, Bootstrap, DPlayer 等）均本地化部署，徹底解決 CDN 劫持或加載緩慢問題，秒開無壓力。
一鍵安裝腳本：支持交互式配置 API Key、反代地址、運行端口。

📱 多端支持

Android TV / 盒子：提供專屬 APK 安裝包，完美適配電視遙控器操作，支持 Android TV 桌面啓動 (Leanback Launcher)。
移動端 App：基於現代 Web 技術封裝，體驗接近原生應用。
PWA 支持：支持添加到主屏幕，即點即用。

🔒 安全與訪問控制

全局訪問密碼：支持設置全局訪問密碼，且支持記住登錄狀態長達 1 年，既安全又便捷。
遠程配置加載：支持從遠程 URL 加載 db.json 配置文件，方便多站點統一管理。

準備工作

文章以威聯通NAS爲例，通過Docker Compose的方式進行部署。

首先咱們需要搞個TMDB API。註冊賬戶之後，去賬戶設置中開啓一個。如下圖最底下的「API 密鑰」，複製好了備用。

接着打開NAS，準備好部署文件目錄。威聯通的Docker路徑一般爲/share/Container/donggua，大家可以自行更改。然後創建兩個文件放在該目錄下。分別爲db.json和cache.db，如下圖。

其中db.json需要自行配置api。

這裏幫大家整理了一份現成的，黑盒放不了那啥，只能同名GZ號暗號冬瓜TV。下載後請自行修改文件名。如果你有自己的源，可自行修改。筆者並不能保證該源長久有效，並且不負責長期維護更新。

部署流程

然後便可準備部署了，部署代碼如下，大家同樣根據需求自行調整。

services:
donggua-tv:
image: ghcr.io/ednovas/dongguatv:latest
container_name: donggua-tv
ports:
- "3000:3000" # 冒號左側自行更改
environment:
- TMDB_API_KEY=your_api_key_here # 替換成上面的密鑰
- ACCESS_PASSWORD=qnap1234 # 自行更改
- CACHE_TYPE=sqlite
# - TMDB_PROXY_URL=https://tmdb-proxy.your-name.workers.dev
volumes:
- /share/Container/donggua/db.json:/app/db.json # 存儲所有的採集源配置信息
- /share/Container/donggua/cache.db:/app/cache.db # 數據庫文件
- /share/Container/donggua/cache/images:/app/public/cache/images
restart: always

關於TMDB_PROXY_URL，見項目主頁提供的兩種方法。僅需在你無法訪問TMDB時才需配置～