现代流媒体聚合播放器，基于 Node.js + Express + Vue 3 构建。原版项目：Minerchu/dongguaTV

相比原版，本作重构了前后端，新增了实时流式搜索、弹幕、分享深链与未登录预览、TMDB 反代、智能 CORS 代理与边缘去广告、多用户历史云同步、SEO/社媒卡片、Android/PWA/TV 模式等大量功能。

https://ednovas-test.vercel.app （不包含任何数据）

• ✨ 核心特性
• 🎨 界面升级
• 🛠️ 技术栈
• 🔧 前置准备
• 📦 安装与运行
  • 环境变量总表
• 🚀 部署
  • Docker 部署
  • Vercel 部署
  • PM2 部署
  • 宝塔面板部署
• 🔒 安全与高级功能
• 🛡️ 广告过滤
• 🗨️ 弹幕
• 🔗 分享、深链与未登录预览
• 🔎 SEO 与社媒卡片
• 📺 TV 模式
• 🎛️ 偏好设置
• 🤖 Android APP
• 💾 数据维护与备份
• ⚠️ 免责声明

• TMDb：高质量电影/剧集元数据（海报、背景图、评分、简介、演职员表）
• CMS 聚合源 (Maccms)：集成多个自定义第三方资源站 API，自动全网测速，智能过滤失效源

• 实时流式搜索 (SSE)：结果边搜边显，即时反馈，源数量实时跳动
• 智能关键词匹配：自动生成搜索变体（去除副标题、季数后缀等），同时搜索中英文名
• 自动英中翻译：检测英文搜索词时自动通过 TMDB 获取中文译名（如 "Stranger Things" → "怪奇物语"）
• 自动分组与合并：同一影片的不同线路自动聚合到一张卡片
• 多级缓存：SQLite / JSON / 内存，热搜词秒级响应

• 影院模式：暗色系沉浸布局，剧集网格选择（DPlayer + HLS.js）
• 🗨️ 弹幕：可挂接自建弹幕聚合服务，聚合爱奇艺/腾讯/优酷/B站/芒果/360 等平台弹幕（需配置 DANMU_API_URL，详见弹幕）
• 双模式测速：客户端直连测速 + 服务器端兜底测速（/api/check），真实反映可用性
• 自动故障转移：播放失败自动切换下一可用线路
• 倍速播放：0.5x–2x 调速，选择记忆到本地，TV 模式带专用调速按钮
• 投屏支持：集成 DLNA/AirPlay 本地投屏（自动保持屏幕常亮）
• 🛡️ 边缘去广告：通过 CORS 代理在 Cloudflare Worker 边缘按时长剔除 M3U8 广告分段（详见广告过滤）

• 一键分享：生成 ?play=剧名&ep=集名&t=秒数 深链，可复制或分享到微信/QQ/Telegram/WhatsApp/Facebook/X/Instagram
• 未登录预览锁定框：未登录用户打开分享链接，仅展示标题+简介+海报（来自 /api/preview，不访问任何资源站），登录后解锁播放
• 社媒卡片：社交爬虫抓取分享链接时返回 OpenGraph / Twitter Card 富预览

• 智能 IP 检测：Cloudflare 头 + api.ip.sb 地理库判定大陆/海外，自动切换 TMDB 反代模式（或用 SERVER_IN_CHINA=true 强制）
• 本地资源优先：核心依赖库（Vue、Bootstrap、DPlayer、HLS.js 等）全部本地化部署，无 CDN 依赖，秒开
• 智能 CORS 代理：资源站直连失败或过慢时自动走代理并"记住"该站点（24h），自动重写 m3u8、绕过防盗链
• 一键安装脚本：交互式配置

• Android App：沉浸式状态栏，适配刘海屏（Capacitor）
• PWA：添加到主屏幕即点即用，Service Worker 离线缓存
• 电视/盒子：TV 模式遥控器导航，自动检测智能电视；启动屏自带 WebView 兼容性检测

