NouTube 无广告黑科技:拦截 YouTube 广告请求的完整实现原理
NouTube 无广告黑科技:拦截 YouTube 广告请求的完整实现原理
NouTube 是一款支持 Android、iOS 和桌面的无广告 YouTube / YouTube Music 播放器。它实现"无广告"的核心原理并不是屏蔽广告视频文件,而是在数据层拦截 YouTube 的 /youtubei/v1/* API 请求,把返回 JSON 里的广告条目提前剥离,让广告根本没有机会渲染到界面上。
一、NouTube 简介:一个"无广告"的 YouTube 客户端
NouTube 的定位非常聚焦:把 YouTube 和 YouTube Music 装进同一个应用,并且做到:
- 🚫 No ads(无广告):首页推荐、搜索结果、播放前贴片全部拦截
- ▶️ 背景播放:锁屏、切后台继续播放视频和音乐
- 📥 下载视频、管理书签/历史(无需登录)
- 🔔 频道 RSS 订阅、隐藏 Shorts、直播弹幕、自定义 CSS 等
官方 README(README.md)用三句话概括了技术路线:
- 用 WebView 包裹
m.youtube.com和music.youtube.com - 注入代码拦截广告(Inject code to block ads)
- 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
推荐阅读顺序:
- lib/intercept.ts —— 先看"清洗规则":正则、广告字段、渲染器清单
- content/intercept.ts —— 再看页面层如何 Hook fetch/XHR 并调用清洗函数
- desktop/src/main/lib/intercept.ts —— 最后看桌面端如何在网络层直接改写响应
整条链路其实很精炼:一条正则圈定接口 → 一组纯函数清洗 JSON → 三个端复用同一套规则。这就是 NouTube 实现"无广告"的全部秘密。