方案文档 V1.0 · 2026-07-13 定稿
全免费 H5 手机端视频站。数据复用 sex8 采集库（11.9 万条 / 36 分类 / 10 万本地封面），播放走日本清洗网关，无登录、无金币，历史与收藏全部留在用户本机。
01
| 项 | 决定 |
|---|---|
| 站名 | 快播视频（页面标题 / Logo，渐变字） |
| 域名 | 主站 3kkp.cc + 泛解析 *.3kkp.cc（任意子域出站，换子域推广防封）；图片 img.3kkp.cc；后台 a.3kkp.cc |
| 技术栈 | Next.js 15 (App Router) + TypeScript + Tailwind；后台同项目 /admin 路由组，shadcn/ui + Recharts |
| 主题 | 浅色默认，右上角一键切深色，localStorage 记忆，首帧内联脚本防闪 |
| 数据 | videos.sex8_videos 只读 + view_count 计数；自建 kbp 库存后台数据 |
| 播放 | m3u8 经 qx.9css.cc 清洗网关（剥广告贴片），HMAC-SHA256 服务端签名；前端 hls.js，iOS Safari 原生 HLS |
| 变现 | 预留 3 个广告位（顶部轮播 / 信息流 / 暂停浮层），后台可配，空则整段不渲染 |
| 用户功能 | 播放历史、收藏夹 —— 纯 localStorage，全站无登录 |
| 进程 | PM2 127.0.0.1:3200，生产 / 开发双 ecosystem 配置，同端口切换 |
02
浏览器 ─► OpenResty ─┬─ 3kkp.cc / *.3kkp.cc ──► Next.js (PM2 :3200) │ ├─ mysql2 池 ─► videos.sex8_videos （只读） │ ├─ mysql2 池 ─► kbp （后台库） │ └─ ioredis ─► 列表缓存 / 实时计数 ├─ img.3kkp.cc ──► nginx 静态直出 9css covers 目录 （19G 零拷贝复用，thumb 回退） └─ a.3kkp.cc ──► auth.lua 认证 ──► 同一 Next.js 的 /admin 播放链路: hls.js ─► qx.9css.cc （日本节点，验 HMAC 签名） ─► 源站 CDN
a. / img.）优先于通配 *.3kkp.cc，互不冲突。/admin 一律 404。03
SELECT（status=1）+ UPDATE view_count+1，其余零写入。kbp.hidden_videos，查询时排除，与 9css 互不影响。idx_status_rand 索引 + 会话种子，翻页不重复。settings(k PK, v) -- 站名 / slogan / 导流链接 / 每页条数
admins(id, username, pass_hash, last_login_at)
sessions(token PK, admin_id, expires_at)
hidden_videos(video_id PK, reason, created_at)
cat_config(cat_id PK, display_name, sort_order, is_hidden)
ads(id, slot ENUM('banner','feed','pause'), img, url, enabled, sort_order)
stats_daily(date PK, pv, uv, plays, searches)
统计：Redis 实时计数（PV 计数器 / UV HyperLogLog / 播放搜索计数 / 热搜 zset），每日定时落 stats_daily。
04
| 路由 | 说明 |
|---|---|
/ | 首页：顶部轮播广告位 + 分类横滑 chips + 两列瀑布流无限滚动 |
/cat/[id] | 分类页：最新 / 最热 / 随机 三种排序 |
/v/[id] | 播放页：hls.js 播放器顶部吸附 + 收藏 / 分享 + 同类推荐无限流 |
/search | 搜索页：热搜词 + 本地搜索历史 + LIKE 搜索（nginx 限流） |
/me | 我的：播放历史 / 收藏夹（localStorage）+ 深色模式开关 |
API：GET /api/list?cat=&sort=new|hot|rand&page=&seed=、GET /api/detail?id=（顺带计数 + 签名播放地址）、GET /api/search、GET /api/cats、/api/admin/*（session 守卫）。
播放地址签名在服务端完成，秘钥不出服务器：qx.9css.cc/m3u8?u=base64url(m3u8)&s=substr(hmac_sha256(m3u8, SECRET), 0, 24)
05
浅色为默认主题，深色为切换项。主色玫红，强调渐变只用于 Logo、HD 角标、进度条等小面积高光。
tabular-nums。img.3kkp.cc，nginx expires 30d。06
封面为色块占位，实际为 img.3kkp.cc 直出的采集封面。左右滑动查看 →
07
| slot | 位置 | 规格与行为 |
|---|---|---|
| banner | 首页顶部轮播 | 750×200，多图轮播，点击外跳 |
| feed | 列表信息流 | 每 12 张卡片插 1 条，与视频卡同宽，右上「广告」角标 |
| pause | 播放页暂停浮层 | 暂停时居中展示，可关闭，恢复播放自动消失 |
配置存 kbp.ads，后台可视化编辑，Redis 缓存 60 秒。未启用的 slot 整段不渲染——上线初期页面完全无广告痕迹，要接量时后台开关即生效。
08
同项目 /admin 路由组，shadcn/ui + Recharts，桌面优先。两道锁：nginx 层 auth.lua（复用 common 现有脚本）+ 应用层密码登录（httpOnly cookie session，存 kbp.sessions）。
| ID | 封面 | 标题 | 分类 | 播放 | 状态 | 操作 |
|---|---|---|---|---|---|---|
| 8247331 | GVH-078 完整版 | 人妻系列 | 31,204 | 展示中 | 隐藏 | |
| 8247330 | HND-853 中文字幕 | 人妻系列 | 16,873 | 展示中 | 隐藏 | |
| 8247118 | 七月主播合集 第 3 场 | 国产主播 | 9,482 | 已隐藏 | 恢复 | |
| 8246902 | MIDV-233 高清中字 | 日韩精品 | 21,058 | 展示中 | 隐藏 | |
| 8246544 | 酒店实拍 高清完整版 | 自拍偷拍 | 14,391 | 展示中 | 隐藏 |
09
# sites/01.3kkp.cc.conf server { 3kkp.cc *.3kkp.cc → $is_bad_bot 过滤 + /api 限流 → proxy 127.0.0.1:3200 } server { img.3kkp.cc → root /home/www/9css.cc/upload（covers 正则 thumb 回退，expires 30d）} server { a.3kkp.cc → access_by_lua auth_lue.lua → proxy 127.0.0.1:3200 }
kbp3（生产 next start）/ kbp3-dev（next dev），同端口 3200，切换先 delete。.env（不进 git）：DB / Redis / QX_RELAY_BASE / QX_SIGN_SECRET / SESSION_SECRET。10
videos 库的接触面 = SELECT + view_count 累加，其余零写入。