• 全局访问密码：支持记住登录状态 1 年
• 多用户模式：每个密码一个独立用户，观看历史跨设备云同步
• 接口限流：按 IP 分级限流（通用 600/分、搜索 120/分、预览 40/分等），并对 TMDB/弹幕上游调用做全站封顶防刷
• 远程配置加载：REMOTE_DB_URL / SITES_JSON 多站点统一管理

本项目不包含任何内置影视资源接口。需自行添加合法的 Maccms V10 (JSON 格式) 接口。

所有配置存储在 db.json 文件中（首次运行自动生成）：

{
  "sites": [
    {
      "key": "unique_key1",
      "name": "站点名称1",
      "api": "https://...",
      "active": true
    }
  ]
}

1. 注册：Create Account
2. 申请 API：API Settings → Create
3. 应用类型选 Developer，用途填 "Personal learning project"
4. 复制 API Key (v3 auth) 备用

TMDB 在大陆无法直接访问，需要配置反向代理：

1. 登录 Cloudflare Dashboard → Workers & Pages → Create Worker
2. 复制 cloudflare-tmdb-proxy.js 内容到编辑器 → Save and Deploy
3. 获取 Worker URL，在 .env 中配置：

   TMDB_PROXY_URL=https://tmdb-proxy.your-name.workers.dev
   # 若服务器本身在大陆，建议同时设置 SERVER_IN_CHINA=true 强制走反代

当服务器或用户无法直接访问资源站时，系统自动通过 CORS 代理中转。边缘去广告也依赖此代理。

核心功能：

• ✅ 智能学习：直连失败或过慢（>1.5s）时自动改走代理，并记住该站点 24h
• ✅ 双延迟比较：仅当直连 >1500ms 且代理快 30% 以上才切换，避免无谓代理
• ✅ m3u8 重写：自动把 ts 分片改写为经代理（ts 视频本身仍由 CDN 直传，不二次代理）
• ✅ 防盗链绕过：上游返回 401/403/404/451 时自动去掉 Referer/Origin 重试
• ✅ 边缘去广告：按时长剔除广告分段（详见广告过滤）

UI 状态标识： 🟢 直连 ｜ 🟡 中转 ｜ 🔵 服务器测速

⚠️ 免费版每日 10 万次请求限制。个人自用通常没问题，多人使用建议用 VPS 方案。

1. Cloudflare → Workers & Pages → Create Worker
2. 复制 cloudflare-cors-proxy.js → Save and Deploy
3. 配置 .env：

   CORS_PROXY_URL=https://cors-proxy.your-name.workers.dev

npm install express axios cors dotenv
PORT=8080 node proxy-server.js
# 或 PM2 守护：pm2 start proxy-server.js --name cors-proxy
# 可选：设置 PROXY_PASSWORD 后，调用需带 Authorization: Bearer <password>

.env 配置：CORS_PROXY_URL=http://your-vps-ip:8080

如需弹幕，需自行部署一个 danmu_api（聚合主流平台弹幕、兼容弹弹play 的服务），然后在 .env 配置 DANMU_API_URL。详见弹幕章节。

curl -fsSL https://raw.githubusercontent.com/ednovas/dongguaTV/main/install.sh | bash

脚本会引导输入 TMDB API Key、反代地址、运行端口等。

# 1. 安装 Node.js v18+
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 2. (可选) SQLite 编译工具 —— 使用 CACHE_TYPE=sqlite 时必需
sudo apt-get install -y build-essential python3

# 3. 安装依赖
git clone https://github.com/ednovas/dongguaTV.git
cd dongguaTV && npm install

# 4. 配置环境变量
cp .env.example .env && nano .env

# 5. 启动
node server.js

访问 http://localhost:3000

* SITE_URL 未设置时自动从请求 Host/X-Forwarded-Host 头推断，最终回退为 https://ednovas.video。

