d38b6264fec57a1eaabdbe04fcc66d88c0a4aee7
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 使用
- 影视仓/TVBox 添加配置:
http://192.168.68.19:3030/api/tvbox - 第一个站点 「全部资源」 = 聚合站:搜索/浏览并行查全部启用源、按片名去重合并,详情自动回源播放
- 其后 8 个单源站点可单独进入
- 顶级分类固定 7 个:香港电影 / 香港剧 / 电影 / 电视剧 / 综艺 / 动画片 / 动漫;点进分类后 OK 键弹出筛选:子分类 / 年份 / 地区 / 排序
电视直播(港澳台)
- 顶部菜单点 「直播」(或浏览器打开
http://192.168.68.19:3030/live,需登录站点账号) - 51 个港澳台频道:凤凰卫视全系、TVB 翡翠/明珠/无线新闻、ViuTV、有线新闻、NOW 视闻台、东森/中天/TVBS 等
- 左侧频道网格点选即播,右上角可切线路(线路失败自动跳下一条);FLV 与 HLS 双格式自动适配
- 页面自研无任何广告;播放数据全部经本站反代转发(
/api/tvbox?live=接口族),浏览器不接触任何第三方域名 - 重放直播补丁:
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。
Description
开源自部署影视聚合站:全网聚合搜片 + 51个港澳台频道直播 + TVBOX/影视仓一键接入。无广告、免费、数据自掌控。🎯 体验:https://tv.88531.cn
43 MiB
0 Stars
1 Watchers
0 Forks
Releases
39
v-fixed135 — 翻页箭头始终可见
Latest
Languages
TypeScript
84.2%
JavaScript
11.4%
CSS
4%
Dockerfile
0.4%