现代流媒体聚合播放器冬瓜TV MAX

老苏找到了两个版本的 冬瓜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；

准备

配置采集源

首先需要建目录和相应的文件

bash 复制代码

# 新建文件夹 dongguatv 和 子目录
mkdir -p /volume1/docker/dongguatv/cache

# 进入 dongguatv 目录
cd /volume1/docker/dongguatv

# 需要先创建文件，防止挂载成目录
touch db.json cache.db

其中 db.json 中用于存储采集源，格式如下

json 复制代码

{
  "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 更快捷

bash 复制代码

# 运行容器
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 文件

yaml 复制代码

version: '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 登录到您的群晖，执行下面的命令：

bash 复制代码

# 将 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