uWeb 中文文档 下载 App

拦截外链脚本——js.allow 白名单与脚本屏蔽

为什么需要拦截外链脚本

现代网页大量使用第三方 JavaScript:

这些脚本不仅影响加载速度,还会在后台收集用户行为数据。拦截它们可以:

开启方式

  1. 长按 设置按钮
  2. 选中"拦截外链脚本"
  3. 强制清空后台重启 uWeb

开启后,网页中引用自外部域名的 <script> 标签将被阻止加载。

什么是"外链脚本"

外链脚本指 <script src="..."> 中 src 指向的域名与当前页面域名不同的脚本。例如:

当前页面是 https://example.com/page.html:

js.allow 白名单

拦截外链脚本后,有些网站功能可能需要第三方脚本才能工作(如 Google 登录、PayPal 支付、reCAPTCHA 验证等)。js.allow 文件用于白名单放行:

格式

每一行一个信任的域名:

accounts.google.com
www.gstatic.com
paypal.com
www.google.com

工作机制

开启"拦截外链脚本"时:

  1. 所有外链脚本默认被阻止
  2. js.allow 里列出的域名不被阻止
  3. 同一域名的主站资源始终不受影响

推荐的白名单配置

场景应该放行的域名
Google 登录accounts.google.com, www.gstatic.com
reCAPTCHAwww.google.com (recaptcha), www.gstatic.com
PayPalpaypal.com
国内常用cdn.bootcdn.net, cdnjs.cloudflare.com, cdn.jsdelivr.net, unpkg.com
字体(如果需要)fonts.googleapis.com, fonts.gstatic.com

排查网站异常

拦截外链脚本后如果某些网站功能异常:

  1. 在普通浏览器打开同网站,打开开发者工具 → Network → 筛选 JS
  2. 对比被拦截和放行的脚本
  3. 找出网站正常运行需要的第三方域名
  4. 添加到 js.allow
  5. 强制清空后台重启 uWeb

与 sitejs 的关系

拦截外链脚本是"网络层面阻止",与 sitejs/ 目录里的用户脚本不冲突:

配合长按 ☰ 的额外操作

长按底部工具栏 ☰ 菜单按钮可以对页面做更多清理:

这些操作是"即时"的,不需要配置文件,在你觉得当前页面广告特别多时临时使用。

下一章