根因: getAllUsers() 返回 User 对象数组,config.ts 当作用户名字符串使用,
导致 Users[].username 变成对象,管理页渲染对象触发 Minified React error #31。
- 修编译产物 chunks/{3498,8583}.js 与源码 src/lib/config.ts(两处)
- 清理 Redis admin:config 嵌套脏数据 41 -> 23 条
- 新增原生 JS 用户管理面板 public-live/user-admin.js(列表/添加/改密/设为管理/封禁/删除)
- middleware 放行 /user-admin.js; layout 注入面板加载器
- 新增幂等补丁脚本 patches/fix_userlist_usernames.py
- 镜像 katelyatv:fixed44
9.7 KiB
9.7 KiB
米视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:fixed44 # 对齐 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 / 影视仓 接入
- 打开站点(登录后),点右上角 「📺 TVBOX接入」,两条地址一键复制
- 配置地址
http://你的服务器:3030/api/tvbox→ TVBOX「设置 → 配置地址」粘贴 → 重新加载 - 加载后即有:电视直播(51 港澳台频道)+ 全部资源(全源聚合站)+ 8 个单源站
- 只想要直播源?把
http://你的服务器:3030/api/tvbox?live=txt粘到 TVBOX「直播」一栏即可
📝 更新日志(最近)
- 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 |
补丁固化在本地镜像(compose 引用,当前 katelyatv:fixed44)。上游大版本升级后重放补丁:
bash patches/apply.sh # 重放补丁
python3 patches/inject_live.py # 重放直播注入(幂等)
docker cp license-hub.js katelyatv:/app/license-hub.js
node patches/patch_license.js # 重放授权/角标/限流(幂等)
docker commit katelyatv katelyatv:fixed44 # 固化新镜像
docker compose -f docker-compose.redis.yml up -d
🙏 致谢
- 上游项目:KatelyaTV(MIT License)