作者简介：戴嘉乐( Mr.Maple ) | 前百度高级研发工程师 | IPFS应用实践者&布道师| 个人网站：https://www.daijiale.cn 微信号：daijiale6239

注意：文章中部分链接需要 科学上网 才能访问下载

一、应用简介

IPFS伴侣（IPFS Companion）是一个由IPFS官方应用社区（IPFS-Shipyard）孵化出来的应用项目。 Ta是一个浏览器插件，可以帮助用户在本地更好的运行、管理自己的节点，并随时查看IPFS节点的资源信息。

1.1 效果

1.2 开源地址

https://github.com/ipfs-shipyard/ipfs-companion

二、应用特性

2.1 IPFS资源自动检测

可以检测到如： /ipfs/$cid 或  /ipns/$peerid_or_fqdn 这样网页端的任何资源请求链接。如果经过测试的资源链接是一个有效的IPFS地址，它将被重定向并从本地网关加载:

例如: https://ipfs.io/ipfs/QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR →  http://127.0.0.1:8080/ipfs/QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR

2.2 IPFS连接状态和图形操作栏

• IPFS接口和网关状态

• 本地文件快速上传图形操作

• 一键登录WebUI控制台以及偏好管理

• 支持重定向切换到本地网关(默认情况下，手动模式可以在首选项中启用)

• 可以对IPFS加载页进行如下的附加操作：

• 通过API对IPFS资源进行Pin/Unpin

• 复制IPFS地址

• 将可分享的资源地址复制到首选网关中

2.3 调试实验

默认情况下是未启用的，需要切换到Preferences Screen。

• 通过 自定义ipfs://网关协议 重新路由到HTTP网关:

• ipns://$cid

• ipns://$cid_or_fqdn

• dweb:/ipfs/$cid

• dweb:/ipns/$cid_or_fqdn

• 通过 dnslink 检测DNS文本记录并从IPFS加载它们

• 让纯文本的IPFS链接可以被点击

• 右键点击任何图像或视频来进行IPFS镜像切换

• 即使在外部API关闭的情况下，本地节点也可以用于上传数据。

• 将IPFS API的子集公开为window.ipfs ，意味着每个网页加载时就可以监听到IPFS节点的接入，而不是生成自己的js-ipfs节点，这节省了资源、电量等消耗。

三、安装方式

3.1 稳定版本（Release）

• Firefox 火狐浏览器：https://addons.mozilla.org/en-US/firefox/addon/ipfs-companion/

注意: ipfs-companion是作为IPFS Daemon守护进程的扩展而设计的，请确保你的电脑上已先提前安装了 IPFS

3.2 测试版本（Beta）

主要面向开发者人群和发烧友调试使用

• Firefox Beta 版本 : Self-hosted Signed Dev Build

• Chrome Beta 版本: Dev Build at Chrome Web Store

四、使用演示

这边截图了部分自己的使用情况，给大家图文说明：

• 安装扩展 

• 设置Chrome浏览器该插件为启用状态 

• 插件识别不到本地节点启动，处于离线状态

• 启动本地节点

• 打开 IPFS伴侣插件，将自动识别IPFS短链，并开启重定向功能 

=

• 得益于官方的JS扩展支持到了window.ipfs的程度 

• 进入插件配置选项，如下图所示，这边可以根据用户&开发者需要，灵活调整网关、API、和DNS配置

• 识别到ipfs短链资源，且能查看到连接节点数

• 快速上传功能 

• 快速上传后发布到公网

• 通过插件打开Web UI控制台 Review资源同步状态

PS：之前大部分的朋友都是通过命令行来操作这些，比较繁琐，耗时，这次 Mr.Maple博主特意给大家介绍了一款这样的浏览器工具，期望能帮助各位IPFS开发者&发烧友节约更多精力。

五、开发支持其他浏览器的插件

这边，官方公布了Web扩展API，供开发者和发烧友使用，支持开发者构建基于其他浏览器的插件。感兴趣、有能力的朋友可以实现一下运行在360、猎豹、QQ（这些基于Chrome和Firefox内核）的浏览器的IPFS工具插件。

官方支持两种构建模式:

• 资源包构建（推荐）

• Docker镜像构建

具体实现Tips如下： Developer Notes for IPFS Companion

值得一提的是：

2018年1月26日，火狐 WebExtensions 产品经理 Mike Conca 在 Mozilla 官网发布了文章(Extensions in Firefox 59)，列举了火狐59的最新扩展(目前发布于测试版)。其中一项特性是支持包括IPFS在内的分布式协议。

所以，强烈建议对IPFS浏览器插件开发感兴趣的开发者使用基于Firefox内核的浏览器 调试会比较好。

六、使用QA和Bug提交

官方在Github上提供了专门的issue讨论区，大家在使用过程中遇到问题可以在这查询解决方案： https://github.com/ipfs/ipfs-companion/issues/22.

七、参考文献

• 【区块链】利用ipfs构建自己的去中心化分布式wiki系统

• ipfser.org：火狐浏览器支持IPFS在内的分布式协议

• Github Organization ---- IPFS Shipyard 船厂

相关文章和视频推荐