🎬 PlayHUB

Box 配置的 Web 化播放器 —— 基于 takagen99-TVBoxOSC 的复刻

特性 • 快速开始 • 使用指南 • 注意事项 • 致谢

---

✨ 特性

• 🌐 前后端分离
  Java (Spring Boot) 后端负责配置拉取、站点接口聚合、JAR 蜘蛛下载与反射调用；Vue3 前端提供流畅的交互体验。

• 📺 完整的影视浏览功能
  支持数据源切换、首页分类展示、关键词搜索、详情弹层、剧集选择与在线播放。

• 📦 JAR Spider 兼容
  通过 URLClassLoader 在服务端动态加载并执行 TVBox 的 JAR 蜘蛛，无需 Android 环境即可使用大部分蜘蛛。

• 💾 本地持久化
  收藏与观看历史自动保存到浏览器 localStorage，无需登录即可下次继续追剧。

• ⚡ 一键部署
  提供预置的运行脚本，Java & Node 环境配置完成即可快速启动。

---

🚀 快速开始

环境要求

工具 / 运行时	最低版本	说明
JDK	17+	运行 Spring Boot 后端
Node.js	20+	构建 & 运行 Vue3 前端
Python	3.9+	部分 Spider Bridge 依赖
Maven	3.9+	调试时使用（可选）

🐳 Docker 部署（推荐）

如果你已安装 Docker，可以使用预构建的镜像快速体验 PlayHUB，无需配置 Java、Node 等环境。

# 拉取镜像
docker pull hurryos/playhub

# 启动容器（默认使用 18080 端口）
docker run -d --name playhub -p 18080:18080 hurryos/playhub

启动后，访问 http://localhost:18080 即可使用。
若需要自定义端口，请修改 -p 参数，例如 -p 8080:18080，然后访问 http://localhost:8080。

本地运行（开发 / 自定义构建）

1. 克隆仓库

git clone https://github.com/your-username/PlayHUB.git
cd PlayHUB

2. 启动后端

方式一：一键脚本（推荐）

# 运行 bin 目录下的对应系统脚本
./bin/start.sh      # Linux / macOS
# 或
bin/start.bat       # Windows

方式二：Maven 调试模式

mvn spring-boot:run

3. 访问应用

启动成功后，访问以下地址：

服务	地址
🖥️ 前端页面	http://localhost:18080/
💚 健康检查	http://localhost:18080/api/health

---

📘 使用指南

1. 🔗 加载配置
   打开页面，在输入框中粘贴配置链接（如 https://example.com/tvbox.json），点击 “加载配置”。

2. 📡 选择站点
   从加载成功的站点列表中，点选你需要使用的数据源。

3. 🏠 浏览首页
   点击 “加载首页”，查看分类推荐内容，或使用顶部搜索栏查找影片。

4. 🎥 在线播放
   进入影片详情页，选择合适的播放源与剧集，开始播放。

5. ❤️ 收藏 & 历史
   喜欢的影片可一键收藏，观看记录自动生成。数据默认保存在浏览器 localStorage，清除缓存会丢失，请注意备份。

6. 🎥 直播 & EPG
   想要的直播一键直达，同类合并+自动换源，EPG支持随心所欲的观看想要的节目。

---

⚠️ 注意事项

• 当前后端 优先支持 type=3（JAR Spider） 以及提供标准 JSON 接口的站点。

---

🙏 致谢

• takagen99/TVBoxOSC —— 本项目灵感与核心逻辑来源

如果 PlayHUB 对你有帮助，欢迎给个 ⭐ Star 鼓励一下！

---

_{Made with ❤️ by the community}