想看点东西，打开一堆 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。内容格式如下：
{
"sites": [
{
"key": "unique_key1", // 唯一标识符（英文字母，不可重复）
"name": "站点名称1", // 显示在界面的名称
"api": "https://...", // Maccms V10/JSON 接口地址
"active": true // 是否启用 (true/false)
},
{
"key": "unique_key2", // 唯一标识符（英文字母，不可重复）
"name": "站点名称2", // 显示在界面的名称
"api": "https://...", // Maccms V10/JSON 接口地址
"active": true // 是否启用 (true/false)
}
]
}
这里帮大家整理了一份现成的，下载后请自行修改文件名。如果你有自己的源，可自行修改。笔者并不能保证该源长久有效，并且不负责长期维护更新。
配置文件：https://wwatc.lanzoub.com/icbiY3e7if9c
或者公粽号私信冬瓜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时才需配置～
打开威联通的Container Station，创建新的应用程序。
使用介绍
按照散文部署代码，成功后在浏览器输入NAS_IP:3000即可访问服务。
输入上文的密码并登入。
初始界面如下。搜索框下方的分类栏目点击可直接跳转到频道所在位置。
看日志便知道，有太多的图需要加载了～大家这里不要着急。
我等了一小会，都刷出来了。
随便找一个。
最后
除了涉及到TMDB的访问问题，整体体验非常不错，有需要的朋友可以抓紧部署～
感谢观看，本文完。
评论区