米视TV 使用教程

它是什么、适合谁

米视TV 把两件事合到了一个网页里：全网影视聚合搜索，和 51 个港澳台电视频道的在线直播（凤凰全系、TVB 翡翠/明珠/无线新闻、ViuTV、东森/中天/TVBS 等）。不用装 App、没有会员费、没有广告和数据上报，站点跑在你自己的服务器上，片单和观看记录只存在自己家里。它还内置 TVBOX/影视仓聚合接口——电视盒子上填一个配置地址，直播和 8 个资源站全部到位。

它适合想低成本自建"追剧 + 看电视"站点的人：手机、电脑、电视浏览器通吃，电视上可用遥控器操作。

快速开始

Docker 三分钟部署（镜像发布在公共仓库，免登录可拉）：

git clone https://gitea.88531.cn/jinghui/katelyatv.git && cd katelyatv
docker pull gitea.88531.cn/jinghui/katelyatv:latest
docker tag   gitea.88531.cn/jinghui/katelyatv:latest katelyatv:fixed33
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 登录。

首次启动后必做一步（否则豆瓣海报全部裂图）——写入海报代理配置：

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

不方便 clone 时，也可以只下载 docker-compose.redis.yml 与 .env.example，把 compose 里的 image: 改成 gitea.88531.cn/jinghui/katelyatv:latest 直接启动。

界面速览

01-home

首页：搜索框 + 最新港剧专区（10 部按年份倒序排列），顶部导航可切换影视搜索与直播页。

常用操作

全网搜片：首页搜索框输入片名，站点并行查询 8+ 资源站并去重合并，点开结果自动回源播放。
看直播：进入直播页，51 个频道按香港/澳门/台湾分组；点击频道即点即播（服务端预热线路，直接有声播放），播放器右下角有暂停/静音悬浮按钮。
看节目单：直播页频道右侧的 EPG 面板默认隐藏，点击展开即可看全天排播，当前节目高亮。
接入 TVBOX/影视仓：登录后点右上角「📺 TVBOX接入」，把配置地址 http://你的服务器:3030/api/tvbox 粘到盒子的「设置 → 配置地址」并重新加载，即可获得电视直播 +「全部资源」聚合站 + 8 个单源站。只想要直播源的话，把 http://你的服务器:3030/api/tvbox?live=txt 粘到 TVBOX 的「直播」一栏。
筛选找片：TVBOX 里顶级分类已收敛为 7 大类，分类内按 OK 键弹出筛选（子分类/年份/地区/排序）；「全部资源」站点是全源聚合，会并行查所有启用源并按片名去重。
自定义站名：.env 里设 SITE_NAME=你的站名，界面、标题、TVBOX 内置名称同步生效。

常见问题

海报全部裂图：几乎都是漏了首次启动的海报代理配置，按上文 redis-cli 命令写入 admin:config 后重启容器即可。
docker compose up 报镜像不存在：compose 默认引用本地标签 katelyatv:fixed33，拉取公共仓库镜像后需要先 docker tag 对齐这个名字。
登录不上：密码取自 .env 里的 PASSWORD；NEXTAUTH_SECRET 没填随机串时会话异常，补齐后重建容器。
筛选页等很久才出结果：本仓库补丁已把筛选页从 176 秒优化到约 1 秒，如果你的部署仍很慢，确认容器内补丁是最新的（bash patches/apply.sh 重放后重启）。
升级后自研功能消失：直接换了上游新镜像而没重放补丁，按开发文档里的重放流程执行 apply.sh + inject_live.py 再 docker commit 固化。

更新与版本

镜像随每次更新日志同步发布，版本号形如 v-fixed33：

v-fixed33：桌面导航与直播页右上角新增「⭐ 开源地址」入口；镜像发布至 gitea.88531.cn/jinghui/katelyatv 公共仓库（免登录 docker pull）
v-fixed32：站点更名为「米视TV」（界面/标题/TVBOX 内置名称/manifest 全量替换），支持 SITE_NAME 环境变量自定义
v-fixed30：直播页右上角新增「📺 TVBOX接入」入口，配置地址/直播源地址一键复制
v-fixed29：直播页新增频道节目单（EPG）面板，默认隐藏、点击展开，当前节目高亮
v-fixed27：即点即播——服务端预热线路，点击频道直接有声播放，无需再点画面

完整历史见仓库内 CHANGELOG.md。