type
status
date
slug
summary
tags
category
icon
password
项目地址 🔗 GitHub 仓库： KatelyaTV — https://github.com/dudulove61/KatelyaTV
前言
KatelyaTV自「MoonTV」演进而来，为其二创/继承版本，持续维护与改进功能与体验。 内置了 TVBox 配置接口（GET /api/tvbox），并支持 JSON / Base64 / TXT / XML 等格式，TVBox 应用能通过该接口导入频道源、解析器与播放规则。若要实现设备间同步（播放记录、跳过片头片尾、收藏等），部署时需要考虑持久化与缓存策略。
准备工作
域名与 HTTPS（必须）：TVBox 导入配置强烈建议使用 HTTPS。
配置 CORS：确保 /api/tvbox 与 /api/parse 等接口允许跨域请求。
环境变量（常见）：
APP_HOST（或 NEXT_PUBLIC_HOST）
DATABASE_URL / D1 配置（如使用 Cloudflare D1）
REDIS_URL（如使用 Redis / Upstash）
SESSION_SECRET、JWT_SECRET 等
部署方案一：Docker 单容器（最简单）
优点：快速、可控，适合个人 VPS / 本地调试。
缺点：单机状态，不利于多实例扩展。
示例 docker-compose（最简单）：
注意：
持久化日志与数据（如果使用内置数据库或 sqlite）。
若想支持 TVBox 的多设备状态同步，考虑将缓存/会话外置到 Redis。
部署方案二：Docker + Redis（推荐用于家庭多用户）
优点：高性能缓存、跨实例同步（播放记录、跳过片头）、成熟生态。
示例 docker-compose（含 redis）：
小贴士：
开启 Redis AUTH，配置持久化与备份。
在 KatelyaTV 中配置 REDIS_URL，以启用共享缓存和跳片头等功能。
部署方案三：Vercel + Upstash 🚀💸 (免费推荐)
🎯 特点
完全免费（适合轻量用户、白嫖党）💰
自动开启 HTTPS 🔒
全球 CDN 加速，访问速度快 ⚡
无需自备服务器，部署流程简单 ✨
🚀 部署步骤
1. Fork 项目
打开 KatelyaTV GitHub 仓库
点击右上角 Fork，把项目复制到自己的 GitHub 账户下
2. 部署到 Vercel
登录 Vercel 官网
点击 New Project → Import Git Repository
选择刚才 Fork 的仓库
在 Environment Variables（环境变量） 添加：
Plaintext
⚠️ 这里的 PASSWORD 是管理员登录密码，请修改为复杂密码。
点击 Deploy，稍等片刻，Vercel 会自动完成构建和部署
部署成功后，你将得到一个类似 https://xxxx.vercel.app 的访问地址
👥 多用户配置 (推荐)
如果只设置 PASSWORD，只能单用户使用。想要多用户管理，就需要用 Upstash 来存储数据。
1. 创建 Upstash 数据库
登录 Upstash 官网
创建一个免费的 Redis 数据库 📊
获取数据库的连接信息：
UPSTASH_URL
UPSTASH_TOKEN
2. 添加环境变量
在 Vercel 项目设置里，进入 Settings → Environment Variables，新增：
Plaintext
📌 USERNAME 和 PASSWORD 是管理员账号和密码
3. 重新部署
在 Vercel Dashboard → 点击项目 → Redeploy
即可应用新的环境变量配置。🔄
✅ 使用体验
单用户模式：简单快速，适合个人使用 👩💻
多用户模式：结合 Upstash，支持多人账号、注册登录、数据持久化 👨👩👧👦
免费额度：
Vercel 免费版每月 125 小时构建时长 ⏱️
Upstash 免费版每月 10,000 次请求，轻度使用绰绰有余 ✨
部署方案四：Docker + Kvrocks（生产环境）
优点：Kvrocks 使用 RocksDB，磁盘效率高，适合长期大量数据。
缺点：运维、监控需要注意磁盘 IO 与 compaction。
示例（docker-compose）：
适用场景：
你希望在低成本 VPS 上获得比传统 Redis 更高的磁盘压缩效果，但仍兼容 Redis 协议。
方案五：Cloudflare Pages + D1（全球加速）
特点：全球 CDN，无限带宽，免费 SSL
快速部署
Fork 项目 → GitHub 仓库
创建 Pages 项目：
登录 Cloudflare Dashboard
Pages → Connect to Git → 选择仓库
构建设置：
Build command:
Build output directory:
兼容性标志：环境变量配置：创建 D1 数据库（多用户支持）：配置数据库绑定 → 在 wrangler.toml 中添加数据库 ID
与 TVBox 的联动细节（核心）
接口：/api/tvbox 支持 format 参数（json、base64、txt、xml）。TVBox 通过这个接口导入配置。
自动同步：
如果 KatelyaTV 后端开启缓存/同步（Redis / Upstash / D1 / Kvrocks），TVBox 在刷新配置时可以立即看到新增的源。
若使用单容器且未启用共享缓存，多设备间的播放记录/跳片头等功能可能无法同步。
CORS / HTTPS：强制使用 HTTPS，配置正确的 CORS header，防止 TVBox 导入失败。
缓存策略：推荐默认缓存 1 小时，需要即时更新时提供手动刷新接口或短缓存 TTL。
配置地址生成：
JSON 格式：https://你的域名/api/tvbox?format=json
TXT 格式：https://你的域名/api/tvbox?format=txt
XML 格式：https://你的域名/api/tvbox?format=xml
支持的 TVBox 应用：
TVBox（开源版）
CatVodTVOfficial
EasyBox
FongMi TV
其他兼容应用
配置导入步骤：
打开 TVBox 应用
进入「配置」或「设置」页面
选择「导入配置」或「添加配置」
输入上述配置地址
等待导入完成
🔄 多设备数据同步
[](https://github.com/katelya77/KatelyaTV?tab=readme-ov-file#-%E5%A4%9A%E8%AE%BE%E5%A4%87%E6%95%B0%E6%8D%AE%E5%90%8C%E6%AD%A5)
支持的数据：
观看历史记录
收藏夹内容
跳过片段设置
用户偏好配置
同步方式对比：
存储方式 | 同步范围 | 配置难度 | 免费程度 |
LocalStorage | 单设备 | 无需配置 | 完全免费 |
Redis | 全同步 | 需要服务器 | 自建免费 |
Upstash | 全同步 | 简单配置 | 有免费额度 |
D1 | 全同步 | 中等难度 | 完全免费 |
Kvrocks | 全同步 | 需要部署 | 自建免费 |
手动导入配置
配置下载 ⬇️
基础版 config_isadult.json
配置方式：
Docker：挂载配置文件 -v ./config.json:/app/config.json:ro
Vercel：替换仓库中的 config.json 文件内容
管理员界面：登录后台 /admin 导入配置
推荐选择
个人/测试：Docker 单容器（快速上手）。
小团队/生产：Docker + Redis（或 Kvrocks）以保证跨实例一致性。
想要极简运维、前端优先：Vercel + Upstash（注意成本与冷启动）。
全球分发与 Edge 场景：Cloudflare Pages + D1（遵循迁移指南）。
结语
把 KatelyaTV 做成你的电视盒子后厨，关键在于：选择合适的存储/缓存方案以保证与 TVBox 的实时性和一致性；做好 HTTPS 与 CORS 配置；并根据访问量与维护能力在 Docker、本地数据库与 Serverless 间取舍。希望这篇文章能帮你在下一个视频中顺利演示「点一点 → TVBox 一键导入 → 全家都能看」的华丽场景。
如果你希望我出一篇「一步步从零到能被 TVBox 导入的视频教学」，或者想要我把上面某一种部署写成详细的 shell 脚本与 docker-compose 文件，留言告诉我你的云服务商和预算，我来为你量身定制！
- 作者:Tox
- 链接:https://tox.wang/article/example-7
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
