Brave浏览器需启用IPFS Companion扩展并配置内置IPFS节点或切换HTTP网关,才能正常访问ipfs://或ipns://资源;验证时地址栏应自动转换协议且Network面板显示对应网关域名。

如果您希望在Brave浏览器中访问以ipfs://或ipns://开头的去中心化资源,但页面无法加载或提示协议不支持,则可能是IPFS功能未启用或本地节点未配置。以下是启用Brave浏览器IPFS支持的具体操作步骤:
一、启用IPFS Companion扩展
IPFS Companion是官方推荐的浏览器扩展,用于拦截并重定向IPFS/IPNS协议请求至本地或远程网关,实现无缝访问。该扩展兼容Brave基于Chromium的架构,并支持MV3规范。
1、启动Brave浏览器,在地址栏输入 brave://extensions 并回车。
2、在右上角开启“开发者模式”开关。
3、点击“加载已解压的扩展程序”,选择已下载的IPFS Companion v3.1.0文件夹路径;或直接访问Chrome Web Store搜索“IPFS Companion”,点击“添加至Brave”。
4、安装完成后,确保扩展右侧的启用开关处于开启状态,并确认其权限包含“在所有网站上运行”及“读取和更改网页数据”。
二、配置内置IPFS节点(桌面版)
Brave桌面版(Windows/macOS/Linux)原生集成IPFS节点能力,无需额外安装go-ipfs守护进程。启用后浏览器将作为轻量级P2P节点参与网络,提升内容获取效率与本地解析能力。
1、在地址栏输入 brave://settings/ipfs 并回车。
2、在“IPFS节点设置”区域,点击“启用IPFS节点”按钮。
3、选择节点运行模式:仅限本地网关(推荐初学者) 或 完整节点(启用DHT与对等连接)。
4、点击“重启浏览器”使配置生效。重启后可在地址栏输入 http://127.0.0.1:48080/ipfs/Qm... 验证本地网关是否响应。
三、切换IPFS HTTP网关
当本地节点未运行时,Brave默认通过 dweb.link 网关解析IPFS内容。您可手动更换为更稳定或地理更近的公共网关,如 cloudflare-ipfs.com 或 ipfs.io,以改善加载成功率。
1、访问 brave://settings/ipfs。
2、在“HTTP网关”输入框中,粘贴目标网关地址,例如:https://cloudflare-ipfs.com。
3、确保URL以 https:// 开头且无尾部斜杠。
4、点击“保存更改”,随后尝试打开任意 ipfs://Qm... 链接验证重定向效果。
四、验证IPFS协议支持状态
完成上述任一配置后,需确认Brave已正确识别并处理原生IPFS协议。该验证可排除DNSLink解析失败、MIME类型误判或扩展拦截冲突等问题。
1、在新标签页中输入测试URL:ipfs://bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi。
2、若出现“此协议不受支持”提示,检查IPFS Companion是否被其他广告拦截器(如uBlock Origin)禁用。
3、若地址栏自动变更为形如 http://bafybeig...ipfs.localhost:8080 的格式,表明协议转换成功。
4、打开开发者工具(F12),切换至Network面板,刷新页面,确认请求目标域名含 .ipfs.localhost 或所设网关域名。











