Files

11 KiB
Raw Permalink Blame History

米视TV

开源自部署 · 影视聚合搜索 + 港澳台电视直播 · 一个站搞定追剧和看电视

🎯 在线体验:https://tv.88531.cn

基于 KatelyaTV 深度增强,完全免费开源、无广告、无追踪,数据完全自掌控。


✨ 为什么选择米视TV

  • 一个站 = 影视搜索引擎 + 电视直播 + TVBOX 资源站,不用再装一堆 App
  • 全网聚合搜片:8+ 资源站并行搜索、去重合并,一个搜索框搜全网,结果自动回源播放
  • 51 个港澳台频道直播:凤凰卫视全系、TVB 翡翠/明珠/无线新闻、ViuTV、东森/中天/TVBS 等,点击即播、有声直出
  • TVBOX / 影视仓 一键接入:扫码填一个配置地址,站点 + 直播 + 8 个资源站全部进 TVBOX
  • 手机 / 电脑 / 电视浏览器通用,自适应布局,电视遥控器可操作
  • 完全免费开源自托管:无会员、无广告、无数据上报,片单和观看记录只存在你自己的服务器上
  • IPv6 智能跳转:访问站点时自动探测 IPv6 可达性,家宽有 IPv6 时自动切到 tv6 高速线路,无需手动切换,老用户无感升级

🆕 相比上游的增强功能

直播(自研)

  • 港澳台 51 频道(香港 21 / 澳门 7 / 台湾 23),按地区分组
  • 点击频道即点即播(服务端预热,无需点击画面,有声直出)
  • 频道右侧节目单(EPG):当前节目高亮,随时看全天排播
  • 播放器右下角暂停 / 静音按钮,右上角 TVBOX 接入入口
  • 全程经本站反代转发、无任何广告,播放不接触任何第三方域名

TVBOX 聚合接口

  • 顶级分类收敛为 7 大类(香港电影 / 香港剧 / 电影 / 电视剧 / 综艺 / 动画片 / 动漫)
  • 分类内 OK 键弹出筛选:子分类 / 年份 / 地区 / 排序
  • 首个站点「全部资源」= 全源聚合:并行查所有启用源、按片名去重
  • 直播源内置进 TVBOX 配置(lives 字段),一次导入直播+影视全有

站点体验

  • 首页最新港剧专区(10 部按年份排序,一键进入筛选)
  • 筛选页提速 176 秒 → 1 秒,真实分页、结果去重
  • 豆瓣海报站内代理,不裂图、不泄露访问来源
  • 站名 / 公告 / 图标全自定义(SITE_NAME 环境变量)

运营与防护(v-fixed35)

  • 授权中心(CardAuth):安装人数 / 在线心跳自动上报,右上角常驻当前版本号
  • 公告推送:网页弹窗 + TVBOX 配置 notice 字段同步下发;新版本发布后客户端自动提示「发现新版本」
  • 每 IP 限流:普通接口 240 次/分、直播拉流 30 次/分,超出返回 429,防恶意刷流量
  • 访问统计:./usage-stats.sh 查独立 IP / 按天分布 / TVBOX 客户端 / 直播人数

🚀 安装部署(Docker,3 分钟)

git clone https://gitea.88531.cn/jinghui/katelyatv.git && cd katelyatv

# 拉取镜像(两个公共仓库任选,均免登录)
docker pull gitea.88531.cn/jinghui/katelyatv:latest
# 国内慢可换腾讯云镜像(东京):
# docker pull jpccr.ccs.tencentyun.com/jinghui/katelyatv:latest
docker tag   gitea.88531.cn/jinghui/katelyatv:latest katelyatv:fixed71   # 对齐 compose 的 image 名

cp .env.example .env
vi .env        # 至少填:PASSWORD(站点密码)、NEXTAUTH_SECRET(随机串)
               # 可选:SITE_NAME=你的站名(默认 米视TV)

docker compose -f docker-compose.redis.yml up -d

启动后打开 http://你的服务器IP:3030,用你设的 PASSWORD 登录即可。

不方便 clone 时,直接下载 docker-compose.redis.yml 与 .env.example,把 compose 里 image: 改成 gitea.88531.cn/jinghui/katelyatv:latest(或腾讯 jpccr.ccs.tencentyun.com/jinghui/katelyatv:latest)即可启动。镜像随每次更新日志同步发布到两个渠道。

重要:首次启动后必须写入海报代理配置,否则豆瓣海报全部裂图:

docker exec -i katelyatv-redis redis-cli -x set admin:config <<'JSON'
{"SiteConfig":{"ImageProxy":"http://你的服务器IP:3030/api/image-proxy?url=","DoubanProxy":"http://你的服务器IP:3030/api/image-proxy?url="}}
JSON
docker restart katelyatv

📺 TVBOX / 影视仓 接入

  1. 打开站点(登录后),点右上角 「📺 TVBOX接入」,两条地址一键复制
  2. 配置地址 http://你的服务器:3030/api/tvbox → TVBOX「设置 → 配置地址」粘贴 → 重新加载
  3. 加载后即有:电视直播(51 港澳台频道)+ 全部资源(全源聚合站)+ 8 个单源站
  4. 只想要直播源?把 http://你的服务器:3030/api/tvbox?live=txt 粘到 TVBOX「直播」一栏即可

