Files
katelyatv/README.md
T

259 lines
8.8 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 米视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