本文最后更新于 2025-10-23，文章内容可能已经过时。

提示： 本文需要结合 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 用户和影视爱好者快速部署使用。无需授权、不依赖账号，轻松打造属于你的影视中心。