- 接口 stale-while-revalidate: 过期先秒回旧数据(STALE)后台刷新, 60s内HIT - fetchClass 三端点串行逐试改并发竞速: 冷启动 60s+ -> 22.3s - 失败分类缓存 30s->2min; 宿主 cron 每分钟保活 - Dockerfile NEXT_PUBLIC_SITE_VERSION=fixed133
米视TV (KatelyaTV Fork)
跨平台 · 聚合搜索 · 即开即用 · 自托管影视聚合播放器
基于 Next.js 14 · TypeScript · Tailwind CSS · Docker
🌐 体验地址
| 线路 | 地址 |
|---|---|
| IPv4 | https://tv.88531.cn |
| IPv6 | https://tv6.88531.cn:4443 |
| 线路选择页 | https://tv.88531.cn/ipv6 |
✨ 修改功能详细介绍
1. IPv4/IPv6 双线路选择
页面:/ipv6
用户访问时自动探测本地网络是否支持 IPv6:
- 双端口探测:依次尝试
tv6.88531.cn:4443和tv6.88531.cn:443,任一成功即判定支持 IPv6 - 家宽兼容:移动家宽封 80/443 入站,使用 4443 非标端口绕过
- 缓存 2 分钟:探测结果缓存,避免频繁请求
- 强制使用 IPv6:检测失败时提供「仍要使用 IPv6」按钮,用户可手动强制走 IPv6 线路
- 重新检测:提供「重新检测」按钮清除缓存重新探测
- 跳转保留:选择线路后保留原始路径和查询参数
2. 右上角线路按钮
首页右上角显示四个按钮,自适应布局:
| 按钮 | 显示条件 | 功能 |
|---|---|---|
| 开源地址 | ≥768px | 跳转 GitHub 仓库 |
| TVBOX接口 | ≥768px | 显示 TVBOX 配置地址 |
| IPv4 | 始终 | 切换到 IPv4 线路 |
| IPv6 | 始终 | 切换到 IPv6 线路 |
- 菜单区域可收缩(
min-w-0 + overflow-x-auto),按钮过多时横向滚动 - 版本角标显示当前版本号(≥1024px)
3. 香港电视直播
页面:/live
港澳台电视直播,集成 iptv807.com:
- 频道列表:自动抓取 iptv807.com 频道,按地区分组(香港/澳门/台湾)
- EPG 节目单:集成 epg.51zmt.top 电子节目单,显示当前和即将播放的节目
- 频道映射:EPG_MAP 映射频道名到节目单键名
- 视频播放:支持 HLS (m3u8) 和 MPEG-TS 流
- 免登录:
/live路径在中间件白名单中,无需登录即可访问
4. TVBOX 聚合接口
接口:/api/tvbox
聚合多源影视资源,生成 TVBox 配置:
- 聚合搜索:多源并行搜索,按 vod_time 排序,去重
- 分类聚合:电影/电视剧/综艺/动漫/动画片/AI短剧 六大分类
- TOP7 推荐:每个分类的热门推荐
- AI短剧:搜索关键词 AI短剧,自动筛选
- 筛选条件:分类 (st)、地区 (area)、年份 (year)、排序 (by: time/hits/score)
- 视频详情:支持 ids 批量查询
- 输出格式:JSON / TXT / XML
5. 公告系统
- 动态公告从授权中心 (CardAuth) 拉取
- 支持 Markdown 格式
- 管理员可在后台更新公告内容
- 集成在 SiteProvider 中,全局显示
6. 限流与缓存
- 限流器:保护 API 接口,防止滥用
- 缓存穿透防护:chunk 文件按内容 hash 命名,内容变了文件名跟着变,浏览器当新文件拉取,避免陈旧缓存
- Redis 缓存:支持 Redis/Kvrocks 存储,缓存搜索结果
7. 动漫聚合页
页面:/anime
聚合各资源站全部动漫内容,无需逐站翻找:
| 功能 | 说明 |
|---|---|
| 地区切换 | 全部 / 国产 / 日韩 / 欧美 / 港台 / 海外 |
| 多源并行 | 一次请求并行抓取多个资源站的 ac=videaclass t=动漫 |
| 归一去重 | 豆瓣式分类(国产剧/港台/韩国/日本/欧美/动漫)统一映射到动漫域,按 title+年份 去重 |
| 更新排序 | 按 update_time 降序,最新更新在前 |
| 分页 | pg/next_pg/has_more,触底自动加载 |
顶部菜单与移动端底部导航均有「动漫」入口,路由 /anime。
8. 第三方分类浏览(电影/剧集/综艺)
页面:/douban?type=movie|tv|show 接口:/api/browse
- 分类全量使用第三方分类语义:电影 8 类、剧集 7 类、综艺 4 类,地区 7 档
- 请求参数
kind=tv|movie|show|anime+cat(|分隔多选)+area+pg - 与
/api/anime共用同一套归一化、去重、update_time排序、分页逻辑 - 分类选项集中在
src/lib/vodcat.ts,改分类只需改这一处
🚀 快速安装
Docker 单容器(最简单)
docker run -d \
--name katelyatv \
-p 3000:3000 \
-e PASSWORD=your_password \
--restart unless-stopped \
gitea.88531.cn/jinghui/katelyatv:latest
Docker + Redis(推荐家庭使用)
# 1. 下载配置
curl -O https://gitea.88531.cn/jinghui/katelyatv/raw/branch/main/docker-compose.redis.yml
curl -O https://gitea.88531.cn/jinghui/katelyatv/raw/branch/main/.env.redis.example
# 2. 配置环境变量
cp .env.redis.example .env
# 编辑 .env,设置 USERNAME、PASSWORD 等
# 3. 启动
docker compose -f docker-compose.redis.yml up -d
⚠️ docker run + Redis 模式(生产部署方式,必须带 --env-file)
docker run -d --name katelyatv \
--network katelyatv_katelyatv-network \
-p 3030:3000 \
--restart always \
--env-file .env \
-e NEXT_PUBLIC_STORAGE_TYPE=redis \
--add-host host.docker.internal:host-gateway \
gitea.88531.cn/jinghui/katelyatv:latest
部署铁则:
NEXT_PUBLIC_STORAGE_TYPE=redis决定观看记录/账号/收藏/管理配置读哪套存储。 重建容器时漏带--env-file或漏掉该变量,站点会退回localstorage模式——服务端全部账号与 观看记录瞬间"不可读"(数据未丢但在页面上表现为全部消失),且登录接口会绕过密码校验直接放行。 2026-11-15 生产事故即由此引起。自 fixed131 起该变量已烤进镜像(Dockerfile ENV),docker run仍建议显式带--env-file .env兜底。
方式二:Docker Compose部署
上面「Docker + Redis」用到的 docker-compose.redis.yml 完整内容(与仓库文件一致,含全部 ports / volumes / environment):
version: '3.8'
services:
# KatelyaTV 应用服务
katelyatv:
image: ghcr.io/katelya77/katelyatv:latest
ports:
- "3000:3000"
environment:
# 数据库配置 - 使用 Redis
NEXT_PUBLIC_STORAGE_TYPE: redis
REDIS_URL: redis://katelyatv-redis:6379
REDIS_PASSWORD: ${REDIS_PASSWORD:-}
REDIS_DATABASE: 0
# 站点访问密码配置
PASSWORD: ${PASSWORD:-}
# 其他必要的环境变量
NEXTAUTH_SECRET: ${NEXTAUTH_SECRET}
NEXTAUTH_URL: ${NEXTAUTH_URL:-http://localhost:3000}
depends_on:
- katelyatv-redis
restart: unless-stopped
networks:
- katelyatv-network
# Redis 数据库服务
katelyatv-redis:
image: redis:7-alpine
container_name: katelyatv-redis
command: redis-server --appendonly yes --maxmemory 256mb --maxmemory-policy allkeys-lru
volumes:
# 持久化数据存储
- katelyatv-redis-data:/data
restart: unless-stopped
networks:
- katelyatv-network
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 30s
timeout: 10s
retries: 3
start_period: 10s
volumes:
# Redis 数据卷
katelyatv-redis-data:
driver: local
networks:
katelyatv-network:
driver: bridge
启动 / 停止:
# 1. 下载编排文件与环境变量模板
curl -O https://gitea.88531.cn/jinghui/katelyatv/raw/branch/main/docker-compose.redis.yml
curl -O https://gitea.88531.cn/jinghui/katelyatv/raw/branch/main/.env.redis.example
cp .env.redis.example .env
# 编辑 .env,设置 PASSWORD、NEXTAUTH_SECRET 等
# 2. 启动
docker compose -f docker-compose.redis.yml up -d
# 3. 查看状态 / 停止
docker compose -f docker-compose.redis.yml ps
docker compose -f docker-compose.redis.yml down
不想用 Compose 时,用上面「方式一:Docker 单容器」的
docker run即可(仅省略 Redis,此时把存储类型设为localstorage)。
环境变量
| 变量 | 必填 | 说明 |
|---|---|---|
| PASSWORD | 是 | 访问密码 |
| AUTH_PASSWORD | 否 | 授权密码(TVBox/授权中心) |
| USERNAME | 否 | 管理员用户名(默认 admin) |
| NEXT_PUBLIC_STORAGE_TYPE | 否 | 存储类型(localstorage/redis/kvrocks/upstash/d1) |
| REDIS_URL | 否* | Redis 连接地址 |
| SITE_NAME | 否 | 站点名称(默认 米视TV) |
| SITE_VERSION | 否 | 版本号(默认 fixed43) |
* 使用 redis 存储时必填
📋 更新日志
-
v-fixed133:最新港剧加载提速(对齐热门电影)——
/api/tvbox/all聚合接口改 stale-while-revalidate:过期先秒回旧数据(STALE 实测 0.02s)后台再刷新,60s 内 HIT 0.03s;分类端点由串行逐试改并发竞速,冷启动聚合 60s+ → 22.3s;失败分类缓存 30s→2min + 宿主 cron 每分钟保活;热门电影仍走豆瓣单接口(数据源不变,点击仍直达片源) -
v-fixed132:全新浏览器标签页图标——替换旧「暗黑肖像缩略图」favicon(16px 下糊成黑团),新图标为深蓝渐变圆角底 + 天蓝播放三角 + 右上角星光,与暗色主题/天蓝主色一致;16px 用专用优化版(三角放大加粗),32/48/64 为标准版(4K 超采样抗锯齿);同步更新 PWA 图标
icons/icon-{192,256,384,512}.png -
v-fixed131:相关推荐重做——数据改为本站已有片源,新增
/api/related按 主演/导演/语言/地区/类型 五项元数据匹配打分(豆瓣推荐接口不再用于推荐);卡片点击带source+id直达实际片源开播(播放页直达模式不再按标题搜索,杜绝片源对不上);「相关推荐」标题旁常驻显示匹配规则「按主演 / 导演 / 语言 / 地区 / 类型匹配 · 本站片源直达」,卡片下标注重合依据 -
v-fixed130:详情页「相关推荐」标题旁显示推荐规则说明「豆瓣相似影片推荐 · 取前10」(数据来自豆瓣官方推荐接口,取前 10 条相似影片)
-
v-fixed129:详情页「相关推荐」点击改为直接打开影片详情并播放(
/play?title=,原为跳搜索页/search?q=);播放页标题匹配加兜底(精确匹配不到时放宽到双向包含,避免点进去报「未找到匹配结果」) -
v-fixed128:恢复 TVBox 旧版配置结构(「全部资源」站点 + 逐站代理
/api/tvbox/<key>+ TOP7 分类视图,源码化时丢失);新增/api/tvbox/[site]逐站代理(9xx 分类→该源真实分类 id、逐子分类聚合、AI短剧搜索、筛选兜底);修复裸/api/tvbox的 9xx 分类全部 0 条、wd搜索返回成配置 JSON、配置页 Base64 格式实际返回 JSON;配置响应改 no-store,88531 域名强制 https -
v-fixed96:新增动漫独立页
/anime(多源聚合+地区切换+更新排序+分页)与/api/browse第三方分类浏览接口;电影/剧集/综艺分类全量切第三方分类;修复动漫页首次进入空列表(reset丢数据) -
v-fixed43:IPv6 探测改 4443 端口(家宽封 443 导致误判),双端口探测 + 强制使用 IPv6 按钮;恢复右上角按钮断点;chunk 按内容改名防陈旧缓存;源码迁移开始
-
v-fixed42:IPv6 检测改严格模式(cors + 校验 JSON),缓存 2 分钟,新增重新检测按钮
-
v-fixed41:源码迁移,/ipv6 页面 React 化,中间件白名单
⚠️ 为什么老是替换掉?
之前所有修改都是通过 Python 脚本在 Docker 容器启动时 patch 编译产物(.next/ 目录下的 JS 文件)。每次重新构建镜像或升级版本,编译产物重新生成,patches 的字符串锚点全部失效,导致功能"消失"。
解决方案:将核心功能迁移到 Next.js 源码,重新构建时自动生效,不再依赖 patch。当前已完成 /ipv6 页面和中间件的迁移,其余功能逐步迁移中。
🐳 Docker 镜像
# 公网可拉(匿名)
docker pull gitea.88531.cn/jinghui/katelyatv:latest # 固定版本
docker pull gitea.88531.cn/jinghui/katelyatv:fixed133
# 腾讯云 TCR(东京,公网匿名)
docker pull jpccr.ccs.tencentyun.com/jinghui/katelyatv:latest
当前版本:v-fixed133