IPFS星际文件系统
IPFS星际文件系统(InterPlanetary File System)是去中心化文件系统,本文介绍IPFS节点软件系统安装,环境搭建等简介入门教程，及学习如何使用ipfs-api和Node.js访问IPFS网络。
一、ipfs节点安装与使用
1.1下载节点软件
到官网下载windows版的ipfs节点软件：32位，64位
如果你不能访问官网，可以使用百度云盘镜像：32位，64位
1.2解压节点软件
下载后解压到指定目录，例如d:\go-ipfs，开一个控制台窗口，测试：
D:\go-ipfs > ipfs version
Ipfs version 0.4.14
可以将该目录加入环境变量PATH，
或者将d:\go-ipfs\ipfs.exe拷贝到windows系统目录，以便在任何目录中可以启动ipfs.exe。
1.3 初始化本地仓库
和git类似，ipfs节点也需要先初始化一个本地仓库。执行init子命令来初始化本地仓库：
D:\go-ipfs> ipfs init
Initializing IPFS node at C:\Users\hubwiz\.ipfs
generating 2048-bit RSA keypair...done
peer identity: QmQaTgU1TLNHPBEvLGgWK1G9FgVByyUZNVhDs789uWPtku
to get started, enter:
ipfs cat /ipfs/QmS4ustL54uo8FzR9455qaxZwuMiUhyvMcX9Ba8nUH4uVv/readme
默认情况下，ipfs将在当前用户主目录（例如：对于hubwiz用户，其主目录就是C:\Users\hubwiz）下建立.ipfs子目录，作为本地仓库的根目录。
如果你的C盘空间不够大，或者你就是希望使用其他目录作为本地仓库根目录，可以设置IPFS_PATH环境变量，使其指向目标路径，例如D:\my_ipfs_root
1.4重新初始化
如果你期望重新初始化节点，会提醒你不能这么做，否则会改写你的密钥：
D:\go-ipfs> ipfs init
Initializing IPFS node at C:\Users\hubwiz\.ipfs
Error: ipfs configuration file already exists!
Reinitializing would overwrite your keys.
这挡不住我们。如果你必须重新初始化的话，先删除原来的仓库根目录即可：
D:\go-ipfs> del C:\users\hubwiz\.ipfs
1.5将文件添加到本地仓库
使用add子命令将指定的文件添加到本地仓库，例如将当前目录的README.md文件添加到本地仓库：
D:\go-ipfs> ipfs add README.md
465 B / ? [-------------------------------------------------------=--]
added QmXBpD37vBm5537pqHwyJRGSaX7hMrkHyp866wqEVU2BE8 README.md
ipfs会根据文件的内容生成一个哈希值，例如：
QmXBpD37vBm5537pqHwyJRGSaX7hMrkHyp866wqEVU2BE8
你需要记录下这个编码，因为需要使用它来访问本地仓库（或ipfs网络）中的文件。
注意：ipfs并不会无节制地将你本地仓库中的文件分布到其他ipfs节点中，如果没有其他的ipfs节点搜索你的文件（的哈希值），那么你本地仓库中的文件将始终只存在于本地。
1.6访问ipfs文件
Ipfs网络中只能通过内容的哈希值来访问文件，例如对于上面的README.md文件，我们使用cat子命令通过其哈希值来查看其内容：
D:\go-ipfs> ipfs cat QmXBpD37vBm5537pqHwyJRGSaX7hMrkHyp866wqEVU2BE8
控制台将输出内容：
\# ipfs commandline tool
This is the [ipfs](http://ipfs.io) commandline tool. It contains a full ipfs node.
......
1.7 将节点接入网络
执行daemon子命令将节点接入ipfs网络：
D:\go-ipfs> ipfs daemon
Initializing daemon...
......
Daemon is ready
只有当启动监听后，节点才能够接受ipfs网络中的内容检索请求，参与内容的交换与分布。
可以按Ctrl+C退出监听状态。
?
二、ipfs-api安装与使用
Ipfs节点提供和REST API接口，可供我们在程序代码中操作节点进行文件的上传等操作。不过大多数情况下，我们并不需要直接操作这个REST开发接口，而是使用经过封装的更友好的ipfs-api，一个nodejs包。
2.1安装nodejs
到官网下载nodejs安装包：32位，64位。下载后双击进行安装即可。
开一个控制台窗口，测试：
C:\Users\hubwiz> node -v
V8.11.1
2.2安装ipfs-api
Ipfs-api的安装需要git命令行，因此我们先安装git。从官网下载git安装包：32位，64位。下载后双击安装即可。
执行git命令测试：
D:\test-ipfs-api> git version
git version 2.16.2.windows.1
ipfs-api需要编译原生node模块，因此需要安装VisualStudio 2015和python27。
官网下载VisualStudio 2015社区版，双击安装即可。
官网下载Python27安装包，双击安装并设置PATH环境变量使python可用。
重新开一个控制台，使环境变量生效。现在安装ipfs-api：
D:\test-ipfs-api> npm install ipfs-api
+ ipfs-api@20.0.1
added 1 package, updated 1 package and moved 1 package in 22.138s
2.3测试代码 – nodejs
在D:\test-ipfs-api目录下创建一个测试脚本test.js：
const ipfsAPI = require('ipfs-api')
const ipfs = ipfsAPI('localhost', '5001', {protocol: 'http'})
const buffer = Buffer.from('this is a demo')
ipfs.add(buffer)
.then( rsp => console.log(rsp[0].hash))
.catch(err => console.error(err))
执行这个脚本：
D:\test-ipfs-api> node test.js
QmfQS4vm9YZTAyGZEkDqm81xripwsK3NgqfNkbCdoeEw5i
也就是说，我们将内容this is a demo添加到本地仓库后，得到哈希值
QmfQS4vm9YZTAyGZEkDqm81xripwsK3NgqfNkbCdoeEw5i。现在可以使用cat子命令来查看这个哈希值对应的内容：
D:\test-ipfs-api> ipfs cat QmfQS4vm9YZTAyGZEkDqm81xripwsK3NgqfNkbCdoeEw5i
控制台会输出我们之前上传的内容：
this is a demo
ipfs进入监听状态后，提供了一个http网关，让我们可以使用浏览器来访问ipfs上的内容。网关默认在本机（127.0.0.1）的8080端口监听，因此使用你的浏览器访问这个URL：
http://127.0.0.1:8080/ipfs/QmfQS4vm9YZTAyGZEkDqm81xripwsK3NgqfNkbCdoeEw5i
同样可以看到我们之前上传的内容。
注意：需要首先启动监听器（ipfs daemon）并且你的浏览器和ipfs节点在同一台计算机。
?
三、在浏览器中访问ipfs
ipfs-api也支持在browser使用。最简单的方法是使用专门针对浏览器的封装库，在html中引用即可：
<script src="https://unpkg.com/ipfs-api/dist/index.js"></script>
这个特别封装的库会创建一个全局对象ipfsAPI，我们在浏览器脚本中可以直接使用，例如：
var ipfs = window.IpfsApi('localhost', '5001')
这种方法比较简单，因此下文不再描述。接下来我们将使用更加工程化的方法，
采用webpack来直接在前端脚本中使用ipfs-api的nodejs包。
3.1 HTML页面
在D:\test-ipfs-api目录下创建index.html：
<!doctype html>
<html>
<head>
<meta charset="utf-8">
</head>
<body>
<textarea id="content">THIS IS ANOTHER DEMO</textarea>
<button id="upload">Upload</button>
<script src="./bundle.js"></script>
</body>
</html>
我们的目标是，当点击按钮时，我们将文本框的内容上传到ipfs
3.2前端脚本
在D:\test-ipfs-api目录下编写脚本app.js：
import ipfsAPI from 'ipfs-api'
const ipfs = ipfsAPI('localhost', '5001', {protocol: 'http'})
window.addEventListener('load', function() {
let btn = document.querySelector('#upload')
let txt = document.querySelector('#content')
btn.addEventListener('click',()=>{
let buffer = Buffer.from(txt.value, 'utf-8');
ipfs.add(buffer)
.then( rsp => console.log(rsp[0].hash))
.catch(err => console.error(err))
})
})
3.3 webpack配置
在D:\test-ipfs-api目录下编写配置文件webpack.config.js：
const webpack = require('webpack');
const path = require('path');
const CopyWebpackPlugin = require('copy-webpack-plugin');
module.exports = {
entry: './app.js',
output: {
path: path.resolve(__dirname),
filename: 'bundle.js'
},
module: {
loaders: [
{
test: /\.js$/,
exclude: /(node_modules|bower_components)/,
loader: 'babel-loader',
query: {
presets: ['es2015'],
plugins: ['transform-runtime']
}
}
]
}
}
3.4前端脚本打包
执行webpack打包：
D:\test-ipfs-api> webpack
3.5 配置ipfs的CORS策略
由于需要从网页中访问ipfs节点，这就引入了跨域安全问题，因此我们需要配置ipfs节点使其允许跨域请求：
D:\>ipfs config --json API.HTTPHeaders.Access-Control-Allow-Origin '["*"]'
3.6 配置ipfs的API监听地址
由于ipfs节点默认在本机（127.0.0.1）的5001端口监听API请求，因此如果你的浏览器和ipfs节点不在同一台机器上，需要让ipfs节点监听公开地址：
D:\> ipfs config --json Addresses.API '"/ip4/0.0.0.0/tcp/5001"'
当然，如果你的浏览器和ipfs节点在同一台机器上，就不需要进行这个配置了。
3.7配置ipfs的网关的监听地址
由于ipfs节点旳http网关默认在本机（127.0.0.1）的8080端口监听http请求，因此如果你的浏览器和ipfs节点不在同一台机器上，就需要让ipfs网关监听公开地址：
D:\> ipfs config --json Addresses.Gateway '"/ip4/0.0.0.0/tcp/8080"'
3.8测试网页
首先启动ipfs监听：
D:\>ipfs daemon
然后在测试目录下启动web服务器，这里使用python内置的简单服务器，当然你可以使用任何熟悉的web服务器：
D:\test-ipfs-api> python –m SimpleHTTPServer
Serving HTTP on 0.0.0.0 port 8000 ...
现在打开你的浏览器，访问http://127.0.0.1:8000/，一切顺利的话，你可以看到一个文本框和一个按钮，点击按钮，即可将文本框的内容上传到ipfs节点。
安利两个以太坊相关的实战教程：
区块链初学者 ： 以太坊 DApp 实战开发入门
区块链开发进阶：去中心化以太坊 DApp 电商平台实战开发
IPFS星际文件系统的更多相关文章
- IPFS(星际文件系统)-初步接触
〇.IPFS介绍 从HTTP到IPFS,星际文件系统能变革信息传播的方式吗? 戴嘉乐:详解IPFS的本质.技术架构以及应用 以下为实现相关摘要 1.存储 在IPFS中,信息可以存储进IPFS系统中的块 ...
- 以太坊开发DApp实战教程——用区块链、星际文件系统（IPFS）、Node.js和MongoDB来构建电商平台（一）
第一节 简介 欢迎和我们一起来用以太坊开发构建一个去中心化电商DApp!我们将用区块链.星际文件系统(IPFS).Node.js和MongoDB来构建电商平台类似淘宝的在线电商应用,卖家可以自由地出售 ...
- IPFS星际节点网站 IPNS域名解析教程
IPNS星际文件系统IPFS提供的域名命名空间,相当于经典HTTP协议中的DNS.只不过是,IPNS是将内容寻址的哈希值(HASH值)转换为域名,而DNS是将IP地址转换为域名. 前段时间,IPFS协 ...
- 什么是IPFS?(一)
写在前面: 今天先写到这里, 关于IPFS的所有事情小编都想快点告诉大家, 但毕竟精力有限, 小编尽量抽出时间提供更多的关于IPFS的信息. ----------------------------- ...
- IPFS - 可快速索引的版本化的点对点文件系统（草稿3）
摘要 星际文件系统是一种点对点的分布式文件系统, 旨在连接所有有相同的文件系统的计算机设备.在某些方面, IPFS类似于web, 但web 是中心化的,而IPFS是一个单一的Bittorrent 群集 ...
- 站在Web3.0 理解IPFS是什么
尽管网络上,已经有不少文章讨论IPFS,不过真正讲明白IPFS想做什么的很少,文本尝试站在未来Web3.0的高度来看看IPFS究竟用来解决什么问题. DApp 的缺陷 对区块链有所了解的同学,知道区块 ...
- IPFS扫盲
第二届深圳区块链技术与应用大会暨展览会,深圳区块链存储与IPFS技术应用大会暨展览会于2019年4月9日在深圳会展中心6号馆举行.那么这个IPFS是什么?和区块链有什么关系?有什么用?又怎么用呢?接下 ...
- 以太坊和IPFS如何存储数据
如何将JSON文件存储在IPFS上,并使用Oraclize访问智能合约中的数据呢? 以太坊是一个成熟的区块链,使开发人员能够创建智能合约,在区块链上执行的程序可以由交易触发.人们经常将区块链称为数据库 ...
- 什么是IPFS?IPFS与区块链有什么关系
1.什么是IPFS? IPFS是Inter Planetary File System(星际文件系统)的缩写,是一个典型的点对点分布式文件系统, 旨在用同一个文件系统连接所有的计算设备.这时候有些小伙 ...
随机推荐
- Android WebView那些坑之上传文件
最近公司项目需要在WebView上调用手机系统相册来上传图片,开发过程中发现在很多机器上无法正常唤起系统相册来选择图片. 解决问题之前我们先来说说WebView上传文件的逻辑:当我们在Web页面上点击 ...
- python基础二（基础数据类型）
一. 引子 1. 什么是数据 x=10,10是我们要存储的数据 2. 为何数据要分不同的类型 数据是用来表示状态的,不同的状态就应该用不同的类型的数据去表示 3.数据类型 数字 字符串 列表 元组 字 ...
- python/匿名函数和内置函数
1 匿名函数 匿名函数是lambda定义的没有名字的具有一些小功能的函数 具体形式是 lambda 参数列表:返回值表达式 lambda x: X**2 # 求平方操作 lambda x: x> ...
- 1.6 dropout正则化
除了L2正则化,还有一个非常实用的正则化方法----dropout(随机失活),下面介绍其工作原理. 假设你在训练下图左边的这样的神经网络,它存在过拟合情况,这就是dropout所要处理的.我们复制这 ...
- Flume报 Space for commit to queue couldn't be acquired. Sinks are likely not keeping up with sources, or the buffer size is too tight
报这个错误 需要一个是flume堆内存不够.还有一个就是把channel的容器调大 在channel加配置 type - 组件类型名称必须是memory capacity 100 存储在 Channe ...
- 学习React系列（十）——Render Props
解决问题:将行为封装,供多个组件使用(在多个组件之间分享某段代码) 组件中的props属性中包含一个"render"属性(该属性为一个返回值为元素的方法),然后在该组件的rende ...
- 用ECMAScript4 ( ActionScript3) 实现Unity的热更新 -- 在脚本中使用MonoBehaviour
继上次分析了热更新的Demo后,这次来介绍如何在热更新代码中使用MonoBehaviour. MonoBehaviour挂载到GameObject对象上的脚本的基类.平常Unity开发时,简单的做法就 ...
- 《C++ Primer》学习笔记：3.3.3其他vector操作
<C++ Primer>(第五版)中计算vector对象中的索引这一小节中,举例要求计算各个分数段各有多少个成绩. 代码如下: #include <iostream> #inc ...
- [HNOI 2001]求正整数
Description 对于任意输入的正整数n,请编程求出具有n个不同因子的最小正整数m.例如:n=4,则m=6,因为6有4个不同整数因子1,2,3,6:而且是最小的有4个因子的整数. Input n ...
- [Sdoi2009]Elaxia的路线
Description 最近,Elaxia和w**的关系特别好,他们很想整天在一起,但是大学的学习太紧张了,他们 必须合理地安排两个人在一起的时间.Elaxia和w**每天都要奔波于宿舍和实验室之间, ...