今天也根据官网的文档开始一步步搭建ipfs运行环境,我们先来看一下IPFS的简介:
IPFS(InterPlanetary File System)是一个点对点的分布式超媒体分发协议,它整合了过去几年最好的分布式系统思路,为所有人提供全球统一的可寻址空间,包括Git、自证明文件系统SFS、BitTorrent和DHT,同时也被认为是最有可能取代HTTP的新一代互联网协议。
IPFS用基于内容的寻址替代传统的基于域名的寻址,用户不需要关心服务器的位置,不用考虑文件存储的名字和路径。我们将一个文件放到IPFS节点中,将会得到基于其内容计算出的唯一加密哈希值。哈希值直接反映文件的内容,哪怕只修改1比特,哈希值也会完全不同。当IPFS被请求一个文件哈希时,它会使用一个分布式哈希表找到文件所在的节点,取回文件并验证文件数据。
IPFS是通用目的的基础架构,基本没有存储上的限制。大文件会被切分成小的分块,下载的时候可以从多个服务器同时获取。IPFS的网络是不固定的、细粒度的、分布式的网络,可以很好的适应内容分发网络的要求。这样的设计可以很好的共享各类数据,包括图像、视频流、分布式数据库、整个操作系统、模块链、8英寸软盘的备份,还有静态网站。
1、下载IPFS
打开官网https://ipfs.io/ ,点击【Try it】
点击 【Install IPFS now】
点击【Download go-ipfs】, 下载对应版本的IPFS安装文件
下载完之后,将文件解压到你想要存放的目录,如:E:\Workplace\BlockChain\go-ipfs
2、安装IPFS
打开CMD,进入ipfs文件目录
E:
cd E:\Workplace\BlockChain\go-ipfs
输入 dir 查看目录信息,然后输入ipfs init 开始初始化 ipfs网络环境,并且系统会分配一个属于你自己的IPFS网络哈希值(类似你在IPFS网络中的一张身份证ID)。有了这个ID,别人就可以访问到你的节点
~>dir // 查看目录信息
~>ipfs init // 初始化 ipfs网络环境
输入上面获取的内容 ipfs cat /ipfs/QmS4ustL54uo8FzR9455qaxZwuMiUhyvMcX9Ba8nUH4uVv/readme
,
出现 Hello and Welcome to IPFS!
那恭喜你!说明你的电脑已经成功安装IPFS并已经加入到IPFS网络了。
3、IPFS环境配置
IPFS安装的默认配置将存放到你的用户文件夹根目录下(C:\Users\abc\.ipfs)文件夹名.ipfs,接下来打开config,里面的是ipfs的一些基础配置数据,可以根据自己的需求修改里面的配置
配置修改请参考官网文档
4、运行测试
输入 ipfs daemon
启动IPFS服务监听,目的是用于监听IPFS网络通信数据,使用的监听端口是5001。注意要并保持开启状态,才能守护监听的进程
另开一个cmd,同样进入ipfs目录,试着执行一些基础命令
输入 ipfs help
,获取一些常用的命令
输入 ipfs id
,可以查看你的通信ID信息
查看配置信息
输入 ipfs swarm peers
可以查看附近也在使用IPFS网络节点伙伴,如果列出有数据说明你并不是一个人在使用IPFS网络
5、尝试调用一个ipfs网络中的文件:
打开官网点击 右上角 Docs -> 选择目录 Getting Started
找到Going online,复制代码 ipfs cat /ipfs/QmW2WQi7j6c7UgJTarActp7tDNikE4B2qXtFCfLPdsgaTQ/cat.jpg >cat.jpg
粘贴到CMD,回车确认即可获得ipfs网络的的一个猫的图片资源,也说明我们的ipfs环境可以访问网络中的文件了。
6、可视化界面
IPFS网络状态保持开启,此时浏览器输入http://localhost:5001/webui 你可以看到一个漂亮的可视化IPFS管理界面,里面可以做一些基础的资源获取查看操作
7、上传一个文件以及在ipfs获取自己上传的文件
将自己的文件放在ipfs配置目录(E:\Workplace\BlockChain\go-ipfs),如我的test.txt这个文档
执行命令 ipfs add test.txt
,显示如下,说明我的文件已经加入了我的ipfs网络节点中,并且生成了一个test.txt这个文件的唯一哈希值 QmPAUBJmKa1KTeSo7qn4q2N9DT3yhBxPWf1ELHku3nMbci
,
输入命令 ipfs cat QmPAUBJmKa1KTeSo7qn4q2N9DT3yhBxPWf1ELHku3nMbci
获得文件信息
此时我们可以通过上面返回的文件哈希值 QmPAUBJmKa1KTeSo7qn4q2N9DT3yhBxPWf1ELHku3nMbci
,
获取我们上传的文件,在刚才的可视化界面把哈希值粘贴到搜索栏即可得到我们上传的文件信息
注意:我们刚才的文件获取操作都是只在我们本机内网建立的ipfs环境中,我们尝试使用https://ipfs.io/ipfs/QmPAUBJmKa1KTeSo7qn4q2N9DT3yhBxPWf1ELHku3nMbci
查看信息,出现没有找到资源的提示,说明我们上传的文件还没有同步到ipfs外网,所以访问不了。
接下来执行下面的命令同步节点数据到IPFS网络:
先把刚在运行的 ipfs daemon
服务停止(Ctrl + c),然后重新启动 ipfs daemon
再次在浏览器访问,可以看到我们上传的文件,说明我们现在已经成功把文件上传到ipfs网络节点了。
8、发布到PNS,创建简易的网页发布到IPFS
在这里我先自己写一个简单的网页给大家演示,先在桌面新建一个site
文件夹,然后按照下面的步骤在site
文件夹中建立index.html
和style.css
文件。
8.1 创建一个index.html文件
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Hello IPFS!</title>
<link rel="stylesheet" href="./style.css" />
</head>
<body>
<h1>Hello IPFS!</h1>
</body>
</html>
8.2 创建一个style.css文件
h1 {
color: green;
}
8.3 添加到ipfs
> ipfs add -r site/
added QmS4a85WLxie6Zy6Tntg6CccyGHyV4823Vo1vkjGBYhetP site/index.html
added QmZL2UBTwnhcLv66fARL9UV8W8a9ZA4iwTLcaUCsB1u1yW site/style.css
added QmPAygbESghBjPbLhGJAda5rA9GCBMHMGfgwLoB61DfnxX site
最后一行是项目根目录的hash
,你先通过ipfs daemon
同步网络,然后可以通过https://ipfs.io/ipfs/<你的项目根目录hash>
,即https://ipfs.io/ipfs/QmPAygbESghBjPbLhGJAda5rA9GCBMHMGfgwLoB61DfnxX
访问项目。
8.4 访问网站
浏览器打开https://ipfs.io/ipfs/QmPAygbESghBjPbLhGJAda5rA9GCBMHMGfgwLoB61DfnxX,效果图如下:
]
8.5 发布到IPNS
当我们修改网站内容重新添加到ipfs
时,hash
会发生变化,当我们网站更新时,我们可以将网站发布到IPNS
,在IPNS
中,允许我们节点的域名空间中引用一个IPFS hash
,也就是说我们可以通过节点ID
对项目根目录的IPFS HASH
进行绑定,以后我们访问网站时直接通过节点·ID
访问即可,当我们更新网站时,重新发布到IPNS
即可。
> ipfs name publish QmPAygbESghBjPbLhGJAda5rA9GCBMHMGfgwLoB61DfnxX
Published to QmVhF9zg4qcrVTw8jkkCGvTJGXJjvwX6CvRuxzUErEyx97: /ipfs/QmPAygbESghBjPbLhGJAda5rA9GCBMHMGfgwLoB61DfnxX
当我们执行ipfs name publish
命令时,会返回我们的节点ID
,你可以通过ipfs id
进行查看验证是否是你的节点ID
。
验证id:
> ipfs id
{
"ID": "QmVhF9zg4qcrVTw8jkkCGvTJGXJjvwX6CvRuxzUErEyx97",
"PublicKey": "CAASpgIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC6fMRFRKKg7rn7fJVVENsmSp/qftAV0FApEEFi0LNJOW9oYENCNykCc6Vpwg0/9oXjfkywAJqENgEycUV1ZdK75Ef9NJlY5vy62e2aitF83ock89zAeXXLU4GhXifW/foT5DsHHSe0rseBmybZDHjAOJtfhaN4K4yusw23wzvt9Fg8S3qNszEaImYtWUlS08piiR0tWdz+24I/oWiSnWB855KVCdLnYnwy6M3OLgeuJvXB2XGwnbtj4Q1jvp9rf/KGjHtb0KB9DwfowZ/ypvrDUNakbjNGYfn3I+AvRl1Qz4++o57VtbRmZYThygWnz9vTjqj0NDX2ftYh6MrZkSg5AgMBAAE=",
"Addresses": [
"/ip4/127.0.0.1/tcp/4001/ipfs/QmVhF9zg4qcrVTw8jkkCGvTJGXJjvwX6CvRuxzUErEyx97",
"/ip4/192.168.0.4/tcp/4001/ipfs/QmVhF9zg4qcrVTw8jkkCGvTJGXJjvwX6CvRuxzUErEyx97",
"/ip4/169.254.187.113/tcp/4001/ipfs/QmVhF9zg4qcrVTw8jkkCGvTJGXJjvwX6CvRuxzUErEyx97",
"/ip6/::1/tcp/4001/ipfs/QmVhF9zg4qcrVTw8jkkCGvTJGXJjvwX6CvRuxzUErEyx97",
"/ip4/182.139.92.248/tcp/32065/ipfs/QmVhF9zg4qcrVTw8jkkCGvTJGXJjvwX6CvRuxzUErEyx97"
],
"AgentVersion": "go-ipfs/0.4.14/",
"ProtocolVersion": "ipfs/0.1.0"
}
验证id绑定的网站hash:
> ipfs name resolve <peerId>
> ipfs name resolve QmVhF9zg4qcrVTw8jkkCGvTJGXJjvwX6CvRuxzUErEyx97
/ipfs/QmPAygbESghBjPbLhGJAda5rA9GCBMHMGfgwLoB61DfnxX
我们现在就可以根据节点id
,通过IPNS
进行访问了:
https://ipfs.io/ipns/QmVhF9zg4qcrVTw8jkkCGvTJGXJjvwX6CvRuxzUErEyx97
注意上面是ipns而不是ipfs。
8.6 修改网站内容,重新发布到IPNS
现在去style.css中修改字体颜色:
h1 {
color: red;
}
重新添加site
文件夹到ipfs
:
> ipfs add -r site/
added QmS4a85WLxie6Zy6Tntg6CccyGHyV4823Vo1vkjGBYhetP site/index.html
added QmUTwP64HnrQp3GJuVeuvwaQ79rxa8waQL5yj3qkCswqvk site/style.css
added QmWhEUU1ksDShPTqhPEEXohfnhBvpwaCHtxhnbf3Fi1piH site
可以看到除了index.html
文件的hash
值没变外,style.css
和site
文件夹的hash
值都不是之前的hash
值了。
浏览器打开https://ipfs.io/ipfs/QmWhEUU1ksDShPTqhPEEXohfnhBvpwaCHtxhnbf3Fi1piH,效果图如下:
重新发布到IPNS:
> ipfs name publish QmWhEUU1ksDShPTqhPEEXohfnhBvpwaCHtxhnbf3Fi1piH
Published to QmVhF9zg4qcrVTw8jkkCGvTJGXJjvwX6CvRuxzUErEyx97: /ipfs/QmWhEUU1ksDShPTqhPEEXohfnhBvpwaCHtxhnbf3Fi1piH
再次根据节点id
,通过IPNS
进行访问:
https://ipfs.io/ipns/QmVhF9zg4qcrVTw8jkkCGvTJGXJjvwX6CvRuxzUErEyx97
可以看到,由于网站的内容发生了变化,对应的hash
值也发生了变化,这会导致其他人通过旧的网站hash
值,访问不到更新后的网站。而使用IPNS
,将每次更新后的网站hash
值绑定到我们的节点id
,他人只需要记住你的节点id
,通过IPNS,就可以一直访问最新的网站内容。
以上简介的IPFS的环境搭建和基础的几个命令操作
参考文章
https://www.jianshu.com/p/9e7fb59d2bb5
https://steemit.com/ipfs/@daxiang/ipfs-windows