提示: 本文需要结合 KatelyaTV 搭配使用,如果还未部署 KatelyaTV 可以参考这篇教程

KatelyaTV 支持 TVBox 配置接口功能。可以将你在平台上配置的视频源一键导入 TVBox 应用中使用。不需要我们手动整理资源,系统会自动生成标准 JSON 或 Base64 格式链接并同步所有影视源,实现了真正意义上的“即插即用”。


🌟 核心特性

  • 🧩 自动同步:KatelyaTV 中的视频源实时同步到 TVBox,无需重复配置
  • 🔗 一键导入:复制链接即可导入 TVBox,支持 JSON 和 Base64 两种格式
  • 🧠 内置解析接口:支持主流视频平台解析,播放更顺畅
  • 🔍 搜索与筛选:支持快速搜索、分类筛选、广告过滤等功能
  • 🔒 隐私友好:无需登录或授权,配置链接即用,安全可靠
  • 🧼 轻量纯净:无广告、无追踪,部署简单,体验丝滑

📖 使用指南

打开配置页面

进入 KatelyaTV 网站,点击右上角用户按钮打开管理面板页面。

生成配置链接

  • 选择格式类型:

    • ✅ JSON 格式(推荐)
    • 🔐 Base64 格式(适用于特殊环境)
  • 点击「复制」按钮,系统将自动生成配置链接:
JSON 格式:https://your-domain.com/api/tvbox?format=json  
Base64 格式:https://your-domain.com/api/tvbox?format=base64

导入到 TVBox

  1. 打开 TVBox 应用,复制上方的配置链接,支持 JSON 和 Base64 两种格式。
  2. 打开 TVBox 应用,在配置管理中添加新的接口配置,粘贴复制的链接。
  3. 配置导入成功后,即可在 TVBox 中浏览和观看本站的视频内容。

🔄 配置更新

当您在 KatelyaTV 中添加、修改或删除视频源时:

  1. TVBox 配置会自动同步最新的源站信息
  2. 在 TVBox 中刷新配置即可获取最新源站
  3. 无需手动更新配置链接

⚠️ 注意事项

  1. 网络要求:确保 TVBox 设备能够访问您的 KatelyaTV 服务器
  2. HTTPS 支持:建议使用 HTTPS 协议确保安全性
  3. 缓存设置:配置会缓存 1 小时,如需立即更新请刷新 TVBox 配置
  4. 兼容性:支持 TVBox 及其衍生应用
  5. 源站限制:解析效果取决于原始视频源的可用性

🛠️ 故障排除

配置导入失败

  • 检查网络连接
  • 确认配置链接格式正确
  • 尝试使用不同的 format 参数

视频无法播放

  • 检查原始视频源是否可用
  • 尝试使用不同的解析器
  • 确认视频平台是否被支持

源站不显示

  • 检查 KatelyaTV 中是否正确配置了视频源
  • 确认视频源格式符合要求
  • 刷新 TVBox 配置

🧪 总结

TVBox 配置接口是 KatelyaTV 提供的一项高效资源同步功能,支持一键导入、自动更新、格式灵活,适合 NAS 用户和影视爱好者快速部署使用。无需授权、不依赖账号,轻松打造属于你的影视中心。