老苏找到了两个版本的 冬瓜TV，和 MoonTV、MoonTVPlus、OmniBox、KatelyaTV、KVideo 等的核心功能一样，都是基于 Maccms V10 的视频聚合、搜索、播放平台
其中一个是 冬瓜TV（dongguaTV），项目地址：https://github.com/Minerchu/dongguaTV
另一个是 冬瓜TV MAX（DongguaTV Enhanced Edition），项目地址：https://github.com/EdNovas/dongguaTV
今天要介绍的是第二个 冬瓜TV MAX，之所以还要提 冬瓜TV，是因为这个版本的 https://github.com/Minerchu/dongguaTV/blob/main/server.js 中，还有资源地址，而 冬瓜TV MAX（# DongguaTV Enhanced Edition） 现在只是个空壳子
当然，你也可以看看老苏写的 OmniBox，只是需要自己按 冬瓜TV MAX 要求的格式重新编辑
前言什么是 冬瓜TV MAX ？
冬瓜TV MAX 是一款基于 Node.js 和 Vue 3 构建的现代流媒体聚合播放器，为用户提供高质量的影视内容访问体验。该应用程序经过全面重构和升级，引入了许多新功能，来满足视频爱好者的需求。
主要特点
🎬 双引擎数据驱动：
利用 TMDb 提供的高质量电影和剧集元数据。
支持集成 Maccms 数据源，自动进行全网测速，智能过滤失效源以确保播放流畅。
🔍 智能搜索与聚合：
实时流式搜索技术实现边搜边显，用户无需等待结果。
自动分组和实时合并同一影片的不同线路。
内置高性能 SQLite 数据库缓存，支持无限存储，读写速度极快，热搜词秒级响应。
📺 沉浸式播放体验：
提供影院模式，刷新设计的播放详情页，支持剧集选择。
智能线路测速和自动故障转移，确保连续观看体验。
🌏 用户友好性：
针对大陆用户的智能 IP 双重检测，确保稳定性和快速访问。
多端支持，包括 Android TV 和移动端应用，提供接近原生的用户体验。
🔒 安全与访问控制：
支持设置全局访问密码，保护隐私安全。
支持远程加载配置文件，便于多站点管理。
应用场景
个人家庭娱乐：用户可以在家庭环境中使用 冬瓜TV MAX 观看自己喜欢的影视内容。
流媒体服务：适合需要高效视频播放和管理功能的家庭或小型社交群体。
视频内容开发者：内容创作者可以利用该平台展示他们的作品或组织视频活动。
冬瓜TV MAX 以其高度兼容性、丰富的功能和用户友好的界面，成为了一个优秀的私有流媒体解决方案，能提升用户的观看体验和视频管理
安装在群晖上以 Docker 方式安装。
本文写作时， latest 版本对应为 1.0.17；
准备配置采集源首先需要建目录和相应的文件
12345678# 新建文件夹 dongguatv 和 子目录mkdir -p /volume1/docker/dongguatv/cache# 进入 dongguatv 目录cd /volume1/docker/dongguatv# 需要先创建文件，防止挂载成目录touch db.json cache.db
其中 db.json 中用于存储采集源，格式如下
12345678910111213141516{ "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) } ]}
需要注意的是，最后的 db.json 中不要带注释，会导致报错
获取 TMDb API Key冬瓜TV MAX 依赖 The Movie Database (TMDb) 提供影视元数据
注册账户：访问 https://www.themoviedb.org/signup 注册并登录。
申请 API：访问 https://www.themoviedb.org/settings/api，点击 “Create” 或 “click here” 申请。
填写信息：应用类型选择 “Developer”，简单填写用途（如 “Personal learning project”）。
获取 Key：申请通过后，复制 “API Key (v3 auth)” 备用。
TMDB 反代 (可选)如果你的网络无法访问 TMDB，需要配置反向代理才能正常显示海报和影视信息
官方提供了 Cloudflare Workers 反代方式，有需要的可以看官方文档：https://github.com/EdNovas/dongguaTV#方案一部署-cloudflare-workers-反代-推荐
docker cli 部署如果你熟悉命令行，可能用 docker cli 更快捷
12345678910111213# 运行容器docker run -d \ --restart unless-stopped \ --name donggua-tv \ -p 3778:3000 \ -v $(pwd)/db.json:/app/db.json \ -v $(pwd)/cache.db:/app/cache.db \ -v $(pwd)/cache:/app/public/cache \ -e TMDB_API_KEY=your_key_here \ -e TMDB_PROXY_URL=https://tmdb-proxy.your-name.workers.dev \ -e ACCESS_PASSWORD=your_secure_password \ -e CACHE_TYPE=sqlite \ ghcr.io/ednovas/dongguatv:latest
环境变量
说明
默认值
TMDB_API_KEY
TMDb API 密钥，用于获取影视元数据
your_key_here
PORT
运行端口，用于访问服务
3000
TMDB_PROXY_URL
（可选）大陆用户的 TMDB 反代地址
空
CACHE_TYPE
缓存类型，可选值有：json（默认）、sqlite、memory 或 none
json
ACCESS_PASSWORD
（可选）访问密码，设置后需要输入密码才能使用
空
REMOTE_DB_URL
（可选）远程配置文件地址，从远程 URL 加载 db.json 配置
空
docker-compose 部署也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件
123456789101112131415161718version: '3'services: donggua-tv: image: ghcr.io/ednovas/dongguatv:latest container_name: donggua-tv restart: unless-stopped ports: - "3778:3000" volumes: - ./db.json:/app/db.json - ./cache.db:/app/cache.db - ./cache:/app/public/cache environment: - TMDB_API_KEY=your_key_here - TMDB_PROXY_URL=https://tmdb-proxy.your-name.workers.dev - ACCESS_PASSWORD=your_secure_password - CACHE_TYPE=sqlite
然后通过 SSH 登录到您的群晖，执行下面的命令：
1234# 将 docker-compose.yml 放入项目根目录# 一键启动docker-compose up -d
运行在浏览器中输入 http://群晖IP:3778 就能看到登录界面
填入 ACCESS_PASSWORD 的值
登录成功
如果网络访问 TMDB 没问题或者 TMDB 反代没问题，应该很快就能看到图片
如果完全不成功，那应该是设置或者代理的问题，如果有些成功，有些失败
一般都是网络延迟问题导致的，日志中可以看到超时，可以多刷新几次
不影响搜索
也不影响观看
如果你想用 Android APP 访问，需要自己编译，具体办法参考：https://github.com/EdNovas/dongguaTV#-android-app-构建-github-actions
参考文档
Minerchu/dongguaTV: 冬瓜TV —— 打造你的私人 Netflix！TMDb 智能刮削 + 全网聚合 + 极速播放地址：https://github.com/Minerchu/dongguaTV
EdNovas/dongguaTV地址：https://github.com/EdNovas/dongguaTV