Chrome 打包应用 webview 分区隔离实战:基于 chrome-extensions-samples 的 local-resources 示例全解析

原创2026-09-20 12:13:301,858 阅读
文章标签:示例工程

Chrome 打包应用 webview 分区隔离实战:基于 chrome-extensions-samples 的 local-resources 示例全解析

导读

本文以 chrome-extensions-samples 仓库 _archive 目录下归档的 local-resources 示例 为核心,深入剖析 Chrome 打包应用(Packaged App)中 <webview> 标签的 partition(分区)隔离机制,以及如何通过 manifest 为特定分区授予访问应用本地打包资源的权限。读完本文,你将掌握:为什么"可信本地内容"与"不可信外部内容"必须放入不同的 webview partition、共享 partition 会引发怎样的崩溃传染风险,以及如何用 webview.partitions 配置精确控制本地资源的访问边界——这是所有嵌入第三方网页的 Chrome 应用都绕不开的安全设计问题。

说明:该示例属于 Manifest V2 时代的 Chrome Apps("manifest_version": 2),现已随 Chrome Apps 的落幕归档于 _archive 目录,但其 partition 隔离思想对理解 Chromium 的进程/存储隔离模型仍有直接参考价值。

local-resources 示例运行截图:左侧 Bad application 与右侧 Good application 双窗口对比,展示 webview 分区隔离效果

一、示例要解决的问题:可信与不可信内容如何共存

