IPFS Companion浏览器扩展从MV2到MV3的技术迁移解析-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00697/article/details/148891489

IPFS Companion浏览器扩展从MV2到MV3的技术迁移解析

前言

随着浏览器扩展技术的演进，Manifest V3（简称MV3）规范带来了重大的架构变革。作为IPFS生态中的重要组件，IPFS Companion扩展也面临着从MV2到MV3的技术迁移挑战。本文将深入解析这一迁移过程中的核心技术要点。

MV3带来的根本性变化

MV3规范最显著的变化之一是对请求拦截机制的重新设计。在MV2时代，扩展可以同步拦截网络请求（blocking request），这种机制虽然直接高效，但也带来了性能和安全方面的隐患。

MV2时代的工作流程

在MV2架构下，IPFS Companion的工作流程非常直观：

浏览器发起网络请求
扩展同步拦截请求
检查请求是否可以通过IPFS服务
- 检查是否包含CID（内容标识符）
- 或检查是否可通过IPNS解析
满足条件则重定向到本地IPFS节点
否则继续正常请求流程

这种同步机制虽然简单，但会导致扩展成为浏览器性能的瓶颈。

MV3的新范式：声明式网络请求

MV3引入了declarativeNetRequest API，采用声明式规则替代了同步拦截机制。这种变化带来了架构上的重大调整：

异步观察模式：扩展不再直接拦截请求，而是观察请求
动态规则管理：扩展分析请求后，动态添加重定向规则
浏览器自主决策：浏览器根据规则集自主决定是否重定向

关键技术实现

在新的架构下，IPFS Companion需要解决几个核心问题：

规则优化策略：由于MV3限制最多只能存在5000条规则，我们需要采用正则表达式合并相似规则。例如：

原始规则：

https://ipfs.io/ipns/en.wikipedia-on-ipfs.org 
→ http://localhost:8080/ipns/en.wikipedia-on-ipfs.org

优化后的正则规则：

https://ipfs.io/ipns/(.*) 
→ http://localhost:8080/ipns/$1

完整规则示例：

{
  "action": {
    "redirect": {
      "regexSubstitution": "http://localhost:8080\\1"
    },
    "type": "redirect"
  },
  "condition": {
    "regexFilter": "^https?\\:\\/\\/ipfs\\.io((?:[^\\.]|$).*)$",
    "resourceTypes": ["main_frame", "script", ...]
  },
  "id": 1234,
  "priority": 1
}