拦截 m3u8 播放列表,删除插播广告片段(7 种删除策略 + 2 种修复)
拦截 m3u8 播放列表,删除插播广告片段(7 种删除策略 + 2 种修复)
采集站 / 影视站的 m3u8 播放列表里常插播广告(5~30 秒短片段,路径与正片不同)。 直接播放会看到广告。
本脚本劫持页面的 XHR / fetch,在播放器拿到数据之前把广告片段删掉, 播放器读到的是干净列表 —— 播放无缝,用户无感。
| 用法 | 生效范围 | 怎么装 |
|---|---|---|
| 主脚本内嵌 | 采集源播放 + 解析接口播放,都生效 | 装 vip-video.user.js 即可,不用额外装 |
| 独立安装 | 所有页面和 iframe 都生效 | 脚本猫 / Greasy Fork / GitHub 直装 |
主脚本的 @match 是 *://*/*,脚本管理器会把它注入到每一个 frame,包括解析接口那种第三方跨域 iframe:
爱奇艺页面(顶层)
└── <iframe src="https://art.txnp.cn/..."> ← 解析接口的播放器在这儿
└── 主脚本也被注入进来了(脚本管理器行为,不受同源策略限制)
└── 检测到自己在 iframe 里 → 注入本过滤器 → 退出
顶层页面里,主脚本负责面板、按钮、菜单这些;iframe 里只做「注入过滤器」这一件事。
⇒ 所以装一个主脚本就够了,解析接口的广告也能过滤。
⇒ 如果某个接口站点有严格 CSP(script-src 白名单)挡住了内联 <script>,那个站点的过滤会失效。这种情况下单独装本脚本可以兜底 —— 脚本管理器的注入走扩展通道,不受 CSP 限制。
不会。脚本开头有两道判断:
// ① 只处理 HTML 文档
if (document.contentType && document.contentType !== 'text/html') return;
// ② 每个 frame 只跑一次
if (window.__M3U8F_LOADED__) return;
window.__M3U8F_LOADED__ = true;
每个页面 / iframe 只会执行一次,先加载的赢,后加载的直接退出。
本脚本对所有页面生效,但视频站自己(爱奇艺、腾讯、优酷…)、网盘、邮箱、代码托管这些地方既没有采集源的 m3u8,也没有必要劫持它们的请求。排除掉可以省掉每个页面一次脚本解析开销,也避免在无关站点上留痕迹。
当前排除范围:主流视频站 13 个、网盘/云盘 9 个、邮箱 3 个、脚本站/GitHub 4 个、内网地址 5 段。
| # | 策略 | 原理 | 触发条件 |
|---|---|---|---|
| ① | 标记型 | 删除 # ppvod-ad-injected 之后紧跟的整段广告 |
有广告标记 |
| ② | 占比型 | 按路径前缀分组,占比 < 34% 的视为广告 | 带 4 道保险 |
| ③ | 不连续段型 | 夹在两处 DISCONTINUITY 之间的整秒短片段 |
默认关闭 |
| ④ | 双路径型 | 只有两条路径时,总时长短的那条视为广告 | 时长比 ≥ 3 倍 |
| ⑤ | 时长众数型 | 与正片时长众数不符的片段 | 众数占比 ≥ 95% |
| ⑥ | URL 长度众数型 | 与正片地址长度众数不符的片段 | 众数占比 ≥ 78.9% |
| ⑦ | 重复广告块 | 块内 4~6 片、总长 ≤ 25s,且同一段内容在整集里重复出现 | 默认开启 |
# ppvod-ad-injected v1 ← 广告标记
#EXT-X-DISCONTINUITY
#EXTINF:4,
/ad/xxx.ts
...
#EXT-X-DISCONTINUITY ← 广告段结束
#EXTINF:4,
/正片/xxx.ts
⇒ 从标记行到下一个「后面跟着 #EXTINF 的 DISCONTINUITY」全部删除。
正片:/20261003/84_9109598f/ → 713 个片段(96.2%)
广告:/ad/20261003/ → 28 个片段( 3.8%)
⇒ 删除占比 < 34% 的路径
四道保险:
⇒ 连续 5 个以上、时长都是整数秒(2~6s)、且夹在两处 DISCONTINUITY 之间。
⇒ 因为有些正片也符合这个特征,所以默认关闭。
路径 A:1200s(正片)
路径 B: 60s(广告)
⇒ 时长比 20 倍 ≥ 3 倍 ⇒ 删除 B
⇒ 只在恰好 2 条路径时生效,3 条以上交给策略 ②。
正片:4.000000s × 950 个
广告:3.000000s × 12 个、1.760000s × 5 个
⇒ 众数占比 98.2% ≥ 95% ⇒ 删除非众数片段
⇒ 首尾片段永不删(防止误删片头片尾)。
正片:/xxx/b8143e816b8000001.ts(长度 26)
广告:/ad/20261003/hd/xxx.m3u8.ts(长度 34)
⇒ 众数占比 92.4% ≥ 78.9% ⇒ 删除非众数长度的片段
⇒ 同一段广告在整集里被插了 2~3 次,每次的 .ts 文件名完全一样。
#EXT-X-DISCONTINUITY
#EXTINF:2.93,
.../hls/tFQBHTJW.ts ┐
#EXTINF:2.93, │ 广告块(6 片 / 17.6 秒)
.../hls/3TKXvMGl.ts │
#EXTINF:2.94, │
.../hls/TV3Ik218.ts ┘
#EXT-X-DISCONTINUITY
...(正片)
#EXT-X-DISCONTINUITY
#EXTINF:2.93,
.../hls/tFQBHTJW.ts ┐ 同一段广告,
#EXTINF:2.93, │ 文件名一模一样
.../hls/3TKXvMGl.ts │
#EXTINF:2.94, │
.../hls/TV3Ik218.ts ┘
#EXT-X-DISCONTINUITY
⇒ 触发条件(四条全满足):
| # | 条件 |
|---|---|
| 1 | 块内片段数 4~6 |
| 2 | 块总时长 ≤ 25 秒 |
| 3 | 总时长不在 [18, 19) 区间(正片单段常落这里) |
| 4 | 该块的 .ts 文件名序列在整集里出现 ≥ 2 次 或 带填充值特征 |
**⇒ 为什么这条管用:**同一段内容重复出现,只可能是广告或片头回顾,不会是正常正片。
**⇒ 补充判据「填充值」:**部分采集站生成假时长时,小数部分会有连续重复数字(如 19.6333 / 19.6667)。这种块即使只出现一次也判定为广告。
⇒ 默认开启,可用 filterM3U8(文本, { useDupAd: false }) 关掉。
| # | 修复 | 作用 |
|---|---|---|
| 修复 1 | 孤儿行修复 | 删除广告后残留的孤立 #EXTINF(没有对应地址行) |
| 修复 2 | 元数据修正 | 重算 #EXT-X-TARGETDURATION、补 #EXT-X-ENDLIST |
⇒ 这两步默认开启,防止删除后播放器卡顿 / 跳片。
⇒ 只能拦截 JS 发起的请求(XHR / fetch)。
✅ 播放器用 hls.js / video.js / Artplayer → 走 XHR/fetch → 能拦
❌ 直接打开 .m3u8 链接 → 浏览器原生 HLS → 走网络层 → 拦不到
⇒ 为什么「直接打开 .m3u8 网址」看不到效果:
| 做法 | 谁在发请求 | 过滤器能看到吗 |
|---|---|---|
| 采集源 / 网页播放器 | 页面里的 JS(fetch / XHR) |
✅ 能 |
| 地址栏输入 m3u8 | 浏览器内核(导航请求) | ❌ 完全看不到 |
⇒ 打个比方:
XHR / fetch = 页面 JS「打电话点外卖」→ 我们是接线员,能改订单
地址栏打开 = 你「自己走进后厨拿菜」→ 接线员管不着
⇒ 而且那个页面里连播放器都没有,只是一堆文本,就算改也没东西播。
⇒ 这不是本脚本的缺陷,是 userscript「XHR/fetch 劫持」这类技术的固有边界 —— 同类的 M3U8 过滤器(包括被参考的 dashu 版本)都一样。
⇒ 所以:
| 场景 | 能过滤吗 |
|---|---|
| 采集源播放(hls.js) | ✅ |
| 解析接口播放(第三方播放器) | ✅(如果它用 XHR/fetch) |
| 直接打开 .m3u8 文件 | ❌ |
| Safari 原生 HLS | ❌ |
⇒ 想验证效果,请把 m3u8 地址丢进任意 hls.js 播放器,而不是直接在地址栏打开。
⇒ 控制台可用 __M3U8F__ 对象:
// 查看统计
__M3U8F__.stats()
// → { intercepted: 12, filtered: 3, removedTotal: 45 }
// 测试过滤(返回 { text, result })
__M3U8F__.filterM3U8(m3u8文本)
// 单独测某个策略
__M3U8F__.removeMarkedBlocks(文本)
__M3U8F__.removeMinorityPaths(文本)
__M3U8F__.removeShorterPath(文本)
__M3U8F__.removeByDurationMode(文本)
__M3U8F__.removeByUrlLengthMode(文本)
__M3U8F__.removeDiscontinuityAds(文本)
__M3U8F__.removeDuplicateAdBlocks(文本) // 策略 ⑦ 重复广告块
__M3U8F__.repairExtinfPairs(文本)
__M3U8F__.fixMetadata(文本)
// 判断某个时长是不是「填充值」(策略 ⑦ 的补充判据)
__M3U8F__.isFillerDuration("19.6333")
// → true(连续 3 型)
__M3U8F__.isFillerDuration("19.600")
// → false(正常时长)
// 解析片段
__M3U8F__.parseSegments(文本)
// → [{ lineIdx, urlLineIdx, dur, url, prefix }, ...]
// 关闭日志
__M3U8F__.debug(false)
// 查看所有命令
__M3U8F__.help()
[M3U8过滤] 已加载 v1.0.3(XHR + fetch 劫持已就绪)
[M3U8过滤] 拦截 https://xxx.com/playlist.m3u8 → 删除 28 个片段
[M3U8过滤] · 占比型: 28
[M3U8过滤] 元数据: TARGETDURATION: #EXT-X-TARGETDURATION:4 → #EXT-X-TARGETDURATION:8
⇒ 用【惰性 getter】而不是 readystatechange 监听:
// ❌ 错误做法:监听 readystatechange
xhr.addEventListener('readystatechange', () => {
// hls.js 用的是 xhr.onreadystatechange,它比 addEventListener 先执行
// ⇒ 我们拿到数据时,hls.js 已经读完了
});
// ✅ 正确做法:覆写 responseText 的 getter
Object.defineProperty(xhr, 'responseText', {
get: function () {
// 第一次读取时才过滤
return filtered || original;
}
});
window.fetch = function (input, init) {
return origFetch.apply(this, arguments).then(resp => {
// 克隆响应 → 读文本 → 过滤 → 构造新 Response
return resp.clone().text().then(text => {
const filtered = handleText(url, text);
return new Response(filtered, { status: resp.status, headers: resp.headers });
});
});
};
本脚本在其基础上:
__M3U8F__)(引用前提:拒绝商业化)
如认为收录或署名方式仍有不妥,欢迎提 Issue 或直接联系,我会立即调整或移除。