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
│   └── filter-page-chunk.js   #   筛选页前端去重
├── 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 键弹出筛选:子分类 / 年份 / 地区 / 排序

详见 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%