米视TV

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

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

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


✨ 为什么选择米视TV

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

🆕 相比上游的增强功能

直播(自研)

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

TVBOX 聚合接口

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

站点体验

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

🚀 安装部署(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:fixed34   # 对齐 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-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 环境变量自定义)
  • 2026-10-26 v-fixed31:加载提示文字改为白色 19px 加粗 + 阴影,播放器内更醒目
  • 2026-10-26 v-fixed30:直播页右上角新增「📺 TVBOX接入」入口,配置地址 / 直播源地址一键复制
  • 2026-10-26 v-fixed29:直播页新增频道节目单(EPG)面板,默认隐藏、点击展开,当前节目高亮
  • 2026-10-26 v-fixed28:播放器右下角新增暂停 / 静音悬浮按钮
  • 2026-10-26 v-fixed27:即点即播——服务端预热线路,点击频道直接有声播放,无需再点画面
  • 2026-10-26 v-fixed26:移除首页顶部大 Logo 区域
  • 2026-10-26 v-fixed25:首页最新港剧扩到 10 部、按年份倒序,「查看更多」携带筛选条件

完整历史见 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 统计使用人数)

补丁固化在本地镜像(compose 引用,当前 katelyatv:fixed34)。上游大版本升级后重放补丁:

bash patches/apply.sh                          # 重放补丁
python3 patches/inject_live.py                 # 重放直播注入(幂等)
docker commit katelyatv katelyatv:fixed34      # 固化新镜像
docker compose -f docker-compose.redis.yml up -d

🙏 致谢

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%