💡 注：DANMU_API_URL、DANMU_API_TOKEN、SERVER_IN_CHINA、SITE_URL、PROXY_PASSWORD 这几项当前未写入 .env.example，但代码均已支持，按需在 .env 中直接添加即可。

🎉 多架构支持：自动匹配 linux/amd64、linux/arm64、linux/arm/v7

镜像同时发布到 GitHub Container Registry 和 Docker Hub，选择任一即可：

💡 如果 ghcr.io 拉取报 manifest unknown，请使用 Docker Hub 镜像或升级 Docker 到 20.10+。

docker run -d -p 3000:3000 \
  -e TMDB_API_KEY="your_api_key_here" \
  -e ACCESS_PASSWORD="your_password" \
  --name donggua-tv \
  --restart unless-stopped \
  ednovas/dongguatv:latest

# 1. 先创建文件，防止 Docker 将其识别为目录
touch db.json cache.db
echo '{"sites":[]}' > db.json
mkdir -p cache/images

# 2. 启动
docker run -d -p 3000:3000 \
  -e TMDB_API_KEY="your_api_key_here" \
  -e ACCESS_PASSWORD="your_password" \
  -e TMDB_PROXY_URL="https://tmdb-proxy.your-name.workers.dev" \
  -e CORS_PROXY_URL="https://cors-proxy.your-name.workers.dev" \
  -e DANMU_API_URL="https://your-danmu-api.workers.dev" \
  -e REMOTE_DB_URL="https://example.com/db.json" \
  -v $(pwd)/db.json:/app/db.json \
  -v $(pwd)/cache.db:/app/cache.db \
  -v $(pwd)/cache/images:/app/public/cache/images \
  --name donggua-tv \
  --restart unless-stopped \
  ednovas/dongguatv:latest

⚠️ 如果报错 EISDIR: illegal operation on a directory，说明没有先创建文件。执行 rm -rf db.json && touch db.json 后重试。

services:
  donggua-tv:
    image: ednovas/dongguatv:latest
    container_name: donggua-tv
    ports:
      - "3000:3000"
    environment:
      - TMDB_API_KEY=your_api_key_here
      - TMDB_PROXY_URL=https://tmdb-proxy.your-name.workers.dev
      - CORS_PROXY_URL=https://cors-proxy.your-name.workers.dev
      - ACCESS_PASSWORD=your_secure_password
      - REMOTE_DB_URL=https://example.com/db.json
    volumes:
      - ./db.json:/app/db.json
      - ./cache.db:/app/cache.db
    restart: unless-stopped

touch db.json cache.db
docker compose up -d

docker build -t donggua-tv .
docker run -d -p 3000:3000 -e TMDB_API_KEY="your_key" --name donggua-tv donggua-tv

在 Settings → Environment Variables 中添加：

• TMDB_API_KEY（必填）
• REMOTE_DB_URL 或 SITES_JSON（二选一，推荐 SITES_JSON）
• ACCESS_PASSWORD、TMDB_PROXY_URL、DANMU_API_URL（可选）

SITES_JSON 用法： 直接填入 JSON 或 Base64 编码的 db.json 内容：

SITES_JSON={"sites":[{"key":"ffzy","name":"非凡影视","api":"https://api.ffzyapi.com/api.php/provide/vod/"}]}

由于 Serverless 无法持久化文件系统：

• ❌ SQLite 缓存（自动改用内存缓存）
• ❌ 本地图片缓存
• ❌ 本地 db.json（必须配置 REMOTE_DB_URL 或 SITES_JSON）
• ❌ 多用户历史同步（需要持久化存储）

# 安装 Node.js + PM2
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g pm2

# 获取代码
git clone https://github.com/ednovas/dongguaTV.git
cd dongguaTV && npm install
cp .env.example .env && nano .env

# 启动并设置开机自启
pm2 start server.js --name "donggua-tv"
pm2 save && pm2 startup

