v-fixed32:站点更名米视TV + README重写(功能/安装/体验地址tv.88531.cn/更新日志)+ RELEASING发布清单
This commit is contained in:
1 parent
e5e63a664c
commit
5ce5e2ff7d
5 files changed
+150
-67
No files matched your search
@@ -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)
|
||||
|
||||
@@ -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)
|
||||
@@ -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,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}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "KatelyaTV",
|
||||
"short_name": "KatelyaTV",
|
||||
"name": "米视TV",
|
||||
"short_name": "米视TV",
|
||||
"description": "影视聚合",
|
||||
"start_url": "/",
|
||||
"scope": "/",
|
||||
|
||||
Reference in new issue
Block a user