KatelyaTV 部署与补丁

自部署 KatelyaTV 影视站,Redis 存储模式,并包含一组对上游编译产物的功能性补丁(TVBOX 聚合接口、筛选提速、顶级分类收敛等)。

  • 站点:http://192.168.68.19:3030
  • TVBOX/影视仓配置地址(JSON):http://192.168.68.19:3030/api/tvbox
  • 文本格式(base64,兼容老客户端):http://192.168.68.19:3030/api/tvbox?format=txt

目录结构

docker/katelyatv/
├── docker-compose.redis.yml   # compose(Redis 模式,restart=always)
├── .env.example               # 环境变量模板(复制为 .env 后填真实值)
├── config.json                # 站点基础配置(挂载进容器)
├── fix-admin-users.py         # 管理员账号修复脚本
├── patches/                   # ★ 对编译产物的补丁(见下)
│   ├── apply.sh               #   一键重放补丁到运行中容器
│   ├── app-api-tvbox-route.js #   TVBOX 接口(聚合/筛选/分类)
│   ├── app-api-filter-route.js#   筛选页接口(提速/分页)
│   ├── routes-manifest.json   #   路径式 TVBOX API rewrite + /live rewrite
│   ├── filter-page-chunk.js   #   筛选页前端去重
│   ├── live-inject.js         #   ★ 直播功能注入块(解码/反代/播放页)
│   └── inject_live.py         #   直播注入脚本(幂等可重跑)
├── public-live/               # 直播页静态资产(hls.min.js / mpegts.min.js + 站点原 public,挂载 /app/public)
├── README.md
└── CHANGELOG.md               # 更新日志

.env、conf/.env、镜像 tar 包已列入 .gitignore,不会提交。

部署

cd docker/katelyatv
cp .env.example .env && vi .env        # 填 PASSWORD / NEXTAUTH_SECRET 等
docker compose -f docker-compose.redis.yml up -d

首次启动后,海报代理必须写进 Redis 配置(否则豆瓣海报 403/418 全部裂图):

# 站内代理,绕过 doubanio 防盗链
docker exec -i katelyatv-redis redis-cli -x set admin:config <<'JSON'
{"SiteConfig":{"ImageProxy":"http://192.168.68.19:3030/api/image-proxy?url=","DoubanProxy":"http://192.168.68.19:3030/api/image-proxy?url="}}
JSON
docker restart katelyatv

(admin:config 是整键覆盖,实际生产中应读-改-写保留其余字段。)

补丁说明

上游镜像 ghcr.io/katelya77/katelyatv:latest 直接使用时存在若干问题,本仓库的 patches/ 对容器内 Next.js 编译产物打补丁:

补丁文件 解决的问题
app-api-tvbox-route.js TVBOX 核心:顶级分类收敛为 7 类、根分类聚合、全源聚合站点、年份/地区/排序/子分类筛选
app-api-filter-route.js 筛选页 176s → ~1s(禁用失效源)、结果数翻倍、真实分页
routes-manifest.json 路径式 TVBOX 站点 API:/api/tvbox/<site>?ac=videolist
filter-page-chunk.js 筛选页加载更多去重

重放补丁

补丁针对 fixed13 编译产物校验(node --check + 标记字符串),上游大版本升级后需重新适配:

bash patches/apply.sh

镜像

补丁固化在本地镜像 katelyatv:fixed13(compose 已引用)。上游更新后重新打补丁:

docker commit katelyatv katelyatv:fixed13
docker compose -f docker-compose.redis.yml up -d

TVBOX 使用

  1. 影视仓/TVBox 添加配置:http://192.168.68.19:3030/api/tvbox
  2. 第一个站点 「全部资源」 = 聚合站:搜索/浏览并行查全部启用源、按片名去重合并,详情自动回源播放
  3. 其后 8 个单源站点可单独进入
  4. 顶级分类固定 7 个:香港电影 / 香港剧 / 电影 / 电视剧 / 综艺 / 动画片 / 动漫;点进分类后 OK 键弹出筛选:子分类 / 年份 / 地区 / 排序

电视直播(港澳台)

  1. 顶部菜单点 「直播」(或浏览器打开 http://192.168.68.19:3030/live,需登录站点账号)
  2. 51 个港澳台频道:凤凰卫视全系、TVB 翡翠/明珠/无线新闻、ViuTV、有线新闻、NOW 视闻台、东森/中天/TVBS 等
  3. 左侧频道网格点选即播,右上角可切线路(线路失败自动跳下一条);FLV 与 HLS 双格式自动适配
  4. 页面自研无任何广告;播放数据全部经本站反代转发(/api/tvbox?live= 接口族),浏览器不接触任何第三方域名
  5. 重放直播补丁:python3 patches/inject_live.py && docker restart katelyatv(须在 compose up 之前跑,容器重建会回退到镜像内容——已固化进 fixed14 镜像)

接入 TVBOX / 影视仓

  • 零改动:配置地址仍是 http://192.168.68.19:3030/api/tvbox,重新加载配置即自动出现「电视直播」直播栏(lives 字段已内置)
  • 手动接入也可直接把 http://192.168.68.19:3030/api/tvbox?live=txt 作为直播源文本(TVBOX 直播格式 分类,#genre#)
  • 频道行格式:频道名,/api/tvbox?live=ch&id=频道id&p=线路序号(302 到本站反代流,TVBOX 端只见本站域名)

详见 CHANGELOG.md。

S
Description
开源自部署影视聚合站:全网聚合搜片 + 51个港澳台频道直播 + TVBOX/影视仓一键接入。无广告、免费、数据自掌控。🎯 体验:https://tv.88531.cn
Readme MIT
43 MiB
0 Stars 1 Watchers 0 Forks
2026-11-16 23:48:57 +08:00
Languages
TypeScript 84.2%
JavaScript 11.4%
CSS 4%
Dockerfile 0.4%