Files
ip/README.md
T
2026-09-10 02:34:31 -04:00

137 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# IPTV 直播源自动更新库
> **程序特点**: 境外服务器每日自动抓取 → 逐级甄选 → 国内真实测速 → 原子发布。全流程零常驻 Web 服务依赖,天然适配 2GB 小内存机器。
## 使用地址(直接填入播放器)
| 用途 | 地址 |
|---|---|
| 通用 M3U(TiviMate / Kodi / VLC / IPTV播放器) | <code>https://gitea.zzjp.help/zjp/ip/raw/branch/main/all.m3u</code> |
| TVBox 壳/影视类应用 | <code>https://gitea.zzjp.help/zjp/ip/raw/branch/main/tvbox.json</code> |
| EPG 节目单(XMLTV) | <code>https://gitea.zzjp.help/zjp/ip/raw/branch/main/epg.xml</code> |
| 台标目录 | <code>https://gitea.zzjp.help/zjp/ip/raw/branch/main/logo/</code> |
| 运行状态页 | <code>https://zz.zzjp.help/iptv-status/</code> |
单一 M3U 内按“央视频道 / 卫视频道 / 港澳台频道 / 江苏地方频道 / 网络直播”分组;地方频道仅保留江苏省内行政区市县电视台。
## 实现结果(最近一次运行)
- 央视频道: 18 台 / 33 线 · 卫视频道: 21 台 / 28 线
- 港澳台: 4 台 / 4 线 · 江苏地方: 5 台 / 6 线 · 网络直播: 1 台 / 1 线
- 全库有效线路: 72 线;严格稳定: 137 台 / 153 线
(近 5 次国内测速≥2 次、P30≥2500kbps、最低≥1500kbps;仅用于排序与淘汰,单入口发布不拆分)
## 运作逻辑(每 24h 一轮)
1. **关键词引擎**:AI(智谱/硅基) 依据历史命中扩写关键词,写入 `keywords` 表。
2. **多渠道抓取**:主流社区仓库(TXT/M3U)、tvbox 接口(递归展开)、Gitee/GitHub 代码搜索、Telegram 公开频道/大群白名单增量(仅读已登记实体,防 FloodWait)。
3. **解析入库**:m3u/txt/tvbox json 统一解析,按频道字典+AI 兜底归一化后写入 SQLite;外省地方台丢弃;点播/静态文件(.mp4 等)拒收。
4. **淘汰机制**:数据源 10 天无产出降权再淘汰;播放源“死亡”改由**国内测速**驱动(境外连不上/HTTP 失败不再累计失败次数,防误杀国内源);连续失败≥3 次并冷却 3 天进复活池;10 天无存活删除;假源隔离删除。
5. **校验甄选**:HTTP 存活 + ffprobe 深度(编码/分辨率/码率)。深检与 AI 抽帧甄别优先作用于“国内测速已 playable”的源;CCTV/卫视/港澳台每日限量抽帧辨台标/录像/错台。
6. **国内真实测速**:码云 Gitee Go 多账号(zhoupeng8324/cs、fazhiyuan/css、zhou-jiepeng/csss)并行分片执行;单在途批次状态机、v2 协议(批次摘要+URL 哈希)防旧结果/错批污染;结果以“国内可播”为准恢复 active 与严格状态。
7. **稳定排序**:速度采用稳定度(变异系数)优先 → 国内测速通过 → active 的分层排序;严格稳定基于历史窗口(P30+最低值+样本数),连续低质才降级。
8. **生成产物**:`out.next` 快照原子切换;单入口 all.m3u + tvbox.json + epg.xml + 台标;CCTV 自然序;防盗链 UA/Referer 按来源透传。
9. **同步发布**:推送到本仓库(Gitea zjp/ip);Telegram 推送更新明细与推荐地址。
10. **更新日志**:每次自动运行与每次代码优化都会在下方“更新记录”追加一条,形成可回溯的软件更新说明。
## 播放与回放
- 通用 M3U 兼容 TiviMate、Kodi、VLC 与常见 IPTV 播放器;TVBox 使用独立 JSON。两者均按频道分组,央视以 1、2、3…10、11 自然顺序排列。
- 节目单由 EPG XMLTV 提供,**不等同于回放**。仅当源数据明确带有 <code>catchup="append"</code> 与 <code>catchup-source</code> 时,导出条目才会保留时移参数;支持该规范的播放器可按自身设置尝试回放。
- 本项目不会猜测、伪造或绕过运营商时移/订阅/地区限制;没有显式回放参数的频道只提供直播与节目单。
## 更新记录(自动, 最新在上)
- **2026-09-10 02:34:30 · 自动运行更新 #20260910021330**
自动运行 #20260910021330(2026-09-10 02:34:30):
央视 18台/33线 · 卫视 21台/28线 · 港澳台 4台/4线 · 江苏地方 5台/6线 · 网络直播 1台/1线
全库有效 72 线;严格稳定 137台/153线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
- **2026-09-10 02:16 · 运维加固: 新增统一备份覆盖 IPTV 数据**
2026-09-10 新增 /opt/datasync-ops/backup.sh + datasync-backup.timer(每日05:30, 保留7组): 用 SQLite 在线备份 API 备份 iptv.db 及运行态/缓存, 同时覆盖 WebHTV 观影记录、N2/PG 数据库与会话; 仅 root 可读, 不含密钥文件。此前 iptv.db 无任何备份。
- **2026-09-10 01:58 · 国内测速批次有效期修正(恢复回收闭环)**
根因: 批次有效期原为固定 6 小时, 小于日跑间隔(约 24 小时), 导致 Gitee Go 已回传的结果在下一轮回收前就过期被丢弃(speed_tests 自 09-09 07:52 起零新增)。
改动: config.py 新增 PROBE_BATCH_TTL_HOURS(默认 30, 可用环境变量 IPTV_PROBE_BATCH_TTL_HOURS 覆盖), speedtest._batch_time 默认取该值。
验证: 手工下发三账号批次后 4~6 分钟回传, pull_results 回收 88 条可播放并全部标记 consumed; 新批次有效期 30 小时。
- **2026-09-10 01:46:01 · 自动运行更新 #20260910014536**
自动运行 #20260910014536(2026-09-10 01:46:01):
央视 18台/28线 · 卫视 25台/32线 · 港澳台 3台/3线 · 江苏地方 6台/7线 · 网络直播 0台/0线
全库有效 70 线;严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
- **2026-09-09 17:23:59 · 自动运行更新 #20260909163841**
自动运行 #20260909163841(2026-09-09 17:23:59):
央视 18台/28线 · 卫视 25台/32线 · 港澳台 3台/3线 · 江苏地方 6台/7线 · 网络直播 0台/0线
全库有效 70 线;严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
- **2026-09-09 15:04 · 实时进度百分比升级**
各阶段进度现在按实际文件、线路或频道数量计算;线路验证按本轮待处理线路实时回写,采集按已发现/已处理条目回写,EPG按频道数回写,生成按三个子步骤回写;无法精确计数的阶段使用历史耗时估算。修复阶段完成时覆盖真实计数的问题,并完成运行态、编译和线上 API 验证。
- **2026-09-09 14:38:52 · 自动运行更新 #20260909133700**
自动运行 #20260909133700(2026-09-09 14:38:52):
央视 18台/28线 · 卫视 25台/32线 · 港澳台 3台/3线 · 江苏地方 6台/7线 · 网络直播 0台/0线
全库有效 70 线;严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
- **2026-09-09 14:25 · 控制台中文界面与实时阶段进度修复**
修复 IPTV 控制台中文显示、红绿运行灯、九阶段实时进度卡片、TV Logo、红黑科技风格和按钮反馈;修复 /iptv-ops/ 反代 API 路径、旧模板重复脚本和手动来源失败时误清空表单问题。已通过线上状态接口、主页/详情页、favicon、阶段数量和非法来源中文错误响应验证。
- **2026-09-09 13:23 · 来源新鲜度、Git/TVBox 扩展与实时控制台升级**
来源增加上游更新时间、首次发现、最近成功、抓取历史和多来源关联,稳定但内容不变的来源不再误退役;GitHub/Gitee 改为目录树递归发现最新 m3u/m3u8/txt/json/php;TVBox lives 支持深度3和预算保护递归;新增私有实时运行态和控制台主页进度/红绿灯/详情页/人工数据源入口。已通过全包编译、数据库迁移、控制台 HTTP/API、非法地址和运行态读写自检。
- **2026-09-09 13:04:26 · 自动运行更新 #20260909130426**
自动运行 #20260909130426(2026-09-09 13:04:26):
央视 18台/28线 · 卫视 25台/32线 · 港澳台 3台/3线 · 江苏地方 6台/7线 · 网络直播 0台/0线
全库有效 70 线;严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
- **2026-09-09 11:41:36 · 自动运行更新 #20260909114006**
自动运行 #20260909114006(2026-09-09 11:41:36):
央视 18台/28线 · 卫视 25台/32线 · 港澳台 3台/3线 · 江苏地方 6台/7线 · 网络直播 0台/0线
全库有效 70 线;严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
- **2026-09-09 11:40 · 非目标历史线路已隔离**
按新分类口径补扫历史库,额外隔离1035条不属于电视台或认可主流网络直播的线路;累计人工/规则隔离1571条。已重新发布默认产物:all.m3u、TVBox 仅保留国内真实媒体下载测速达标线路。
- **2026-09-09 11:35:56 · 自动运行更新 #20260909113425**
自动运行 #20260909113425(2026-09-09 11:35:56):
央视 18台/28线 · 卫视 29台/37线 · 港澳台 3台/3线 · 江苏地方 29台/37线 · 网络直播 186台/193线
全库有效 298 线;严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
- **2026-09-09 11:33 · 国内实测质量发布与私有控制台**
默认 all.m3u/TVBox 改为仅发布国内真实媒体下载成功、active 且下载速率达标的 IPv4 线路;已隔离用户国内播放失败的 tv.cnbeijing.xyz 与非目标咪视界域名。三码云探针升级为 HLS 实际媒体读取(上限2MiB),同域熔断跳过不再计入失败。网络直播仅保留斗鱼/虎牙/B站/抖音/快手并排除回放景区等;江苏地方模糊命中需有电视台/融媒体业务语义。新增私有控制台 https://zz.zzjp.help/iptv-ops/,可查看关键词/日志/探针并受控启动、停止、更新EPG和屏蔽错误URL。
- **2026-09-09 11:28:19 · 自动运行更新 #20260909112645**
自动运行 #20260909112645(2026-09-09 11:28:19):
央视 18台/28线 · 卫视 29台/37线 · 港澳台 3台/3线 · 江苏地方 29台/37线 · 网络直播 186台/193线
全库有效 298 线;严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
- **2026-09-09 11:17:06 · 自动运行更新 #20260909111532**
自动运行 #20260909111532(2026-09-09 11:17:06):
央视 21台/215线 · 卫视 47台/245线 · 港澳台 57台/70线 · 江苏地方 97台/107线 · 网络直播 879台/941线
全库有效 1578 线;严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
- **2026-09-09 11:13:05 · 自动运行更新 #20260909111126**
自动运行 #20260909111126(2026-09-09 11:13:05):
央视 21台/215线 · 卫视 47台/245线 · 港澳台 57台/70线 · 江苏地方 97台/107线 · 网络直播 879台/941线
全库有效 1578 线;严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
- **2026-09-09 11:11:42 · 自动运行更新 #20260909111021**
自动运行 #20260909111021(2026-09-09 11:11:42):
央视 21台/215线 · 卫视 47台/245线 · 港澳台 57台/70线 · 江苏地方 97台/107线 · 网络直播 879台/941线
全库有效 1578 线;严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
- **2026-09-09 11:10:46 · 自动运行更新 #20260909110915**
自动运行 #20260909110915(2026-09-09 11:10:46):
央视 21台/215线 · 卫视 47台/245线 · 港澳台 57台/70线 · 江苏地方 97台/107线 · 网络直播 879台/941线
全库有效 1578 线;严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
- **2026-09-09 11:06:35 · 自动运行更新 #20260909110504**
自动运行 #20260909110504(2026-09-09 11:06:35):
央视 21台/215线 · 卫视 47台/245线 · 港澳台 57台/70线 · 江苏地方 97台/107线 · 网络直播 879台/941线
全库有效 1578 线;严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。
## 说明与免责
- 内容仅收集自公开互联网,仅供个人学习测试,请于 24h 内删除;版权归各电视台/平台所有。
- 播放源具有时效性,若失效通常次轮自动剔除并补充新线路。