KatelyaTV 部署指南配合TVBox安装-简单博客

官方

前言

KatelyaTV自「MoonTV」演进而来，为其二创/继承版本，持续维护与改进功能与体验。内置了 TVBox 配置接口（GET /api/tvbox），并支持 JSON / Base64 / TXT / XML 等格式，TVBox 应用能通过该接口导入频道源、解析器与播放规则。若要实现设备间同步（播放记录、跳过片头片尾、收藏等），部署时需要考虑持久化与缓存策略。

部署方案一：Docker 单容器（最简单）

优点：快速、可控，适合个人 VPS / 本地调试。

缺点：单机状态，不利于多实例扩展。

示例 docker-compose（最简单）：

version: "3.8"
services:
  katelyatv:
    image: ghcr.io/katelya77/katelyatv:latest
    container_name: katelyatv
    restart: unless-stopped
    ports:
      # 本地访问端口：建议修改前面的 3000 为自己喜欢的端口，避免和其他服务冲突
      # 例如改成 "8080:3000" 就是用 http://IP:8080 访问
      - "3000:3000"
    environment:
      - PASSWORD=10000
      # 设置访问密码，建议更换为复杂密码

注意：

持久化日志与数据（如果使用内置数据库或 sqlite）。

若想支持 TVBox 的多设备状态同步，考虑将缓存/会话外置到 Redis。

部署方案二：Docker + Redis（推荐用于家庭多用户）

优点：高性能缓存、跨实例同步（播放记录、跳过片头）、成熟生态。

示例 docker-compose（含 redis）：

version: "3.8"

services:
  katelyatv:
    image: ghcr.io/katelya77/katelyatv:latest
    container_name: katelyatv
    restart: unless-stopped
    ports:
      # 本地访问端口：建议修改前面的 3000 为自己喜欢的端口，避免和其他服务冲突
      # 例如改成 "8080:3000" 就是用 http://IP:8080 访问
      - "3000:3000"
    environment:
      # 管理员账号（必填，登录用）
      - USERNAME=admin
      # 管理员密码（必填，建议使用复杂密码）
      - PASSWORD=your_secure_password

      # 存储配置：这里指定使用 Redis
      - NEXT_PUBLIC_STORAGE_TYPE=redis
      # Redis 地址，默认使用同一 compose 内的服务名
      - REDIS_URL=redis://katelyatv-redis:6379

      # 功能开关：是否允许新用户注册
      - NEXT_PUBLIC_ENABLE_REGISTER=true

    depends_on:
      - katelyatv-redis

  katelyatv-redis:
    image: redis:7-alpine
    container_name: katelyatv-redis
    restart: unless-stopped
    volumes:
      # 数据持久化，避免容器删除后数据丢失
      - redis_data:/data

volumes:
  redis_data:

小贴士：

开启 Redis AUTH，配置持久化与备份。

在 KatelyaTV 中配置 REDIS_URL，以启用共享缓存和跳片头等功能。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

与 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

其他兼容应用

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

视频源配置：

1.网络下载配置文件：

2.本站下载：

基础版（20+站点）：

config_isadult.json

增强版（94 站点）：

configplus_isadult.json

目录CONTENT

KatelyaTV 部署指南配合TVBox安装

视频源配置：

1.网络下载配置文件：

2.本站下载：

评论区