NouTube 无广告黑科技:拦截 YouTube 广告请求的完整实现原理

原创2026-10-13 21:13:101,895 阅读

NouTube 无广告黑科技:拦截 YouTube 广告请求的完整实现原理

NouTube 是一款支持 Android、iOS 和桌面的无广告 YouTube / YouTube Music 播放器。它实现"无广告"的核心原理并不是屏蔽广告视频文件,而是在数据层拦截 YouTube 的 /youtubei/v1/* API 请求,把返回 JSON 里的广告条目提前剥离,让广告根本没有机会渲染到界面上。

NouTube 无广告 YouTube 播放器应用图标

一、NouTube 简介:一个"无广告"的 YouTube 客户端

NouTube 的定位非常聚焦:把 YouTube 和 YouTube Music 装进同一个应用,并且做到:

  • 🚫 No ads(无广告):首页推荐、搜索结果、播放前贴片全部拦截
  • ▶️ 背景播放:锁屏、切后台继续播放视频和音乐
  • 📥 下载视频、管理书签/历史(无需登录)
  • 🔔 频道 RSS 订阅、隐藏 Shorts、直播弹幕、自定义 CSS 等

官方 README(README.md)用三句话概括了技术路线:

  1. 用 WebView 包裹 m.youtube.com 和 music.youtube.com
  2. 注入代码拦截广告(Inject code to block ads)
  3. Hook 播放控件,实现后台播放

本文重点拆解第 2 点——广告请求拦截是怎么做的。

二、核心原理:拦截"广告数据",而不是"广告视频"

理解 NouTube 的无广告黑科技,关键在一个认知:

YouTube 页面里的所有内容——推荐列表、搜索结果、视频侧栏、甚至播放前的贴片广告信息——都不是写死在 HTML 里的,而是由 /youtubei/v1/* 系列 JSON 接口动态返回的。

广告在数据里长什么样?源码 lib/intercept.ts 维护了一份"广告渲染器"清单,其中 adSlotRenderer、promotedVideoRenderer、bannerPromoRenderer 等 17 种渲染器,就是 YouTube 下发广告时使用的 JSON 结构。而播放前的贴片广告,则藏在 player 响应里的 playerAds 字段中。

所以 NouTube 的策略是:不去动视频流,只改 JSON。在数据到达页面之前"动一次手术",广告条目就被整条删除,连它占位的空白格子都不会留下(源码注释专门说明了这一点:删除列表项而不是用 CSS 隐藏,才不会在首页留下空白的广告位)。

整套拦截由三层组成:

层级 运行位置 职责
页面注入层 WebView / 浏览器扩展内 Hook fetch 和 XMLHttpRequest,改写 JS 数据
数据清洗层 纯 TypeScript 模块 解析 JSON、剥离广告字段、过滤屏蔽列表
桌面网络层 Electron 主进程 在网络协议层直接改写 HTTP 响应,页面"无感"

三、源码拆解:广告拦截的三步实现

1. 页面层:Hook 住 fetch 和 XMLHttpRequest

核心入口是 content/intercept.ts。它做了三件事:

① 识别目标接口。 用一条正则锁定 YouTube 的 6 类数据接口:

export const RE_INTERCEPT = new RegExp('^/youtubei/v1/(browse|get_watch|next|player|reel|search)')

分别对应:首页/列表流(browse)、播放页侧栏(get_watch)、"下一页"续传(next)、播放器数据(player)、Shorts 流(reel)、搜索(search)。

② 劫持请求通道。 代码替换了 window.fetch,并给 XMLHttpRequest.prototype.open 打了补丁——YouTube 前端无论是走 fetch 还是 XHR 拿数据,都会先经过 NouTube 的过滤函数,拿到的是"已剥离广告"的 JSON。

③ 覆盖"服务端渲染"的数据。 首次打开页面时,YouTube 会把初始推荐流直接写进 HTML 的 <script> 里(ytInitialData、ytInitialReelWatchSequenceResponse 两个全局变量)。NouTube 用 Object.defineProperty 给它们的赋值过程也加了钩子,保证首屏数据同样被清洗,广告不会因为"来得早"而漏网。

2. 清洗层:精确删除广告字段与广告条目

真正的"手术刀"在 lib/intercept.ts,它是纯函数式的 JSON 转换模块,移动端、桌面端、浏览器扩展共用同一套逻辑:

对播放器响应(transformPlayerResponse / transformGetWatchResponse),删掉 4 个广告相关字段:

const keys = ['adBreakHeartbeatParams', 'adPlacements', 'adSlots', 'playerAds']

playerAds 被删掉,播放前贴片广告自然消失;adSlots 等字段则对应视频下方的广告卡位。

对列表/搜索响应(transformBrowseResponse / transformSearchResponse),由 filterListResponse 递归遍历整个 JSON 树:

  • 命中广告渲染器清单的条目 → 整条删除(而不是 CSS 隐藏)
  • 命中用户自定义屏蔽列表(频道/关键词,见 lib/blocklist.ts)的条目 → 同样删除
  • Shorts 流中带有 adClientParams.isAd 标记的条目 → 识别为广告并删除

值得一提的是,blockAds 是一个独立的开关,与"请求拦截"本身解耦(源码注释解释:拦截器还要负责屏蔽列表和标题改写,即使你选择放行广告来支持创作者,其余功能也照常工作)。

3. 桌面端:在网络协议层"无感改写"

桌面版(Electron)走了一条更彻底的路:desktop/src/main/lib/intercept.ts 通过 session.protocol.handle('https') 接管了整个 YouTube 域名的 HTTPS 流量。

也就是说,页面里的 JavaScript 完全不知道数据被改过——响应在到达 WebView 之前就已经在主进程里清洗完毕。这一层还额外处理了两类页面注入层够不到的数据:

  • HTML 内嵌 JSON:transformHtml 用括号配平算法(findJsonBounds)在 HTML 源码里定位 ytInitialData 和 ytInitialPlayerResponse 两个内联 JSON 块,就地替换,并对 < > & 做脚本转义,防止提前闭合 <script> 标签
  • 证书校验策略:对 youtube.com、googlevideo.com(视频 CDN)等域名放行,其他域名走默认校验,保证只有 YouTube 流量进入改写管道

四、广告开关与多端同步:blockAds 是怎么流转的

拦截能力默认开启(opt-out 设计,见 states/settings.ts),设置入口在 components/modal/SettingsModalTabSettings.tsx 的"阻止广告"开关。开关状态会同步到三处执行端:

  • 移动端 WebView:MainPageContent.tsx 监听 blockAds 变化,通过 syncSettingsToWebview() 和 mainClient.setBlockAds() 推送到页面脚本,注入层读取 window.NouTube.getSettings() 决定是否执行 stripAdKeys
  • 桌面端:主进程通过 setInterceptionBlockAds() 更新 transformOptions
  • 浏览器扩展:extension/lib/content-settings.ts 中 blockAds 同样默认为 true

此外还有一道 CSS 兜底:content/css.ts 在 blockAds 开启时追加 cssContentAds 规则,隐藏数据层可能漏掉的零星广告 UI 元素——数据拦截为主,CSS 兜底为辅,双保险。

五、这套"数据拦截"方案的优势与代价

优势 🎯

  • ✅ 零布局破损:广告位是"连格子一起删除",不会出现传统 CSS 隐藏式拦截器的空白占位
  • ✅ 无维护成本:不依赖社区过滤规则列表,只需要盯住 YouTube 的接口字段
  • ✅ 全端一致:移动端、桌面端、浏览器扩展复用同一个 lib/intercept.ts,行为完全一致
  • ✅ 可精细控制:贴片(player 响应)、信息流广告(browse 响应)、Shorts 广告(reel 响应)分别处理

代价 ⚠️

  • YouTube 一旦改动接口字段名或渲染器结构,拦截逻辑需要同步更新(这也是 NouTube 保持高频更新的原因)
  • 桌面端接管 HTTPS 协议需要额外的证书校验策略

六、动手看源码:clone 仓库自己读一读

想验证本文的原理,可以直接把代码拉下来,从这三个文件顺着读:

git clone https://gitcode.com/gh_mirrors/no/NouTube

推荐阅读顺序:

  1. lib/intercept.ts —— 先看"清洗规则":正则、广告字段、渲染器清单
  2. content/intercept.ts —— 再看页面层如何 Hook fetch/XHR 并调用清洗函数
  3. desktop/src/main/lib/intercept.ts —— 最后看桌面端如何在网络层直接改写响应

整条链路其实很精炼:一条正则圈定接口 → 一组纯函数清洗 JSON → 三个端复用同一套规则。这就是 NouTube 实现"无广告"的全部秘密。

登录后查看全文
NouTube