作者简介：戴嘉乐( 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://$cidipns://$cid_or_fqdndweb:/ipfs/$ciddweb:/ipns/$cid_or_fqdn- 通过 dnslink 检测DNS文本记录并从IPFS加载它们
- 让纯文本的IPFS链接可以被点击
- 右键点击任何图像或视频来进行IPFS镜像切换
- 即使在外部API关闭的情况下，本地节点也可以用于上传数据。
- 将IPFS API的子集公开为window.ipfs ，意味着每个网页加载时就可以监听到IPFS节点的接入，而不是生成自己的js-ipfs节点，这节省了资源、电量等消耗。
三、安装方式
3.1 稳定版本（Release）
注意: 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 船厂
相关文章和视频推荐
【戴嘉乐】IPFS Desktop：IPFS节点桌面管理App
圆方圆学院汇集大批区块链名师，打造精品的区块链技术课程。 在各大平台都长期有优质免费公开课，欢迎报名收看。
公开课地址：https://ke.qq.com/course/345101
