# 米视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 单容器(最简单) ```bash docker run -d \ --name katelyatv \ -p 3000:3000 \ -e PASSWORD=your_password \ --restart unless-stopped \ gitea.88531.cn/jinghui/katelyatv:latest ``` ### Docker + Redis(推荐家庭使用) ```bash # 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): ```yaml 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 ``` 启动 / 停止: ```bash # 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 镜像 ```bash # 公网可拉(匿名) 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** ## 🔗 源码 - Gitea:https://gitea.88531.cn/jinghui/katelyatv - 上游:https://github.com/katelya77/KatelyaTV