1. 软件商店 安装 Node.js 版本管理器 (v18+)
2. SSH 安装编译工具（CACHE_TYPE=sqlite 时需要）：

   # Ubuntu/Debian
   sudo apt-get install build-essential python3 -y
   # CentOS
   sudo yum groupinstall "Development Tools" -y && sudo yum install python3 -y

3. 网站 → Node 项目 → 添加，启动选项 server.js，端口 3000
4. 配置 .env 文件，重启服务
5. 映射/绑定域名

ACCESS_PASSWORD=your_secure_password

开启后访问任何页面都需要密码，登录状态最长记住 1 年。

REMOTE_DB_URL=https://example.com/my-config/db.json

5 分钟内存缓存，远程失败自动降级到本地 db.json。

多个密码用逗号分隔，每个密码代表一个独立用户：

ACCESS_PASSWORD=admin_password,user1_pass,user2_pass

同步特性： 自动同步 · 本地优先 · 智能合并（以最新观看记录为准） · 隐蔽状态提示。 （端点：/api/history/pull、/api/history/push、/api/history/clear）

⚠️ 历史同步仅在 CACHE_TYPE=sqlite 模式下可用。

服务端内置按真实客户端 IP（CF-Connecting-IP / X-Real-IP，含 IPv6 子网归一）的分级限流：通用 API 600/分、搜索 120/分、预览 40/分等；并对 TMDB、弹幕等上游调用做全站每分钟封顶，防止被人用伪造 IP + 变换参数刷成放大器。

去广告在 Cloudflare Worker（CORS 代理）边缘侧完成，因此需先配置 CORS_PROXY_URL 并让 m3u8 经代理加载（直连不经代理时不去广告）。

代理在改写 m3u8 时（cloudflare-cors-proxy.js 的 rewriteM3u8）：

1. 按时长剔除广告段组：识别 #EXT-X-DISCONTINUITY 标记切出的分段组，剔除"时长约 3–120 秒且分片数 <15"的可疑广告组；
2. 去内联追踪/广告分片：丢弃时长极短（<0.5s）的非 ts 追踪分片，以及指向 .vip/.bet/.casino/.top/.xyz/.buzz/.click 等可疑 TLD 的分片；
3. 清理 SSAI 标签：去除 #EXT-X-CUE、#EXT-X-DATERANGE、#EXT-X-SCTE35 等服务端插播元数据；
4. 正片直传：真正的 ts 视频分片仍由源站 CDN 直接拉取，不经代理二次中转。

说明：广告判定基于分段时长/数量启发式，而非维护广告平台域名黑名单。客户端仅决定"是否把该 m3u8 交给代理"，实际剔除发生在边缘。

播放器可挂接弹幕，弹幕数据来自一个自建的第三方弹幕聚合服务 danmu_api（兼容弹弹play、聚合爱奇艺/腾讯/优酷/B站/芒果/360 等平台）。后端把"剧名+集名"映射到该服务并转成 DPlayer v3 格式喂给播放器。

1. 自行部署一个 danmu_api 服务（Cloudflare Workers 或自建均可）。
2. 配置环境变量：

   DANMU_API_URL=https://your-danmu-api.example.com
   # 若该服务需要鉴权令牌：
   DANMU_API_TOKEN=your_token

3. 重启服务。未配置 DANMU_API_URL 时弹幕优雅降级（返回空弹幕，不报错、不影响播放）。

• 主标题归一：去掉 (2022)、【国产剧】 等年份/标签后缀，避免"破事精英"误命中"破事精英 第二季"
• 集号识别：优先抓"第 N 集/话/期"中的 N，忽略剧名里的数字
• 平台回退排序：优先 爱奇艺/腾讯/优酷/360，跳过常返空且较慢的源
• 结果缓存：搜索结果按剧名短缓存供同剧各集复用；弹幕内存缓存命中 30 分钟、空结果 5 分钟（命中结果对 CDN 走长缓存）
• 体积控制：单集弹幕上限 6000 条，超出按时间均匀采样
• 防刷：上游弹幕查询全站每分钟封顶