在 Chrome 打包应用中,<webview> 标签用来在应用界面内嵌第三方网页。但这里存在一个天然矛盾:

  • 可信内容:应用打包在本地(如 trusted.html),是开发者自己控制、可完全信赖的资源;
  • 不可信内容:来自互联网(示例中为 http://en.wikipedia.org/wiki/Cross-site_scripting),随时可能崩溃、执行恶意脚本或被钓鱼页面替换。

如果两者混在一起渲染,一次外部网页的崩溃就可能连累整个应用。local-resources 示例的核心价值,就是用一组可运行的对比实验(Good / Bad 两个窗口)把这种风险直观地演示出来。

依据仓库内文档的原始描述(_archive/apps/samples/webview-samples/local-resources/README.md):

在 bad 示例中,可信与不可信内容共享同一个 partition;模拟不可信 webview 崩溃会同时拖垮可信 webview。而 good 示例将两者放入不同 partition,模拟不可信 webview 崩溃时,可信 webview 不受任何影响。

二、核心机制:webview 的 partition(分区)是什么

<webview> 标签的 partition 属性决定了一个 webview 的"隔离域"。从该示例可以归纳出 partition 的两层含义:

1. 存储与进程的隔离边界

  • 相同 partition 的 webview 共享同一组存储(localStorage、IndexedDB、Cookies 等);
  • 不同 partition 之间存储完全独立,互不可见;
  • 相同 partition 的 webview 运行在关联的渲染进程中,因此其中一个崩溃会影响同 partition 的其它 webview。

2. 本地资源访问权限的授予单元

  • 应用内的打包资源(如 trusted.html)默认不暴露给任何 webview;
  • 只有通过 manifest 中 webview.partitions 显式授权的 partition,才能访问这些本地资源。

这正是示例文档反复强调的三个概念——Webview、Permissions、Partitions 的交叉点(原文档 Resources 一节分别列出了这三个主题的官方参考资料,本文不再给出外部链接,读者可在仓库内对照学习)。

三、manifest 配置:为特定分区授予本地资源访问权

示例的 manifest.json 完整演示了权限授予的写法:

{
  "manifest_version": 2,
  "name": "Local Resources Sample",
  "minimum_chrome_version": "24.0.1307.0",
  "version": "2.0",
  "icons": {
    "16": "icon_16.png",
    "128": "icon_128.png"
  },
  "app": {
    "background": {
      "scripts": ["main.js"]
    }
  },
  "permissions": [
    "webview"
  ],
  "webview": {
    "partitions": [
      {
        "name": "bad",
        "accessible_resources": ["trusted.html"]
      },
      {
        "name": "good_trusted",
        "accessible_resources": ["trusted.html"]
      }
    ]
  }
}

逐个字段说明(依据本仓库源码实际配置):

字段 取值 作用
permissions: ["webview"] 固定值 应用级权限声明:使用 <webview> 标签的前置条件
webview.partitions[].name "bad" / "good_trusted" 声明一个可被 <webview partition="..."> 引用的分区名
webview.partitions[].accessible_resources ["trusted.html"] 该分区允许访问的应用本地打包资源白名单

两个值得注意的细节:

  • accessible_resources 是精确白名单:只有列出的文件(此处为 trusted.html)对指定分区可见,其它打包资源仍被屏蔽,体现了"最小授权"原则;
  • 未列入的分区默认无本地权限:示例里刻意没有为 good_untrusted 分区声明任何 accessible_resources,用于承载不可信外部内容,从 manifest 层面就切断了它对本地资源的访问路径。

此外,"minimum_chrome_version": "24.0.1307.0" 表明该 API 自 Chrome 24 起可用,这也是它被归入 _archive 归档区的原因——API 本身随 Chrome Apps 停用而退役。

四、Bad 示例:共享 partition 的崩溃传染

bad_app.html 中,两个 webview 都使用了 partition="bad":

<!-- Bad application! Putting untrusted content in the same partition
  -- as trusted content! -->
<webview id="trusted" class="full trim" partition="bad"
     src="trusted.html"></webview>

<webview id="untrusted" class="full trim" partition="bad"
     src="http://en.wikipedia.org/wiki/Cross-site_scripting"></webview>

这里可信的 trusted.html 与不可信的维基百科页面挤在同一个 partition 里。虽然 bad 分区在 manifest 中确实被授予了 trusted.html 的访问权,但这正是"坏例子"的根源:

  • 因为共享 partition,两个 webview 的存储上下文和渲染进程是关联的;
  • 当 untrusted webview 崩溃时,同 partition 的 trusted webview 也会被一并拖垮;
  • 运行效果正如 README 所述——模拟不可信内容崩溃,可信内容同时崩溃。

安全结论:把本地可信资源授权给"也承载外部内容的同一分区",等于在隔离墙上开了一扇门,崩溃与潜在的越权访问都会顺着这扇门蔓延进来。

五、Good 示例:分区隔离的正确姿势

good_app.html 给出了正确做法——为可信与不可信内容分配两个不同的分区:

<webview id="trusted" class="full trim" partition="good_trusted"
     src="trusted.html"></webview>

<!-- Good application! Putting untrusted content in a partition with
  -- no local resource access -->
<webview id="untrusted" class="full trim" partition="good_untrusted"
     src="http://en.wikipedia.org/wiki/Cross-site_scripting"></webview>
  • good_trusted 分区:对应 manifest 中 accessible_resources: ["trusted.html"] 的声明,承载应用本地可信内容;
  • good_untrusted 分区:未在 manifest 中声明任何本地资源权限,只用于加载外部网页。

这样既保证了可信内容能正常读取打包资源(trusted.html 位于 trusted.html,内容是一段标注 "Your Trusted Package Content" 的静态页面),又把不可信内容彻底关在独立的隔离域里——即使它崩溃,也影响不到 good_trusted 分区中的可信 webview。

隔离原则总结:

  1. 本地资源访问权只授予承载可信内容的分区;
  2. 不可信内容使用独立、无本地权限的分区;
  3. 每个业务信任级别对应一个独立 partition,互不交叉。

六、验证手段:用 crash.js 模拟崩溃并重载

两个 HTML 页面都通过 crash.js 提供了交互验证按钮,其核心逻辑如下:

window.addEventListener('load', function(e) {
  var crashButton = document.querySelector('#simulate-crash');
  var reloadButton = document.querySelector('#reload');
  var webview = document.querySelector('#untrusted');
  crashButton.addEventListener('click', function(e) {
    webview.terminate();
  });
  reloadButton.addEventListener('click', function(e) {
    webview.reload();
  });
});

两个关键 API 的语义:

  • webview.terminate():立即终止该 webview 对应的渲染进程,等效于"模拟外部网页崩溃"。由于它作用于 #untrusted 元素,若该元素与可信内容共享 partition(Bad 场景),可信 webview 随之崩溃;若分区隔离(Good 场景),可信 webview 安然无恙;
  • webview.reload():重新加载外部内容,用于崩溃后恢复演示现场,方便反复对照两种行为差异。

页面按钮分别标注为 "Simulate foreign web content crash" 与 "Reload foreign web content"(见 good_app.html 与 bad_app.html)。

七、应用装配:main.js 如何同时打开两个窗口

main.js 负责应用启动装配,它监听应用生命周期事件并同时创建 Good 与 Bad 两个窗口,方便并排对比:

chrome.app.runtime.onLaunched.addListener(function() {
  runApp();
});
chrome.app.runtime.onRestarted.addListener(function() {
  runApp();
});

function runApp() {
  chrome.app.window.create(
    'good_app.html',
    {'id': 'GoodWindowID'});
  chrome.app.window.create(
    'bad_app.html',
    {'id': 'BadWindowID'});
}
  • chrome.app.runtime.onLaunched:应用首次启动时触发;
  • chrome.app.runtime.onRestarted:应用被系统重启后触发,保证两种启动路径都能重建演示窗口;
  • chrome.app.window.create:分别以窗口 ID GoodWindowID / BadWindowID 创建两个并排窗口,分别加载 good 与 bad 两个 HTML 页面。

两页共用的 app.css 通过 flex 布局让 webview 铺满窗口(.full 的 width/height: 100% 配合 .flex-container),确保对比画面清晰。

八、如何运行与验证

由于示例属 MV2 时代的 Chrome Apps,运行验证需要满足以下前提(基于仓库实际配置推断,请以当时的 Chrome 环境为准):

  1. 确认环境支持 Chrome Apps 与 webview API(示例要求最低 Chrome 24.0.1307.0,见 manifest);
  2. 在 chrome://extensions 开发者模式下加载 _archive/apps/samples/webview-samples/local-resources 目录(该目录内含 manifest.json、两个 HTML、crash.js、main.js、trusted.html 及图标资源);
  3. 启动后出现两个窗口:
    • Bad application:点击 "Simulate foreign web content crash",观察可信内容("Your Trusted Package Content" 页)是否同步崩溃;
    • Good application:做同样的操作,观察可信内容保持完好;
  4. 点击 "Reload foreign web content" 可随时恢复不可信内容,反复验证。

仓库中 _archive/apps/samples/webview-samples 目录还包含 browser、multi-tab-browser、new-window、user-agent 等同主题 webview 示例,可与本示例对照阅读,形成对 webview API 的系统认知。

结语

local-resources 示例用一对 Good/Bad 窗口,把 Chrome webview 的安全模型压缩成了一个 30 秒即可理解的实验:partition 既是存储隔离域,也是崩溃隔离域,更是本地资源访问的授权边界。信任级别不同的内容必须各归其位——可信资源只授予可信分区,不可信内容永远留在无权限的独立分区中。虽然该 API 已随 Chrome Apps 归档,但"分区隔离 + 最小权限白名单"这一设计范式,在今天任何嵌入第三方内容的 WebView/iframe 架构中依然成立。

登录后查看全文
chrome-extensions-samples