📝 更新日志(最近)

  • 2026-11-07 v-fixed71:最新港剧只出香港剧(聚合接口按每个源各自的分类表映射香港剧/电视剧类目,不再拿第一个源的 ID 查全源;结果硬过滤地区含香港,之前串进内地剧;排序年份+更新时间双降序,最新排最前)
  • 2026-11-07 v-fixed70:最新港剧改为 10 个显示(此前写死 5 个);加载中显示 10 个骨架占位,与热门电影/剧集同时出现,不再后半拍跳动
  • 2026-11-07 v-fixed69:访问日志源码化(middleware 内 [ACCESS] 日志,替代注入 next 内部 start-server);版本号对齐 fixed69;四件套每一页常驻+11 页验证全过保持
  • 2026-11-07 v-fixed68:右上角四件套(版本角标 + 🔔通知铃铛 + 📺TVBOX接口 + 🌍IPV4/IPv6 + ⭐开源地址)每一页常驻 —— 新建 TopRightButtons 共用组件,11 页验证全过;patch_cachebust.js 过时停用(Next 构建自带 contenthash)
  • 2026-11-06 v-fixed44:管理页「用户配置」点击崩溃(React #31)彻底修复 —— 根因是配置模块把用户对象当用户名写进列表,已修编译产物与源码并清理 18 条脏数据;新增全新「用户管理」面板(用户列表 / 添加 / 改密 / 设为管理 / 封禁 / 删除)
  • 2026-11-01 v-fixed43:IPv6 智能跳转恢复(家宽有 IPv6 自动切到 tv6 高速线路);电脑端与移动端新增「AI短剧」入口;/live 直播页点击画面可暂停/继续;首页公告改为授权中心动态推送
  • 2026-10-30 v-fixed38:首页右上角新增「📺 TVBOX接口」一键复制配置地址;⭐ 开源地址与菜单版本按钮改指自建 Gitea(https://gitea.88531.cn/jinghui/katelyatv)
  • 2026-10-30 v-fixed37:TVBOX 公告兼容 —— 配置同时下发 notice + warning 双字段;版本角标改由环境变量注入
  • 2026-10-30 v-fixed36:首页右上角统一信息区(版本角标 + 🔔通知铃铛 + ⭐开源地址,仅首页显示);直播页只保留 TVBOX 接入入口
  • 2026-10-30 v-fixed35:授权/公告/版本推送系统 —— 授权中心统计安装与在线人数、公告弹窗 + TVBOX notice 推送、新版提示;右上角显示当前版本号 vfixed35;新增每 IP 限流防恶意刷流量(接口 240/分、直播 30/分)
  • 2026-10-29 v-fixed34:新增访问日志与使用统计 —— 外网访问者真实 IP/UA 全记录,./usage-stats.sh [24h|all] 一键查看独立 IP 数、按天分布、直播观看人数
  • 2026-10-29 v-fixed33:桌面导航与直播页右上角新增「⭐ 开源地址」入口;镜像发布至 gitea.88531.cn/jinghui/katelyatv 公共仓库(免登录 docker pull)
  • 2026-10-26 v-fixed32:站点更名为「米视TV」(界面 / 标题 / TVBOX 内置名称 / manifest 全量替换,支持 SITE_NAME 环境变量自定义)

完整历史见 CHANGELOG.md。

🗂 目录结构

docker/katelyatv/
├── docker-compose.redis.yml   # compose(Redis 模式,restart=always)
├── .env.example               # 环境变量模板(复制为 .env 后填真实值)
├── config.json                # 站点基础配置(挂载进容器)
├── 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)
├── RELEASING.md               # 发布流程(每次推送必做清单)
├── README.md
└── CHANGELOG.md               # 更新日志

.env、conf/.env、镜像 tar 包已列入 .gitignore,不会提交。

🔧 补丁与镜像说明(运维)

上游镜像 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 筛选页加载更多去重
live-inject.js + inject_live.py 港澳台直播全套(解码、反代、播放页、EPG、TVBOX 直播源)
patch_access_log.js 访问日志注入([ACCESS] IP/UA/路径,供 usage-stats.sh 统计使用人数)
patch_license.js 授权系统:CardAuth 装机/心跳/公告/版本推送、/api/license-config 路由、首页右上角四件套(版本角标+🔔通知铃铛+📺TVBOX接口一键复制配置地址+⭐开源地址指向自建Gitea,仅首页显示;直播页移除开源按钮)、每 IP 限流 429;运行时组件见 license-hub.js

补丁已全部源码化,运行时注入仅保留注释说明(patches/apply.sh 无活跃 docker cp/exec,执行仅重启容器)。镜像构建:source/ 源码构建 → katelyatv:fixed71(compose 引用)。上游大版本升级后:

pnpm --dir source build && docker build -t katelyatv:fixedXX ./source   # 源码构建(新功能一律先改 source/ 再 build)
docker compose -f docker-compose.redis.yml up -d --force-recreate

🙏 致谢