jinghui c29f5395ac
Docker Build & Test / build (push) Canceled after 0s
Docker Build & Test / test (push) Canceled after 0s
Build & Push Docker image / build-and-push (linux/amd64) (push) Canceled after 0s
Build & Push Docker image / build-and-push (linux/arm/v7) (push) Canceled after 0s
Build & Push Docker image / build-and-push (linux/arm64) (push) Canceled after 0s
Build & Push Docker image / merge-images (push) Canceled after 0s
Release / release (push) Canceled after 0s
Release / docker (push) Canceled after 0s
fix: 更换失效采集源,恢复最新港剧行 (fixed106)
- 5 个旧采集源全部失效(hnzy/liangzizy/yongjiuzy NXDOMAIN,ffzy/1080zyku 连接不通)
- 替换为验证通过的 2 个新源:无尽资源 api.wujinapi.me + 彗星资源 hhzyapi.com
- 实测: /api/tvbox/all?t=902 返回 36 条港剧,m3u8 播放地址 200
- 首页四板块齐全(最新港剧/热门电影/剧集/综艺),海报 40/40 加载
2026-11-10 09:28:15 +08:00
2025-09-01 20:40:37 +08:00
2025-08-27 14:07:03 +08:00
2025-08-29 15:07:00 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00
2025-08-27 14:07:03 +08:00

米视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 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-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:fixed96

# 腾讯云 TCR(东京,公网匿名)
docker pull jpccr.ccs.tencentyun.com/jinghui/katelyatv:latest

当前版本:v-fixed96

🔗 源码

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%