v-fixed32:站点更名米视TV + README重写(功能/安装/体验地址tv.88531.cn/更新日志)+ RELEASING发布清单

This commit is contained in:
jinghui committed 2026-10-29 15:49:42 +08:00
1 parent e5e63a664c
commit 5ce5e2ff7d
5 files changed
+150 -67

No files matched your search

+7
View File
@@ -2,6 +2,13 @@
格式参考本机发版惯例:按日期分条,`🐛修复` / `✨新功能`。
## 2026-10-26 → v-fixed32
- ✨ **站点更名为「米视TV」**:19 个文件 76 处用户可见品牌全量替换(SiteName 配置默认值、首页大 Logo/底部 Logo、"Powered by 米视TV Core"、安全警告标题、TVBOX 内置解析/直播名称、manifest name/short_name),GitHub 上游仓库链接保留不动
- 🔧 新增 `SITE_NAME` 环境变量支持(compose + .env + .env.example),站名可自定义;Redis `admin:config` 中的 SiteName 已同步改为米视TV
- 📖 **README 重写**:面向用户的项目介绍(功能亮点、3 分钟安装步骤、TVBOX 接入教程、体验地址 https://tv.88531.cn 、最近更新日志)
- 📖 新增 `RELEASING.md` 发布清单:每次发布必写 CHANGELOG + README 更新日志,体验地址常驻 README
## 2026-10-26 → v-fixed31
- ✨ **加载提示文字**:「加载中…」由灰色 14px 改为**白色 19px 加粗**并加阴影,播放器内更醒目(实测 rgb(255,255,255)/19px/600)
+93 -64
View File
@@ -1,20 +1,94 @@
# KatelyaTV 部署与补丁
# 米视TV
自部署 [KatelyaTV](https://github.com/Katelya77/KatelyaTV) 影视站,**Redis 存储模式**,并包含一组对上游编译产物的**功能性补丁**(TVBOX 聚合接口、筛选提速、顶级分类收敛等)。
> 开源自部署 · 影视聚合搜索 + 港澳台电视直播 · 一个站搞定追剧和看电视
- 站点:`http://192.168.68.19:3030`
- TVBOX/影视仓配置地址(JSON):`http://192.168.68.19:3030/api/tvbox`
- 文本格式(base64,兼容老客户端):`http://192.168.68.19:3030/api/tvbox?format=txt`
**🎯 在线体验:https://tv.88531.cn**
## 目录结构
基于 [KatelyaTV](https://github.com/Katelya77/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 分钟)
```bash
git clone http://192.168.68.19:3200/jinghui/katelyatv.git && cd katelyatv
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 登录即可。
> **重要**:首次启动后必须写入海报代理配置,否则豆瓣海报全部裂图:
```bash
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-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](CHANGELOG.md)。
## 🗂 目录结构
```
docker/katelyatv/
├── docker-compose.redis.yml # compose(Redis 模式,restart=always)
├── .env.example # 环境变量模板(复制为 .env 后填真实值)
├── config.json # 站点基础配置(挂载进容器)
├── fix-admin-users.py # 管理员账号修复脚本
├── patches/ # ★ 对编译产物的补丁(见下)
├── patches/ # ★ 对编译产物的补丁(可幂等重放)
│ ├── apply.sh # 一键重放补丁到运行中容器
│ ├── app-api-tvbox-route.js # TVBOX 接口(聚合/筛选/分类)
│ ├── app-api-filter-route.js# 筛选页接口(提速/分页)
@@ -22,36 +96,17 @@ docker/katelyatv/
│ ├── filter-page-chunk.js # 筛选页前端去重
│ ├── live-inject.js # ★ 直播功能注入块(解码/反代/播放页)
│ └── inject_live.py # 直播注入脚本(幂等可重跑)
├── public-live/ # 直播页静态资产(hls.min.js / mpegts.min.js + 站点原 public,挂载 /app/public)
├── public-live/ # 直播页静态资产(hls.min.js / mpegts.min.js)
├── RELEASING.md # 发布流程(每次推送必做清单)
├── README.md
└── CHANGELOG.md # 更新日志
```
> `.env`、`conf/.env`、镜像 tar 包已列入 `.gitignore`,不会提交。
## 部署
## 🔧 补丁与镜像说明(运维)
```bash
cd docker/katelyatv
cp .env.example .env && vi .env # 填 PASSWORD / NEXTAUTH_SECRET 等
docker compose -f docker-compose.redis.yml up -d
```
首次启动后,**海报代理必须写进 Redis 配置**(否则豆瓣海报 403/418 全部裂图):
```bash
# 站内代理,绕过 doubanio 防盗链
docker exec -i katelyatv-redis redis-cli -x set admin:config <<'JSON'
{"SiteConfig":{"ImageProxy":"http://192.168.68.19:3030/api/image-proxy?url=","DoubanProxy":"http://192.168.68.19:3030/api/image-proxy?url="}}
JSON
docker restart katelyatv
```
(`admin:config` 是整键覆盖,实际生产中应读-改-写保留其余字段。)
## 补丁说明
上游镜像 `ghcr.io/katelya77/katelyatv:latest` 直接使用时存在若干问题,本仓库的 `patches/` 对容器内 Next.js 编译产物打补丁:
上游镜像 `ghcr.io/katelya77/katelyatv:latest` 直接使用时存在若干问题,本仓库 `patches/` 对容器内 Next.js 编译产物打补丁:
| 补丁文件 | 解决的问题 |
|---|---|
@@ -59,43 +114,17 @@ docker restart katelyatv
| `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 直播源) |
### 重放补丁
补丁针对 **fixed13** 编译产物校验(`node --check` + 标记字符串),上游大版本升级后需重新适配:
补丁固化在本地镜像(compose 引用,当前 `katelyatv:fixed32`)。上游大版本升级后重放补丁:
```bash
bash patches/apply.sh
```
### 镜像
补丁固化在本地镜像 `katelyatv:fixed13`(compose 已引用)。上游更新后重新打补丁:
```bash
docker commit katelyatv katelyatv:fixed13
bash patches/apply.sh # 重放补丁
python3 patches/inject_live.py # 重放直播注入(幂等)
docker commit katelyatv katelyatv:fixed33 # 固化新镜像
docker compose -f docker-compose.redis.yml up -d
```
## TVBOX 使用
## 🙏 致谢
1. 影视仓/TVBox 添加配置:`http://192.168.68.19:3030/api/tvbox`
2. 第一个站点 **「全部资源」** = 聚合站:搜索/浏览并行查全部启用源、按片名去重合并,详情自动回源播放
3. 其后 8 个单源站点可单独进入
4. 顶级分类固定 7 个:香港电影 / 香港剧 / 电影 / 电视剧 / 综艺 / 动画片 / 动漫;点进分类后 OK 键弹出筛选:**子分类 / 年份 / 地区 / 排序**
## 电视直播(港澳台)
1. 顶部菜单点 **「直播」**(或浏览器打开 `http://192.168.68.19:3030/live`,需登录站点账号)
2. 51 个港澳台频道:凤凰卫视全系、TVB 翡翠/明珠/无线新闻、ViuTV、有线新闻、NOW 视闻台、东森/中天/TVBS 等
3. 左侧频道网格点选即播,右上角可切线路(线路失败自动跳下一条);FLV 与 HLS 双格式自动适配
4. 页面自研无任何广告;播放数据全部经本站反代转发(`/api/tvbox?live=` 接口族),浏览器不接触任何第三方域名
5. 重放直播补丁:`python3 patches/inject_live.py && docker restart katelyatv`(须在 compose up 之前跑,容器重建会回退到镜像内容——已固化进 fixed14 镜像)
### 接入 TVBOX / 影视仓
- **零改动**:配置地址仍是 `http://192.168.68.19:3030/api/tvbox`,重新加载配置即自动出现「电视直播」直播栏(`lives` 字段已内置)
- 手动接入也可直接把 `http://192.168.68.19:3030/api/tvbox?live=txt` 作为直播源文本(TVBOX 直播格式 `分类,#genre#`)
- 频道行格式:`频道名,/api/tvbox?live=ch&id=频道id&p=线路序号`(302 到本站反代流,TVBOX 端只见本站域名)
详见 [CHANGELOG.md](CHANGELOG.md)。
- 上游项目:[KatelyaTV](https://github.com/Katelya77/KatelyaTV)(MIT License)
+45
View File
@@ -0,0 +1,45 @@
# 发布流程(每次更新必做)
> 目标:任何一次改动都带着完整记录推到 Gitea,README 面向用户、CHANGELOG 面向历史,两者都不落下。
## 1. 改动落地(容器内)
```bash
# 改完容器内文件后,务必 node --check 通过再固化
docker commit katelyatv katelyatv:fixedNN # 镜像名固定用 fixedNN 累加
sed -i 's|katelyatv:fixedNN-1|katelyatv:fixedNN|' docker-compose.redis.yml
docker compose -f docker-compose.redis.yml up -d
```
## 2. 浏览器实测验证
改 UI 必须登录后在真实页面上验证(登录接口见运维记录),不能只看日志。
## 3. 写更新日志(两处,缺一不可)
1. **CHANGELOG.md** 顶部新增一节:`## 日期 → v-fixedNN`,列清改了什么
2. **README.md** 的「📝 更新日志(最近)」列表顶部插入同一条,保持最近 8 条左右,超出的删掉(完整历史在 CHANGELOG.md)
## 4. README 检查项(每次发布前过一遍)
- [ ] 体验地址 `https://tv.88531.cn` 在标题下方显眼位置
- [ ] 增强功能列表与实际功能一致(新加的功能要补进去)
- [ ] 安装步骤可照抄执行(`.env.example` 同步更新)
- [ ] 「当前镜像 fixedNN」的版本号与 compose 一致
## 5. 推送 Gitea
```bash
cd /vol1/1000/HD1/docker/katelyatv
git add -A
git -c user.name="jinghui" commit -m "v-fixedNN:<一句话说明>"
git remote set-url origin "http://jinghui:$(cat /root/.gitea_api_token)@192.168.68.19:3200/jinghui/katelyatv.git"
git push -q origin main
git remote set-url origin "http://192.168.68.19:3200/jinghui/katelyatv.git" # 还原,勿把 token 留在 remote
```
## 硬规则
- `.env`、镜像 tar、token 永不入库(`.gitignore` 已覆盖)
- GitHub 上游链接(`github.com/katelya77/KatelyaTV` 等)不改名,改了会失效
- 容器一律 `restart: always`,compose 改动后核验
+3 -1
View File
@@ -3,7 +3,7 @@ version: '3.8'
services:
# KatelyaTV 应用服务
katelyatv:
image: katelyatv:fixed31
image: katelyatv:fixed32
container_name: katelyatv
ports:
- "3030:3000"
@@ -16,6 +16,8 @@ services:
# 站点访问密码配置
PASSWORD: ${PASSWORD:-}
# 站点名称
SITE_NAME: ${SITE_NAME:-米视TV}
AUTH_PASSWORD: ${AUTH_PASSWORD:-}
USERNAME: ${USERNAME:-admin}
NEXT_PUBLIC_ENABLE_REGISTER: ${NEXT_PUBLIC_ENABLE_REGISTER:-true}
+2 -2
View File
@@ -1,6 +1,6 @@
{
"name": "KatelyaTV",
"short_name": "KatelyaTV",
"name": "米视TV",
"short_name": "米视TV",
"description": "影视聚合",
"start_url": "/",
"scope": "/",