端点：GET /api/danmaku/v3/?id=<剧名|集名>（DPlayer 约定）。

播放页可一键生成深链并复制 / 分享到微信、QQ、Telegram、WhatsApp、Facebook、X、Instagram（App 内走原生分享）：

https://your-site.com/?play=剧名&ep=集名&t=秒数

打开深链会自动（必要时先登录）搜索并定位到对应剧集、从指定时间点续播。

未登录用户打开分享深链时，会看到一个锁定预览框：仅显示标题、TMDB 简介与海报，播放器为黑屏并提示登录。该预览数据来自 GET /api/preview?name=<剧名>，全程不搜索、不访问任何资源站，登录后才解锁真正播放。

接口侧带内存缓存（命中 6h、未命中 10min）+ 单 IP 限流（40/分）+ 全站 TMDB 调用封顶（300/分），避免被当作 TMDB 放大器。

当社交平台爬虫（按 User-Agent 识别）抓取 /?play=剧名 时，服务器返回带 OpenGraph / Twitter Card 的富预览页（标题/海报/简介），普通用户照常拿到 SPA。

为便于搜索引擎收录与社交分享，服务端额外提供：

如需保证卡片/规范链接使用固定域名，设置 SITE_URL=https://your-domain.com。

页面底部提供 TV 模式切换入口，支持遥控器方向键导航。

TV 模式特性： 方向键导航 · 焦点高亮 · 确认键选择 · 返回键退出 · 专用倍速/换源按钮

自动检测： Android TV · Fire TV · Samsung Tizen · LG WebOS · Roku · Chromecast

启动时会做 WebView 兼容性检测（Proxy/fetch/Promise 等），老旧电视盒子内核不支持时给出提示而非白屏。

页面底部 ⚙️ 偏好设置按钮，配置自动保存到 localStorage。

推送 v*.*.* 格式的 Tag 时自动触发构建，在 Releases 页面下载 APK（通用包，含 armeabi-v7a / arm64-v8a / x86 / x86_64）。

git tag v1.0.0
git push origin v1.0.0

无需修改代码，在 GitHub Actions → Android Build & Release → Run workflow 中填入：

• Server URL、App Name、Version Tag

构建会自动从站点图标生成应用图标并签名（有 Release 签名密钥则用之，否则回退 debug 签名）。

npm install && npx cap sync android
cd android && ./gradlew assembleRelease

遇到安装失败、闪退、播放异常等问题？推荐以下替代方案：

1. 🌐 网页版（推荐） — 兼容性最好，无需安装，电视推荐当贝浏览器
2. 📺 投屏播放 — 点击「一键投屏」，支持 DLNA/AirPlay
3. 📱 PWA 模式 — 浏览器中「添加到主屏幕」

核心数据文件：

# 备份
mkdir -p ~/backup
cp /opt/dongguaTV/db.json ~/backup/
[ -f /opt/dongguaTV/cache.db ] && cp /opt/dongguaTV/cache.db ~/backup/

# 清理缓存
rm /opt/dongguaTV/cache.db  # 或 rm /opt/dongguaTV/cache_*.json
pm2 restart donggua-tv

本项目由 kk爱吃王哥呆阿龟头 设计编写，ednovas 优化了功能和部署流程。弹幕能力借助开源 danmu_api（聚合主流平台、兼容弹弹play）。数据由 TMDb 和各式 Maccms API 提供。

1. 仅供学习交流：本项目仅作为 Node.js 和 Vue 3 的学习练手项目开源。
2. API 说明：本项目不内置任何有效的影视资源采集接口，文档/代码中的地址仅为占位示例。
3. 自行配置：使用者需自行寻找合法的 Maccms V10/JSON 接口，并遵守相关法律法规。
4. 内容无关：开发者不存储、不发布、不参与任何视频内容的制作与传播。

Enjoy your movie night! 🍿