Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
3b9f3bbf5d | ||
|
|
5d58eee4c7 | ||
|
|
6bc58e33cd | ||
|
|
e086667927 | ||
|
|
a74a82b5d1 |
No files matched your search
@@ -2,6 +2,41 @@
|
||||
|
||||
本文档记录 KatelyaTV 项目的重要更新和功能变更。
|
||||
|
||||
## [fixed133] - 2026-11-16
|
||||
|
||||
### ⚡ 性能:最新港剧等聚合板块秒开(对齐热门电影的加载体验)
|
||||
- **接口层 stale-while-revalidate**:`/api/tvbox/all` 缓存过期后先立即返回旧数据(`X-Cache: STALE`,实测 0.02s),同时在后台重新聚合——多源聚合实测 8~22s,用户请求从此零等待;60s 内 `X-Cache: HIT`(0.03s)
|
||||
- **分类端点并发竞速**:`fetchClass` 三个候选端点由「串行逐试、每端点等满 8s」改为「并发竞速、首个成功即用」(半死源最坏 3×8s=24s → 8s);容器重启后的冷启动全量聚合从 **60s+ 降到 22.3s**(前端 25s 超时内可通过)
|
||||
- **失败分类表缓存 30s → 2min**:避免每分钟刷新反复踩满超时拖慢整体
|
||||
- **保活**:模块级预热定时器(edge 隔离下不保证存活)+ 宿主 crontab 每分钟保活请求——无用户流量时聚合结果也持续续期,数据最多旧约 2 分钟
|
||||
- **根因说明**:热门电影走豆瓣单接口(1~2s 即回),最新港剧走全片源站聚合(分类表映射 + 列表拉取 + 硬过滤去重),慢在聚合本身与 60s 缓存过期后的同步等待;本版以 SWR + 端点竞速消灭「等待」,数据源保持片源直达不降级(不换豆瓣源,避免点击后退化为标题搜索)
|
||||
- Dockerfile `ENV NEXT_PUBLIC_SITE_VERSION` 同步 fixed133(客户端编译期常量)
|
||||
|
||||
### 🧪 验证(2026-11-16 实测)
|
||||
- tsc / next build 通过;冷启动聚合 22.3s(list=70)、第 2 发 HIT 0.031s、过期后 STALE 0.024s(list=65)
|
||||
- 站点 307→login 200、Redis 67 键完好、容器 `SITE_VERSION=fixed133`
|
||||
|
||||
## [fixed132] - 2026-11-16
|
||||
|
||||
### ✨ 全新浏览器标签页图标(favicon)
|
||||
- **重新设计网站图标**:替换原来「暗黑肖像插画缩略图」的旧 favicon(16px 下糊成一团黑、不可辨识)。
|
||||
新图标为 **深蓝渐变圆角底 + 天蓝播放三角 + 右上角星光点缀**,与站点暗色主题/天蓝主色一致,
|
||||
影视播放属性一眼可辨。
|
||||
- **小尺寸专门优化**:favicon.ico 内含 4 个尺寸——**16px 用专用优化版**(三角放大至 72%、去星光、
|
||||
加粗边线,保证标签页最小尺寸下清晰可辨为播放三角),32/48/64px 用标准版(4K 超采样渲染 + LANCZOS 缩放抗锯齿)。
|
||||
- **同步更新 PWA 图标**:`public/icons/icon-{192,256,384,512}.png` 全部换成新版设计,
|
||||
`manifest.json` 图标路径不变,浏览器安装/书签场景同步生效。
|
||||
- 图标由代码渲染生成(Pillow,脚本存 scratch),无需外部素材;16/32/48/64 四尺寸经视觉逐级核验。
|
||||
|
||||
### 验证
|
||||
- 线上 `/favicon.ico`(32038 字节)与源文件 **sha256 逐字节一致**;浏览器实际加载的 favicon hash 同为 `960d4431c7c88996…`,MATCH。
|
||||
- 首页 307→登录页正常、登录探针 401、`/icons/icon-512x512.png` 200、Redis 65 键数据完好。
|
||||
- 镜像 `katelyatv:fixed132` 双推内网 Gitea + 腾讯 TCR(`fixed132` 与 `latest` tag,双仓 digest 一致 `7648449d…`)。
|
||||
|
||||
### 🔄 保持不变
|
||||
- 站点功能、登录鉴权、观看记录(Redis)、相关推荐(fixed131)、TVBox 配置等全部无改动;
|
||||
仅替换图标资源文件。
|
||||
|
||||
## [fixed131] - 2026-11-14
|
||||
|
||||
### ✨ 重做(相关推荐:本站片源按元数据匹配,点击直达实际片源)
|
||||
@@ -25,6 +60,20 @@
|
||||
### 🔄 保持不变
|
||||
- 登录/注册鉴权、豆瓣评分/短评(仅推荐改成本站数据)、TVBox 配置(fixed128)、首页最新港剧(fixed127)、首访 IPv6 线路门。
|
||||
|
||||
### 🐛 修复(2026-11-15 追加:观看记录"消失"事故)
|
||||
- **根因**:某次 `docker run` 重建容器时漏带 `--env-file .env`,`NEXT_PUBLIC_STORAGE_TYPE=redis`
|
||||
环境变量丢失 → 站点退回 `localstorage` 模式:服务端 Redis 里的 24 个账号、全部观看记录/收藏/
|
||||
管理配置瞬间不可读(用户表现为"观看记录都没了"),且登录接口在该模式下未配置 `AUTH_PASSWORD`
|
||||
直接放行(站内登录形同虚设;外层 Basic Auth 仍在)。**数据本身未丢失**,Redis 中 13 条记录完好。
|
||||
- **修复**:① `Dockerfile` builder/runner 两阶段 `ENV NEXT_PUBLIC_STORAGE_TYPE=redis` 烤进镜像,
|
||||
彻底杜绝再丢;② 容器重建改用 `--env-file /vol3/1000/HD3/docker/katelyatv/.env` 全量环境 +
|
||||
显式 `-e NEXT_PUBLIC_STORAGE_TYPE=redis` 兜底;③ README 新增「方式二 docker run(必须带
|
||||
`--env-file`)」与部署铁则警示;④ compose `image` 对齐 `katelyatv:fixed131`。
|
||||
- **验证**:`RUNTIME_CONFIG.STORAGE_TYPE=redis`;`/api/playrecords`(合法签名 cookie)200 返回
|
||||
13 条记录;登录探针 `__probe__` 401「用户名或密码错误」(修复前为 `ok:true` 直接放行);
|
||||
登录态首页 200、`/login` 200、公网 `tv.88531.cn` 跳转链正常。
|
||||
- **注**:故障窗口内在浏览器新看的片记录留在本地 localStorage,不会自动同步回服务端。
|
||||
|
||||
### 镜像
|
||||
- katelyatv:fixed131(内网 + 腾讯云双推,latest 同步)
|
||||
|
||||
|
||||
@@ -35,8 +35,11 @@ RUN find ./src -type f -name "route.ts" -print0 \
|
||||
ENV DOCKER_ENV=true
|
||||
# 海报走站内 /api/image-proxy(浏览器直连豆瓣图被拦导致全裂)
|
||||
ENV NEXT_PUBLIC_IMAGE_PROXY=/api/image-proxy
|
||||
ENV NEXT_PUBLIC_SITE_VERSION=fixed131
|
||||
ENV NEXT_PUBLIC_SITE_VERSION=fixed133
|
||||
ENV NEXT_PUBLIC_ENABLE_REGISTER=true
|
||||
# 存储模式必须烤进镜像:丢失会导致服务端数据(观看记录/账号/收藏)全部不可读,
|
||||
# 且登录接口走 localstorage 分支无 AUTH_PASSWORD 直接放行(2026-11-15 事故)
|
||||
ENV NEXT_PUBLIC_STORAGE_TYPE=redis
|
||||
|
||||
# For Docker builds, force dynamic rendering to read runtime environment variables.
|
||||
RUN sed -i "/const inter = Inter({ subsets: \['latin'] });/a export const dynamic = 'force-dynamic';" src/app/layout.tsx
|
||||
@@ -56,8 +59,11 @@ ENV HOSTNAME=0.0.0.0
|
||||
ENV PORT=3000
|
||||
ENV DOCKER_ENV=true
|
||||
ENV NEXT_PUBLIC_IMAGE_PROXY=/api/image-proxy
|
||||
ENV NEXT_PUBLIC_SITE_VERSION=fixed131
|
||||
ENV NEXT_PUBLIC_SITE_VERSION=fixed133
|
||||
ENV NEXT_PUBLIC_ENABLE_REGISTER=true
|
||||
# 存储模式必须烤进镜像:丢失会导致服务端数据(观看记录/账号/收藏)全部不可读,
|
||||
# 且登录接口走 localstorage 分支无 AUTH_PASSWORD 直接放行(2026-11-15 事故)
|
||||
ENV NEXT_PUBLIC_STORAGE_TYPE=redis
|
||||
|
||||
# 从构建器中复制 standalone 输出
|
||||
COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
|
||||
|
||||
@@ -133,6 +133,25 @@ cp .env.redis.example .env
|
||||
docker compose -f docker-compose.redis.yml up -d
|
||||
```
|
||||
|
||||
#### ⚠️ `docker run` + Redis 模式(生产部署方式,必须带 `--env-file`)
|
||||
|
||||
```bash
|
||||
docker run -d --name katelyatv \
|
||||
--network katelyatv_katelyatv-network \
|
||||
-p 3030:3000 \
|
||||
--restart always \
|
||||
--env-file .env \
|
||||
-e NEXT_PUBLIC_STORAGE_TYPE=redis \
|
||||
--add-host host.docker.internal:host-gateway \
|
||||
gitea.88531.cn/jinghui/katelyatv:latest
|
||||
```
|
||||
|
||||
> **部署铁则**:`NEXT_PUBLIC_STORAGE_TYPE=redis` 决定观看记录/账号/收藏/管理配置读哪套存储。
|
||||
> 重建容器时漏带 `--env-file` 或漏掉该变量,站点会退回 `localstorage` 模式——服务端全部账号与
|
||||
> 观看记录瞬间"不可读"(数据未丢但在页面上表现为全部消失),且登录接口会绕过密码校验直接放行。
|
||||
> 2026-11-15 生产事故即由此引起。自 fixed131 起该变量已烤进镜像(Dockerfile ENV),
|
||||
> `docker run` 仍建议显式带 `--env-file .env` 兜底。
|
||||
|
||||
### 方式二:Docker Compose部署
|
||||
|
||||
上面「Docker + Redis」用到的 `docker-compose.redis.yml` 完整内容(与仓库文件一致,含全部 ports / volumes / environment):
|
||||
@@ -228,6 +247,8 @@ docker compose -f docker-compose.redis.yml down
|
||||
|
||||
## 📋 更新日志
|
||||
|
||||
- **v-fixed133**:**最新港剧加载提速(对齐热门电影)**——`/api/tvbox/all` 聚合接口改 stale-while-revalidate:过期先秒回旧数据(STALE 实测 0.02s)后台再刷新,60s 内 HIT 0.03s;分类端点由串行逐试改并发竞速,**冷启动聚合 60s+ → 22.3s**;失败分类缓存 30s→2min + 宿主 cron 每分钟保活;热门电影仍走豆瓣单接口(数据源不变,点击仍直达片源)
|
||||
- **v-fixed132**:全新浏览器标签页图标——替换旧「暗黑肖像缩略图」favicon(16px 下糊成黑团),新图标为**深蓝渐变圆角底 + 天蓝播放三角 + 右上角星光**,与暗色主题/天蓝主色一致;16px 用专用优化版(三角放大加粗),32/48/64 为标准版(4K 超采样抗锯齿);同步更新 PWA 图标 `icons/icon-{192,256,384,512}.png`
|
||||
- **v-fixed131**:相关推荐重做——数据改为**本站已有片源**,新增 `/api/related` 按 **主演/导演/语言/地区/类型** 五项元数据匹配打分(豆瓣推荐接口不再用于推荐);卡片点击带 `source+id` **直达实际片源开播**(播放页直达模式不再按标题搜索,杜绝片源对不上);「相关推荐」标题旁常驻显示匹配规则「按主演 / 导演 / 语言 / 地区 / 类型匹配 · 本站片源直达」,卡片下标注重合依据
|
||||
- **v-fixed130**:详情页「相关推荐」标题旁显示推荐规则说明「豆瓣相似影片推荐 · 取前10」(数据来自豆瓣官方推荐接口,取前 10 条相似影片)
|
||||
|
||||
@@ -251,13 +272,13 @@ docker compose -f docker-compose.redis.yml down
|
||||
```bash
|
||||
# 公网可拉(匿名)
|
||||
docker pull gitea.88531.cn/jinghui/katelyatv:latest # 固定版本
|
||||
docker pull gitea.88531.cn/jinghui/katelyatv:fixed96
|
||||
docker pull gitea.88531.cn/jinghui/katelyatv:fixed133
|
||||
|
||||
# 腾讯云 TCR(东京,公网匿名)
|
||||
docker pull jpccr.ccs.tencentyun.com/jinghui/katelyatv:latest
|
||||
```
|
||||
|
||||
当前版本:**v-fixed96**
|
||||
当前版本:**v-fixed133**
|
||||
|
||||
## 🔗 源码
|
||||
|
||||
|
||||
|
Before Width: | Height: | Size: 9.4 KiB After Width: | Height: | Size: 31 KiB |
|
Before Width: | Height: | Size: 41 KiB After Width: | Height: | Size: 22 KiB |
|
Before Width: | Height: | Size: 72 KiB After Width: | Height: | Size: 33 KiB |
|
Before Width: | Height: | Size: 162 KiB After Width: | Height: | Size: 57 KiB |
|
Before Width: | Height: | Size: 296 KiB After Width: | Height: | Size: 86 KiB |
@@ -10,25 +10,81 @@ export const runtime = 'edge';
|
||||
// 聚合/class/9xx 映射逻辑已收拢到 @/lib/tvboxagg(旧补丁 ALL 逻辑的源码化实现),
|
||||
// 本文件只负责:进程内缓存 + 出口。
|
||||
|
||||
// 进程内响应缓存:相同查询 60s 内直接返回,避免每次刷新都重新聚合上游(最新港剧等栏目秒开)
|
||||
// 进程内响应缓存(stale-while-revalidate):
|
||||
// - HIT:有数据 60s 内直接返回(浏览器同样 max-age=60);
|
||||
// - STALE:过期后 10 分钟内先立刻返回旧数据,同时后台重新聚合——
|
||||
// 多源聚合实测 8~18s,用户请求永远零等待(最新港剧与热门电影一样秒开);
|
||||
// - 完全冷(容器刚重启、无任何旧数据)才同步等一次聚合。
|
||||
const respCache = new Map<string, [number, any]>();
|
||||
const refreshing = new Set<string>();
|
||||
const FRESH_MS = 60000; // 有数据的强新鲜窗口
|
||||
const FRESH_EMPTY_MS = 5000; // 空结果只短缓存 5s:上游偶发超时不能把空列表当正常数据缓存
|
||||
const STALE_MS = 10 * 60 * 1000; // stale 窗口:旧数据最多用 10 分钟,期间后台必然已刷新
|
||||
|
||||
async function aggregateNow(cacheKey: string, sp: URLSearchParams): Promise<any | null> {
|
||||
try {
|
||||
const config = await getConfig();
|
||||
const sourceConfigs: SrcCfg[] = (config.SourceConfig || []).filter((s: any) => !s.disabled);
|
||||
const r = await aggregateAll(sourceConfigs, sp);
|
||||
// 只缓存有数据的结果;空结果不驻留(下次请求立即重试)
|
||||
if (r && Array.isArray(r.list) && r.list.length) {
|
||||
respCache.set(cacheKey, [Date.now(), r]);
|
||||
if (respCache.size > 200) respCache.clear();
|
||||
return r;
|
||||
}
|
||||
} catch {
|
||||
// 聚合失败静默:stale 数据继续可用,下次请求/预热会再试
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 后台刷新(同一 key 并发去重,避免多个过期请求同时打上游)
|
||||
function refreshInBackground(cacheKey: string, sp: URLSearchParams) {
|
||||
if (refreshing.has(cacheKey)) return;
|
||||
refreshing.add(cacheKey);
|
||||
aggregateNow(cacheKey, sp).finally(() => refreshing.delete(cacheKey));
|
||||
}
|
||||
|
||||
export async function GET(request: NextRequest) {
|
||||
const { searchParams } = new URL(request.url);
|
||||
const cacheKey = searchParams.toString();
|
||||
const now = Date.now();
|
||||
const c = respCache.get(cacheKey);
|
||||
// 空结果只缓存 5s:上游偶发超时不能把空列表当 60s 正常数据缓存(最新港剧整栏消失的根因之一)
|
||||
const cTTL = c && c[1] && Array.isArray(c[1].list) && c[1].list.length ? 60000 : 5000;
|
||||
if (c && now - c[0] < cTTL) {
|
||||
const hasList = !!(c && c[1] && Array.isArray(c[1].list) && c[1].list.length);
|
||||
const freshTTL = hasList ? FRESH_MS : FRESH_EMPTY_MS;
|
||||
|
||||
if (c && now - c[0] < freshTTL) {
|
||||
return NextResponse.json(c[1], { headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'public, max-age=60', 'X-Cache': 'HIT' } });
|
||||
}
|
||||
const config = await getConfig();
|
||||
const sourceConfigs: SrcCfg[] = (config.SourceConfig || []).filter((s: any) => !s.disabled);
|
||||
const r = await aggregateAll(sourceConfigs, searchParams);
|
||||
// 只缓存有数据的结果;空结果短缓存(上面 5s TTL)且不长期驻留
|
||||
if (r && Array.isArray(r.list) && r.list.length) respCache.set(cacheKey, [now, r]);
|
||||
// 防止缓存无限增长:超过 200 条清空
|
||||
if (respCache.size > 200) respCache.clear();
|
||||
return NextResponse.json(r, { headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'public, max-age=60' } });
|
||||
// stale:先给旧数据、后台刷新——用户零等待
|
||||
if (hasList && now - c[0] < STALE_MS) {
|
||||
refreshInBackground(cacheKey, searchParams);
|
||||
return NextResponse.json(c[1], { headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'public, max-age=60', 'X-Cache': 'STALE' } });
|
||||
}
|
||||
// 完全冷:没人有数据可给,只能同步聚合一等(配合下方启动预热 + 宿主保活 cron,正常用户几乎碰不到)
|
||||
const r = await aggregateNow(cacheKey, searchParams);
|
||||
return NextResponse.json(
|
||||
r || { code: 1, msg: '数据列表', page: 1, pagecount: 1, limit: 0, total: 0, list: [] },
|
||||
{ headers: { 'Access-Control-Allow-Origin': '*', 'Cache-Control': 'public, max-age=60' } },
|
||||
);
|
||||
}
|
||||
|
||||
// ---------- 启动预热 + 周期保活 ----------
|
||||
// 模块被首个请求加载后:3s 后预热首页聚合键(最新港剧),此后每 55s 续一次
|
||||
// (接在 60s fresh 窗口前),用户请求几乎永远命中 HIT/STALE。
|
||||
// edge isolate 若不保留定时器则自然退化为"过期请求触发后台刷新",无副作用。
|
||||
const WARM_KEYS = ['ac=videolist&t=902&pg=1&by=time'];
|
||||
function scheduleWarm() {
|
||||
const g = globalThis as any;
|
||||
if (g.__tvboxAllWarm) return;
|
||||
g.__tvboxAllWarm = true;
|
||||
const run = () => {
|
||||
for (const q of WARM_KEYS) {
|
||||
const ent = respCache.get(q);
|
||||
if (!ent || Date.now() - ent[0] > FRESH_MS - 5000) refreshInBackground(q, new URLSearchParams(q));
|
||||
}
|
||||
};
|
||||
setTimeout(run, 3000);
|
||||
setInterval(run, 55000);
|
||||
}
|
||||
scheduleWarm();
|
||||
@@ -36,28 +36,38 @@ export function ns(x: any, key: string) {
|
||||
return Object.assign({}, x, { vod_id: String(key) + ':' + String(x.vod_id) });
|
||||
}
|
||||
|
||||
// 源站分类表缓存:非空 10 分钟(分类表很稳定),空 30 秒(失败要尽快重试)
|
||||
// 源站分类表缓存:非空 10 分钟(分类表很稳定),空 2 分钟(失败过 2 分钟再试,
|
||||
// 30s 太短会让每分钟的刷新都重新踩满超时拖慢整体聚合)
|
||||
const classCache = new Map<string, [number, any[], boolean]>();
|
||||
export async function fetchClass(api: string): Promise<any[]> {
|
||||
const now = Date.now();
|
||||
const c = classCache.get(api);
|
||||
if (c && (c[2] ? now - c[0] < 30000 : now - c[0] < 600000)) return c[1];
|
||||
for (const ep of [api, api + (api.includes('?') ? '&' : '?') + 'ac=list', api + (api.includes('?') ? '&' : '?') + 'ac=class']) {
|
||||
if (c && (c[2] ? now - c[0] < 120000 : now - c[0] < 600000)) return c[1];
|
||||
// 三个候选端点并发竞速(旧行为是串行逐试:半死源每端点都等满 8s 超时,
|
||||
// 最坏 3×8s=24s 拖死整体聚合——冷启动 60s 的主要来源);首个返回非空分类的端点即胜,
|
||||
// 全部失败/超时(单端点 8s)才缓存空结果 → 冷启动最坏 8s 而非 24s
|
||||
const eps = [api, api + (api.includes('?') ? '&' : '?') + 'ac=list', api + (api.includes('?') ? '&' : '?') + 'ac=class'];
|
||||
const attempt = async (ep: string): Promise<any[]> => {
|
||||
const ctrl = new AbortController();
|
||||
const t = setTimeout(() => ctrl.abort(), 8000);
|
||||
try {
|
||||
const ctrl = new AbortController();
|
||||
const t = setTimeout(() => ctrl.abort(), 8000);
|
||||
const r = await fetch(ep, { headers: { 'User-Agent': UA, Accept: 'application/json' }, signal: ctrl.signal });
|
||||
clearTimeout(t);
|
||||
if (!r.ok) continue;
|
||||
if (!r.ok) throw new Error('http ' + r.status);
|
||||
const j = await r.json();
|
||||
if (Array.isArray(j?.class) && j.class.length) {
|
||||
classCache.set(api, [now, j.class, false]);
|
||||
return j.class;
|
||||
}
|
||||
} catch {}
|
||||
if (Array.isArray(j?.class) && j.class.length) return j.class;
|
||||
throw new Error('no class');
|
||||
} finally {
|
||||
clearTimeout(t);
|
||||
}
|
||||
};
|
||||
try {
|
||||
const classes = await Promise.any(eps.map(attempt));
|
||||
classCache.set(api, [now, classes, false]);
|
||||
return classes;
|
||||
} catch {
|
||||
classCache.set(api, [now, [], true]);
|
||||
return [];
|
||||
}
|
||||
classCache.set(api, [now, [], true]);
|
||||
return [];
|
||||
}
|
||||
|
||||
// 顶层 9xx 分类表 + 筛选器(旧补丁 MK):TVBox 端每个站点看到的就是这 7+1 个分类
|
||||
|
||||