TVBox_Web

项目概述

TVBox 的爬虫生态长期绑在电视盒子和安卓模拟器上，手机、电脑浏览器想用往往无从下手。TVBox Web 用双引擎架构解决这件事：Windows 端 Node.js 直接解析 js 引擎爬虫并起 Fastify 服务，Android 端一个 APK 内置 NanoHTTPD 与 Dalvik 爬虫引擎常驻后台，全屋手机、平板、电脑、车机浏览器打开局域网地址就能看。网关层自动解除 CORS 与防盗链，M3U8 流式重写支持拖动快进。

一个服务端，全家浏览器变 TVBox。

项目	内容
形态	自托管影视聚合服务（Windows / Android 双形态）
技术栈	Node.js Fastify 网关 + Android NanoHTTPD/Dalvik + Web 前端
端口	默认 8999
前端依赖	Tailwind 与 HLS.js 全站本地化，零 CDN
许可证	未标注

双引擎架构

• Node 引擎：解析 js 类跨平台爬虫，本地进程直接启动 Fastify 服务，省去安卓虚拟机开销
• Android Dex 引擎：解析 csp 类 Dalvik 字节码爬虫与加密容器，经安卓前台服务或 WSA 容器宿主运行 DexClassLoader
• 零依赖网关：为爬虫请求自动注入 CORS 头；对 m3u8/mp4 流自动补 Referer 与 User-Agent 破防盗链；M3U8 切片路径代理转发并支持 Range 断点续传

播放能力

• 多音轨切换：动态二进制重写 MP4 moov/trak/tkhd 与 MKV EBML Tracks/TrackEntry，抹平 Chromium 与 Gecko 的默认音轨差异，国粤双语自由切换
• 多字幕引擎：嗅探并中继 HLS EXT-X-MEDIA 字幕与网络外挂字幕；本地 srt/vtt/ass/ssa 拖入播放区即转 WebVTT 渲染；识别蓝光 PGS 位图字幕并给出指引
• 专业快捷键：F/D 逐帧、X/C/Z 倍速与记忆、P 画中画、R 旋转、S 截图、W 网页全屏、? 帮助面板
• 网盘与追剧：内置夸克、阿里云盘、百度网盘、115 扫码配置中心；本地历史按集记录断点，一键继续播放

部署启动

1. Windows 双击 start.bat，未装 Node.js 时按 Y 自动安装官方包；静默运行用 start_silent.bat，关停用 stop.bat
2. 端口被 WinNAT/Hyper-V 占用时双击「修复端口占用.bat」智能处理
3. 命令行方式：cd TVBox_Web 后执行 node gateway.js
4. 浏览器打开 127.0.0.1:8999 观影，/website 进网盘扫码配置中心，局域网设备访问本机 IP:8999
5. Android 端安装 APK 后开机自启常驻，其余设备扫码即看

适用人群

• 家里多设备想共用一个影视入口的家庭用户
• 不想折腾模拟器的 Windows 用户
• 需要 PWA 安装与沉浸视窗的浏览器重度用户

注意事项

• 源与合规：播放内容来自用户配置的 TVBox 源，可用性与合规性由源本身决定，请使用有授权的内容源
• 环境要求：Windows 服务端需 Node.js v18+ LTS，便携版可把 node.exe 放入 bin 目录优先使用
• Android 前提：车机与盒子需允许安装 APK 与自启动权限