IPFS开发简介与入门实战

赤膊医数

2018年，最火爆且值得期待的区块链项目莫过于EOS和IPFS。1、IPFS简介

• IPFS是什么
  星际文件系统IPFS（InterPlanetary File System）是一个面向全球的、点对点的分布式版本文件系统，目标是为了补充（甚至是取代）目前统治互联网的超文本传输协议（HTTP），将所有具有相同文件系统的计算设备连接在一起。原理用基于内容的地址替代基于域名的地址，也就是用户寻找的不是某个地址而是储存在某个地方的内容，不需要验证发送者的身份，而只需要验证内容的哈希，通过这样可以让网页的速度更快、更安全、更健壮、更持久。
  * {6 @$ w) t( c2 p7 b0 }7 j8 {7 ?以上内容来自巴比特官网介绍
  IPFS是基于区块链技术的去中心化存储网络，实现了永久性存储。
  
• IPFS的火热
  ' }% v; ^! f5 R6 e. M' CFilecoin ICO是迄今为止涉及金额最大的ICO，仅一小时就募集了接近2亿美元，打破ICO记录，成为2017年最火爆的区块链项目。IPFS项目吸引了世界各地数字货币投资者和互联网从业者的密切关注，2018年比较值得期待的是IPFS主网的上线。然而就在前段时间，官方公布说上线时间延期到年底。
  注：Filecoin是IPFS激励层的加密数字货币（即代币），有点类似于以太坊平台上的以太币。
  IPFS官网：https://ipfs.io/
  ! ~2 m4 m& k  m: ^9 _6 d1 dFilecoin官网：https://filecoin.io/
  6 I: P0 [, Q1 P1 U' J! Q. n! F1 k
• IPFS的应用案例
  ; V% B! I8 b5 p1 D8 n& u) C+ VGitHub有两款开源项目，且有对应网址，分别是音乐播放器和视频播放器。
  4 R+ i% i( U+ F
  + q5 k. L8 K" |/ k* g% E
  • IPFS音乐播放器
    5 |2 H( X$ ^% G
    7 P1 _: M. `$ |9 M
    # c9 H; U  }6 A+ a; J, E0 o
    7 r' N( J3 ]3 U2 y  t0 m% y
    IPFS音乐播放器
    " g& Q. t6 t' Z" Z* P2 _. o
    IPFS音乐播放器网址：https://diffuse.sh/
    , ~. \+ w* a, M4 z; G0 J6 k# ?GitHub地址：https://github.com/icidasset/diffuse
    & }7 \5 I! a$ d+ v+ k
  • IPFS视频在线播放器
    
    
    ' E6 y# A( M  J  U- o* e
    
    6 \/ |( a, y2 m0 R. SIPFS视频在线播放器首页
    
    
    
  
  8 u, \8 T- H2 b, B, V! ~) i% T
  1 T2 O2 H7 @: M% r( R+ t
  2 Y$ c4 p. q# {$ V; r: q  YIPFS视频在线播放器播放电影
  # p. U2 E/ B1 l$ {8 G
  4 Y$ w' k7 k% w7 U4 D号称是国内第一个IPFS应用
  IPFS视频在线播放器网址：http://www.ipfs.guide/
  GitHub地址：https://github.com/download13/ipfstube
  0 a8 k5 Q$ W5 I+ m' B; N4 H( U5 s# X可用于测试的电影视频Hash（这里只列举两部）：
  + m! L- n0 k0 J( W% B' d9 |: D: t神秘巨星：QmWBbKvLhVnkryKG6F5YdkcnoVahwD7Qi3CeJeZgM6Tq68
  盗梦空间：QmQATmpxXvSiQgt9c9idz9k3S3gQnh7wYj4DbdMQ9VGyLh
  

2、IPFS的安装既然IPFS这么牛，有必要了解一下IPFS的开发，先从IPFS的安装开始。
" R6 a- U$ k. u( b2 Q

• IPFS Desktop
  当然，可以直接安装IPFS节点桌面管理软件来体验一下。该软件可以方便地运行和管理自己的节点，查看IPFS节点资源信息，支持二次开发。该项目是Node.js编写的，已开源。
  / K+ K  z' Y$ _; ?; U3 F
  
  
  - r1 s/ M! n. _3 d" Y1 r, @
  IPFS节点桌面管理软件
  
  GitHub地址：
  $ P7 |$ M: _9 Y. j( s& x. |* x4 l+ Ihttps://github.com/ipfs-shipyard/ipfs-desktop
  ) ~; S" Q  T  q2 ^1 ?
• Go-IPFS
  & |" l( L+ q5 t0 ]' b+ W' V进入IPFS的官网，找到并切换到"Install"页面，点击"Download IPFS for your platform"，会跳转到如下网址（需要翻墙）：
  . U5 B- D9 T5 }/ Hhttps://dist.ipfs.io/#go-ipfs
  
  7 Y6 V  C2 c8 u/ Z% {8 A
  - r1 F+ s8 n( x! `( r* J
  + [& ]$ ]  K: y6 a下载Go-IPFS
  9 S* V$ D: s% s7 Z% p- c
  ) b5 s& g3 m$ }: T- Y& t如果打不开，可以试着去Github查看安装方法
  5 n! ^( G$ `8 n/ V: R9 QGitHub地址：https://github.com/ipfs/go-ipfs
  ; u, r- }% m, R' t# g1 M: A将网页下载好的文件解压出来，下载的是"go-ipfs_v0.4.13_darwin-amd64.tar.gz"，解压出来的是go-ipfs文件夹，
  然后打开终端，进入到go-ipfs文件夹根目录，复制ipfs文件到系统的bin目录，然后可以通过"ipfs version"来检查，操作如下：
  : B7 Q! e6 Y$ V" PwenzildeiMac:go-ipfs wenzil$ pwd/Users/wenzil/Desktop/study/go-ipfswenzildeiMac:go-ipfs wenzil$ lsLICENSE     README.md   build-log   install.sh  ipfswenzildeiMac:go-ipfs wenzil$ cp ipfs /usr/local/bin/ipfswenzildeiMac:go-ipfs wenzil$ ipfs versionipfs version 0.4.13
  0 b1 U9 C  j. v& {1 j

3、IPFS节点的创建、查看和启动以下是安装官网的Go-IPFS步骤下实验的

• 创建节点
  6 h$ ~0 A. Z7 A进入到当前用户的根目录，并使用"ipfs init"命令创建节点，可以用"open ./"打开创建节点生成的".ipfs"目录。
  * d! K9 H8 d# ^. \0 L3 ?% r1 {wenzildeiMac:go-ipfs wenzil$ cd ~/wenzildeiMac:~ wenzil$ pwd/Users/wenzilwenzildeiMac:~ wenzil$ ipfs initinitializing IPFS node at /Users/wenzil/.ipfsgenerating 2048-bit RSA keypair...donepeer identity: QmWH4xmGBznY9CJ4SjxpxWqGwMwrFtPdjgeweLCfJxW8j9to get started, enter:    ipfs cat /ipfs/QmS4ustL54uo8FzR9455qaxZwuMiUhyvMcX9Ba8nUH4uVv/readmewenzildeiMac:~ wenzil$ cd .ipfswenzildeiMac:.ipfs wenzil$ open ./
  

9 A; Q- S3 P' k" A' E1 |2 {" X- dIPFS节点的创建
( i% R; w! b1 Y, L+ u

• 查看节点id
  2 I  s" T0 V  nwenzildeiMac:.ipfs wenzil$ ipfs id{    "ID": "QmWH4xmGBznY9CJ4SjxpxWqGwMwrFtPdjgeweLCfJxW8j9",    "PublicKey": "CAASpgIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCt98O5zNptBtmSF6xYdOHAMunQsXE9rAmgqBXVPLJk+AoaBjNiAipB+sTXKwaj8stp9c3iuSzz10+dyYI38bq4TPDCsHnQ3PjKSgZwEaT0M6pJhGqJcSbLY57CjQOEwgFe+tw3b4hcoDvvNJMG0dZZg1r9xnfevBz0DNewlj2vtviSTQL6r/ZXlD04GsytxTSQ2pzMJTG3QmYyokeZ37DT7Vwa+IJjDCiDJC5BlZ204zunZBx3tqWUn2Hr2NtEX+4YDdX4SBHa0ZDNqZmzLRe5YlAXjVI0ONHs+BVsC1v1L5we52iSYCSgVHoxRP/pa9EZdHMvgs9QeAa5jO90yxgTAgMBAAE=",    "Addresses": null,    "AgentVersion": "go-ipfs/0.4.13/",    "ProtocolVersion": "ipfs/0.1.0"}
• 修改IPFS默认存储空间
  4 K0 b% V5 s/ Q% k6 ^存储节点默认存储大小为10G，如果你想修改存储空间，可以修改config配置文件，找到StorageMax并修改
  wenzildeiMac:~ wenzil$ export EDITOR=/usr/bin/vimwenzildeiMac:~ wenzil$ ipfs config edit  
  ' u! x9 W" P0 z; c6 t" c. [; F0 X
  
  , v+ s$ ]4 r. i9 Q5 u7 ^修改IPFS默认存储空间
  
  
• 启动和同步节点服务器
  ) ^! g9 g5 Q' |/ Q& Z' G执行"ipfs daemon"命令，可以同步节点数据到IPFS网络。
  wenzildeiMac:.ipfs wenzil$ ipfs daemonInitializing daemon...Adjusting current ulimit to 2048...Successfully raised file descriptor limit to 2048.Swarm listening on /ip4/127.0.0.1/tcp/4001Swarm listening on /ip4/192.168.1.100/tcp/4001Swarm listening on /ip6/::1/tcp/4001Swarm listening on /p2p-circuit/ipfs/QmWH4xmGBznY9CJ4SjxpxWqGwMwrFtPdjgeweLCfJxW8j9Swarm announcing /ip4/100.64.9.179/tcp/55898Swarm announcing /ip4/127.0.0.1/tcp/4001Swarm announcing /ip4/192.168.1.100/tcp/4001Swarm announcing /ip6/::1/tcp/4001API server listening on /ip4/127.0.0.1/tcp/5001Gateway (readonly) server listening on /ip4/127.0.0.1/tcp/8082Daemon is ready
  2 q, n) g7 |/ }* _6 u; ^. y( O6 q

4、IPFS运行体验

• IPFS查看ReadMe
  1 G' O2 e1 y0 g- p! }( [: ^; H可以回去查看执行"ipfs init"命令的时候，返回的内容。打开一个新的终端，操作如下：
  wenzildeiMac:~ wenzil$ ipfs cat /ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG/readmeHello and Welcome to IPFS!██╗██████╗ ███████╗███████╗██║██╔══██╗██╔════╝██╔════╝██║██████╔╝█████╗  ███████╗██║██╔═══╝ ██╔══╝  ╚════██║██║██║     ██║     ███████║╚═╝╚═╝     ╚═╝     ╚══════╝If you're seeing this, you have successfully installedIPFS and are now interfacing with the ipfs merkledag! -------------------------------------------------------| Warning:                                              ||   This is alpha software. Use at your own discretion! ||   Much is missing or lacking polish. There are bugs.  ||   Not yet secure. Read the security notes for more.   | -------------------------------------------------------Check out some of the other files in this directory:  ./about  ./help  ./quick-start     <-- usage examples  ./readme          <-- this file  ./security-notes
• Web管理界面
  IPFS节点服务器启动后，可以用浏览器访问：http://localhost:5001/webui
  3 y9 a# ?1 w( e& U+ B$ b4 P有本地配置、节点连接、本地节点文件等信息，如图：
  
  ) p; w* C' K# C$ G( e& y
  # x6 a: a  I  O- c; u
  
  IPFS的Web管理界面
  
  ) e+ d3 u7 M: m9 q# i* T
  , ~; R" A0 q6 ?2 e7 J- l
  

5、设置跨域资源共享当我们在前端通过js接口操作ipfs时，会遇到跨域资源访问问题，可以在终端执行以下配置来解决：
( y! u+ y! V7 K. L$ q) Bipfs config --json API.HTTPHeaders.Access-Control-Allow-Methods '["PUT","GET", "POST", "OPTIONS"]'ipfs config --json API.HTTPHeaders.Access-Control-Allow-Origin '["*"]'ipfs config --json API.HTTPHeaders.Access-Control-Allow-Credentials '["true"]'ipfs config --json API.HTTPHeaders.Access-Control-Allow-Headers '["Authorization"]'ipfs config --json API.HTTPHeaders.Access-Control-Expose-Headers '["Location"]'6、IPFS的基本操作6.1 添加单个文件到IPFS节点

• 新建文件
  9 _/ Z% @8 b0 Q$ a" H2 cwenzildeiMac:ifps_test wenzil$ vi test.txtwenzildeiMac:ifps_test wenzil$ cat test.txt IPFS测试文件
• 添加文件到IPFS节点
  9 b; R8 \$ I7 S. c; TwenzildeiMac:ifps_test wenzil$ ipfs add test.txt added QmSVKEwPBTzw5QLzGUE8oN8J1r4cadMeieSw4Co1ozm2Ab test.txt添加文件到IPFS节点后，返回了文件的哈希值
  
• 查看IPFS节点的文件
  % `  d  Y. V  O/ E2 [wenzildeiMac:ifps_test wenzil$ ipfs cat QmSVKEwPBTzw5QLzGUE8oN8J1r4cadMeieSw4Co1ozm2AbIPFS测试文件注意：此时的文件只是添加到了本地的IPFS节点，读取的是本地数据，可以通过如下网址查看。
  5 P1 i+ @7 W- }- h9 J8 J/ x9 Ihttp://localhost:8080/ipfs/QmSVKEwPBTzw5QLzGUE8oN8J1r4cadMeieSw4Co1ozm2Ab
  0 R1 Y9 O% D1 Z0 A通过"ipfs daemon"命令启动节点服务器，会将本地节点文件同步到外网，同步成功后，这时就可以访问如下网址来查看（如果访问失败，试着翻墙看看）。
  https://ipfs.io/ipfs/QmSVKEwPBTzw5QLzGUE8oN8J1r4cadMeieSw4Co1ozm2Ab
  ) b- M' s/ _/ u1 j8 _# S6 b
  2 s2 I5 B1 R& z4 m3 g. i* e+ n
  , ]7 R* a9 W* E6 r$ o
  . h  M1 n$ u3 n( S! ~查看IPFS文件内容
  
  1 @$ {5 ^- Z8 R- p- F如果访问成功的话，说明已经存储到IPFS网络中。目前IPFS网络暂未加入代币Filecoin机制，所以存储读取文件免费，速度也比较慢。
  0 c. s/ P( c) X  L4 a
• 下载IPFS节点的文件
    s7 Y' G+ ~; f2 E3 g8 M2 p6 FwenzildeiMac:ifps_test wenzil$ ipfs get QmSVKEwPBTzw5QLzGUE8oN8J1r4cadMeieSw4Co1ozm2AbSaving file(s) to QmSVKEwPBTzw5QLzGUE8oN8J1r4cadMeieSw4Co1ozm2Ab 25 B / 25 B [========================================================] 100.00% 0s查看当前目录，发现多了一个"QmSV..."的文件"
  
  1 ~  m) k  J; L4 T# d4 O$ N; z
  
  0 r- o$ }8 P' D; u# W$ m3 t
  下载IPFS节点的文件
  , s! Y* Z: V/ e
  ; [$ P) ]. T$ E7 p0 I
  2 P1 G5 |0 A5 ~4 `% ?! f

6.2 创建文件夹存储文件

• ipfs命令新建文件夹
    e( m1 n, y# N! V) dwenzildeiMac:ipfs_test wenzil$ pwd/Users/wenzil/Desktop/study/ipfs_testwenzildeiMac:ipfs_test wenzil$ ipfs files mkdir /wenzilwenzildeiMac:ipfs_test wenzil$ ipfs files cp /ipfs/QmSVKEwPBTzw5QLzGUE8oN8J1r4cadMeieSw4Co1ozm2Ab /wenzil/test.txtwenzildeiMac:ipfs_test wenzil$ ipfs files lstestwenzilwenzildeiMac:ipfs_test wenzil$ ipfs files ls /testwenzilwenzildeiMac:ipfs_test wenzil$ ipfs files rm -rf /testwenzildeiMac:ipfs_test wenzil$ ipfs files lswenzilwenzildeiMac:ipfs_test wenzil$ ipfs files ls /wenziltest.txtwenzildeiMac:ipfs_test wenzil$ ipfs files read /wenzil/test.txtIPFS测试文件注："ipfs files rm -rf /文件夹名"可以删除文件夹。
  # l$ a7 Y2 f% ]& t2 \
  

6.3 IPFS上传文件夹

• ipfs命令添加文件夹
  % [. \3 X: p6 \先在本地创建一个文件夹和对应文件，如图：
  8 ~/ d4 w# @$ K% r9 S! J
  9 r! o) M( q2 t% U
  5 N7 e* w: S# b, p+ @9 q
  : h2 f' {3 M$ H$ N, W1 e
  2 t# n. s" Z& z本地创建文件夹及文件
  
  5 [& q( c/ M5 o4 W# m然后通过"ipfs add -r 文件夹"命令添加整个文件夹
  wenzildeiMac:ipfs_folder wenzil$ pwd /Users/wenzil/Desktop/study/ipfs_folder wenzildeiMac:ipfs_folder wenzil$ ls portrait.jpeg   readme.txt wenzildeiMac:ipfs_folder wenzil$ cd .. wenzildeiMac:study wenzil$ pwd /Users/wenzil/Desktop/study wenzildeiMac:study wenzil$ ipfs add -r ipfs_folder/ added   QmbHptfJfyuGAZxstFYgAVfz33cytR1seTD3ZabBSDd899     ipfs_folder/portrait.jpeg added   QmPEWgwQEHD6qxm5cUivTEZ252T123DvQ5L6HyUDgViQv  T ipfs_folder/readme.txt added   QmdSd3xxKcwuMugyLCiLWzaeZKDkuM39R2tzyF3kBFDoaj   ipfs_folder wenzildeiMac:study wenzil$
• 查看文件夹的文件内容
  wenzildeiMac:study wenzil$ ipfs cat QmPEWgwQEHD6qxm5cUivTEZ252T123DvQ5L6HyUDgViQvT 我是区块链开发小白，请大家多多赐教，谢谢。欢迎阅读我的区块链系列文章，简书地址：https://www.jianshu.com/u/5f809ab3698cwenzildeiMac:study wenzil$ ipfs cat /ipfs/QmPEWgwQEHD6qxm5cUivTEZ252T123DvQ5L6HyUDgViQvT我是区块链开发小白，请大家多多赐教，谢谢。欢迎阅读我的区块链系列文章，简书地址：https://www.jianshu.com/u/5f809ab3698cwenzildeiMac:study wenzil$ ipfs cat /ipfs/QmdSd3xxKcwuMugyLCiLWzaeZKDkuM39R2tzyF3kBFDoaj/readme.txt我是区块链开发小白，请大家多多赐教，谢谢。欢迎阅读我的区块链系列文章，简书地址：https://www.jianshu.com/u/5f809ab3698c
• 查看IPFS对应文件夹
  访问文件夹对应的IPFS地址：
  6 }5 Q- z0 Q9 t. n1 F/ s( V$ I% mhttps://ipfs.io/ipfs/QmdSd3xxKcwuMugyLCiLWzaeZKDkuM39R2tzyF3kBFDoaj
  ' y. ]. l) l3 i8 i9 p8 \第一次访问的时候，需要同步数据到IPFS网络，等待时间有点久，慢到让你以为同步失败了。
  + C; _0 U7 {8 o, u! l
  # O0 r3 b$ Y. K8 {4 G; p7 `+ ~
  
  0 |0 `& Z/ t: [; u/ ^& S查看IPFS对应文件夹
    R& T: |, Y; g4 ^' b2 L* `
  访问文件夹对应的文件，如看到图片文件，访问ipfs网关：
  https://ipfs.io/ipfs/QmdSd3xxKcwuMugyLCiLWzaeZKDkuM39R2tzyF3kBFDoaj/portrait.jpeg
  4 G# S4 y5 v3 X% ?. Y
  $ O9 V' E3 R6 W9 S
  & m* i/ Z5 w- G2 _2 x; S6 u
  ) m$ ^: v  L6 r+ D# }6 h查看IPFS文件夹对应文件
  
  : f# Y( u: |1 G或者通过文件的Hash来访问，如访问txt文件的地址：
  1 \' C3 ]4 f. C. f/ rhttps://ipfs.io/ipfs/QmPEWgwQEHD6qxm5cUivTEZ252T123DvQ5L6HyUDgViQvT
  , R# v; k0 F! u" e1 o; T
  
  # t5 q  r8 `! R. \
  1 Y* n5 @- f% ^8 O, G通过文件Hash访问查看
  
  7 f7 [+ M0 ~$ T: ?  h" J" I
  

6.4 添加简单网页到IPFS节点

• 网页效果和项目结构
  实现一个简单的实时显示系统当前时间的网页，效果如图：
  
  ) J: V/ F% a& ?" D7 L( P
  : B/ f2 i, {( L. l$ @' B; h
  : ~, ~8 q: G$ L9 c3 p
  5 K" @* X' _7 T/ X, tIPFS添加简单网页
  & x$ n2 [+ F& Q# M% Y
  2 L" S7 ?$ E( o, c/ h& @2 f, @! n工程结构如图:
  
  
  
  # c( M( ?- u8 C
  网页工程结构
  1 q; l5 @9 s" i7 U) y, [" d
  . x  G+ v- p# g4 O4 [3 r- e% X4 L* Z3 w
  " G# V% E4 q" j8 |) \4 ~& i- |

实现代码比较简单，这里就不贴代码了。

• ipfs命令添加文件夹
  / D7 ~: A1 |4 y9 c2 _2 h; RwenzildeiMac:study wenzil$ ipfs add -r ipfs_htmladded QmTj49dgFgFhfNRTUYyUSzk3puj7vvDoVsAynFrL7GAj1d ipfs_html/index.htmladded QmeHFBSyN9KqeZWKyKTWKYzDRU192YWDRjf6sLWFWhwk2z ipfs_html/styles.cssadded QmWkEfgL2pjo7n8b9YBCv4qwE77YWePkSscxiHQfPpwpkp ipfs_html/time.jsadded QmeG6LKmEfF5s62cySE9ZnU8EifmU46CQTixipfzsZspDD ipfs_html记得要开启IPFS节点服务器进行数据的同步，可以使用"ipfs daemon"命令在新的终端窗口打开运行。
  7 O# Y3 D2 V; Q. V3 ~wenzildeiMac:~ wenzil$ ipfs daemonInitializing daemon...Adjusting current ulimit to 2048...Successfully raised file descriptor limit to 2048.Swarm listening on /ip4/127.0.0.1/tcp/4001Swarm listening on /ip4/192.168.6.31/tcp/4001Swarm listening on /ip6/::1/tcp/4001Swarm listening on /p2p-circuit/ipfs/QmcXWJqPjCgr1wrReWu2zUT41E5FrrXp2uyyNZRr7jXXrzSwarm announcing /ip4/127.0.0.1/tcp/4001Swarm announcing /ip4/192.168.6.31/tcp/4001Swarm announcing /ip6/::1/tcp/4001API server listening on /ip4/127.0.0.1/tcp/5001Gateway (readonly) server listening on /ip4/127.0.0.1/tcp/8082Daemon is ready
• 访问ipfs对应文件
  & z5 i0 R( M& c; I浏览器访问ipfs网关：
  ' Q. H$ P/ T: [3 @5 j3 Phttps://ipfs.io/ipfs/QmeG6LKmEfF5s62cySE9ZnU8EifmU46CQTixipfzsZspDD/
  ; j& T8 k. a! R; u3 D' S
  - ~3 o# J5 U: N$ P$ ^3 x
  
  查看IPFS对应网页
  
  & `! \. [; a9 {  \
  / V- |( [1 f! f  @, l9 _

6.5 IPNS绑定节点名

• IPNS绑定节点操作
  : k2 ^; w3 i8 y0 i每次修改文件内容后，文件的哈希值就会发生变化。对于网站而言，发布后可能还需要做修改，这时需要IPNS绑定节点名。每次更新网站内容后，重新publish一次更新发布到IPNS即可。
  刚才的html根目录的哈希值是QmeG6LKmEfF5s62cySE9ZnU8EifmU46CQTixipfzsZspDD，操作如下：
  wenzildeiMac:study wenzil$ ipfs name publish QmeG6LKmEfF5s62cySE9ZnU8EifmU46CQTixipfzsZspDDPublished to QmcXWJqPjCgr1wrReWu2zUT41E5FrrXp2uyyNZRr7jXXrz: /ipfs/QmeG6LKmEfF5s62cySE9ZnU8EifmU46CQTixipfzsZspDD
• 查看当前节点
  wenzildeiMac:study wenzil$ ipfs id{    "ID": "QmcXWJqPjCgr1wrReWu2zUT41E5FrrXp2uyyNZRr7jXXrz",    "PublicKey": "CAASpg......",    "Addresses": [        "/ip4/127.0.0.1/tcp/4001/ipfs/QmcXWJqPjCgr1wrReWu2zUT41E5FrrXp2uyyNZRr7jXXrz",        "/ip4/192.168.6.31/tcp/4001/ipfs/QmcXWJqPjCgr1wrReWu2zUT41E5FrrXp2uyyNZRr7jXXrz",        "/ip6/::1/tcp/4001/ipfs/QmcXWJqPjCgr1wrReWu2zUT41E5FrrXp2uyyNZRr7jXXrz",        "/ip4/14.xxx.xxx.xxx/tcp/4001/ipfs/QmcXWJqPjCgr1wrReWu2zUT41E5FrrXp2uyyNZRr7jXXrz",        "/ip4/61.xxx.xxx.xxx/tcp/20472/ipfs/QmcXWJqPjCgr1wrReWu2zUT41E5FrrXp2uyyNZRr7jXXrz"    ],    "AgentVersion": "go-ipfs/0.4.13/",    "ProtocolVersion": "ipfs/0.1.0"}    发现"ID"和上面"Published to"返回的节点一致，都是"QmcXWJqPjCgr1wrReWu2zUT41E5FrrXp2uyyNZRr7jXXrz"
  
• 验证节点
  命令为："ipfs name resolve 节点ID“
  wenzildeiMac:study wenzil$ ipfs name resolve QmcXWJqPjCgr1wrReWu2zUT41E5FrrXp2uyyNZRr7jXXrz/ipfs/QmeG6LKmEfF5s62cySE9ZnU8EifmU46CQTixipfzsZspDD
• 访问IPNS对应文件
  4 F1 h; O: y( a4 L. S! G浏览器访问ipfs网关：
  * D4 d* d1 v/ f3 s  ?6 G4 B( `https://ipfs.io/ipns/QmcXWJqPjCgr1wrReWu2zUT41E5FrrXp2uyyNZRr7jXXrz/
  
  

查看IPNS对应网页
( L9 f& e7 ?. Z
7、IPFS与以太坊DApp开发实战

• IPFS与以太坊DApp结合的好处
    J. _' ~2 l* `在以太坊平台上，往区块链写入数据需要花费以太币，调用智能合约执行每一行代码的时候，都需要一定量的gas交易费。区块链存储大数据成本很高，而且不合理。
  可以先将文件存储到IPFS，然后得到文件的Hash存储到以太坊区块链中。读取文件的时候，从以太坊区块链中获取文件的Hash，再通过Hash来读取IPFS网络上的文件。
  4 I. C$ \0 F  o( r0 Q使用官方提供的ipfs-api，可以很方便地在代码中操作节点将数据上传到IPFS，或者通过Hash从IPFS读取数据。
  Truffle框架提供了快速搭建包含以太坊智能合约的React项目，可以通过"truffle unbox react"创建工程，然后安装ipfs-api依赖库。于是，可以在前端方便地调用IPFS的接口来读取、上传文件。
  truffle unbox react官网：
  http://truffleframework.com/boxes/react
  
• IPFS与DApp开发实战
  ' T' K* w, O) l话不多说，开始进入实战开发。
  8 d: K/ ~, y6 ?0 L2 c+ F7.1 安装Truffle unbox react新建一个空目录"ipfs_dapp"，然后执行安装命令
  ( c3 a; [9 \& T# Xtruffle unbox reactwenzildeiMac:ipfs_dapp wenzil$ pwd/Users/wenzil/Desktop/study/ipfs_dappwenzildeiMac:ipfs_dapp wenzil$ truffle unbox reactDownloading...Unpacking...Setting up...Unbox successful. Sweet!  Commands:    Compile:              truffle compile  Migrate:              truffle migrate  Test contracts:       truffle test  Test dapp:            npm test  Run dev server:       npm run start  Build for production: npm run build7.2 安装ipfs-apinpm install --save ipfs-apiwenzildeiMac:ipfs_dapp wenzil$ npm install --save ipfs-apinpm WARN deprecated bignumber.js@6.0.0: Custom ALPHABET bug fixed in v7.0.2react-box@0.1.0 /Users/wenzil/Desktop/study/ipfs_dapp├—┬ ipfs-api@22.0.0 │ ├—— async@2.6.1 │ ├—— big.js@5.1.1 │ ├—┬ bs58@4.0.1 │ │ └—— base-x@3.0.4 # ...... 省略N多行输出7.3 修改智能合约代码修改contracts目录中的"SimpleStorage.sol"，修改后完整代码：
  4 Z# H- O! g" P* tpragma solidity ^0.4.18;contract SimpleStorage {  // 用于存储图片的哈希值  string storedData;  function set(string x) public {    storedData = x;  }  function get() public view returns (string) {    return storedData;  }}    修改"Migrations.sol"
  function Migrations() public { owner = msg.sender;}修改为：constructor() public {    owner = msg.sender;}7.4 编译智能合约truffle compilewenzildeiMac:ipfs_dapp wenzil$ truffle compileCompiling ./contracts/Migrations.sol...Compiling ./contracts/SimpleStorage.sol...Writing artifacts to ./build/contracts7.5 部署智能合约进入remix-ide，复制SimpleStorage.sol代码，然后切换到"Run"菜单，选择"Injected Web3"进行智能合约的部署
    b. S! A2 |  l" C! N3 C
  
  3 A0 Y0 ~/ {7 }2 E" \& {3 o
  & `0 `7 S5 Z3 Z4 M2 w! x7 oRemix-IDE部署智能合约
  7 J9 u5 X2 }) t) o: b/ b8 J4 C& l
  - a% `/ E+ u7 _, Z) q# |
  ' ~7 E& D) Z7 F7 e4 U' w8 C) s
  
  Remix-IDE部署智能合约-确认
  
  . A# `% }) @! _1 f+ {& l然后复制智能合约地址，App.js文件中会用到合约地址为:"0xb177d6cf6916f128c9931e610c63208d9c5a40f3"
  7.5 修改App.js文件import React, {Component} from 'react'import SimpleStorageContract from '../build/contracts/SimpleStorage.json'import getWeb3 from './utils/getWeb3'import './css/oswald.css'import './css/open-sans.css'import './css/pure-min.css'import './App.css'const ipfsAPI = require('ipfs-api');const ipfs = ipfsAPI({  host: 'localhost',  port: '5001',  protocol: 'http'});const contract = require('truffle-contract')const simpleStorage = contract(SimpleStorageContract)let account;// Declaring this for later so we can chain functions on SimpleStorage.let contractInstance;let saveImageToIPFS = (reader) => {    return new Promise(function(resolve, reject) {        const buffer = Buffer.from(reader.result);        ipfs.add(buffer).then((response) => {        console.log(response)        resolve(response[0].hash);     }).catch((err) => {        console.error(err)        reject(err);     })  })}class App extends Component {   constructor(props) {   super(props)   this.state = {       blockChainHash: null,       web3: null,       address: null,       imageHash: null,       isSuccess: false  }}componentWillMount() {    ipfs.swarm.peers(function(err, res) {    if (err) {      console.error(err);    } else {      // var numPeers = res.Peers === null ? 0 :     res.Peers.length;      // console.log("IPFS - connected to " + numPeers + " peers");      console.log(res);    }});getWeb3.then(results => {    this.setState({web3: results.web3})    // Instantiate contract once web3 provided.    this.instantiateContract()  }).catch(() => {    console.log('Error finding web3.')  })}instantiateContract = () => {  simpleStorage.setProvider(this.state.web3.currentProvider);  this.state.web3.eth.getAccounts((error, accounts) => {  account = accounts[0];    simpleStorage.at('0xb177d6cf6916f128c9931e610c63208d9c5a40f3').then((contract) => {    console.log(contract.address);    contractInstance = contract;    this.setState({address: contractInstance.address});    return;  });})}render() {  return (    <div className="App">    <div style={{marginTop:10}}>智能合约地址：</div>    <div>{this.state.address}</div>    <div style={{marginTop:10}}>上传图片到IPFS：</div>    <div>      <label id="file">选择图片</label>      <input type="file" ref="file" id="file" name="file" multiple="multiple"/>    </div>    <button style={{marginTop:10}} onClick={() => {        var file = this.refs.file.files[0];        var reader = new FileReader();        reader.readAsArrayBuffer(file)        reader.onloadend = function(e) {          console.log(reader);          saveImageToIPFS(reader).then((hash) => {            console.log(hash);            this.setState({imageHash: hash})          });      }.bind(this);  }}>开始上传</button>  <div style={{marginTop:10}}>图片哈希值：{this.state.imageHash}</div>  <button onClick={() => {       contractInstance.set(this.state.imageHash, {from: account}).then(() => {          console.log('图片的hash已经写入到区块链！');          this.setState({isSuccess: true});      })  }}>图片哈希写入区块链</button>  {    this.state.isSuccess      ? <div style={{marginTop:10}}>          <div>图片哈希成功写入区块链！</div>          <button onClick={() => {              contractInstance.get({from: account}).then((data) => {                console.log(data);                this.setState({blockChainHash: data});              })            }}>从区块链读取图片哈希</button>        </div>      : <div/>  }  {    this.state.blockChainHash      ? <div style={{marginTop:10}}>          <div>从区块链读取到的哈希值：{this.state.blockChainHash}</div>        </div>      : <div/>  }  {    this.state.blockChainHash      ? <div style={{marginTop:10}}>          <div>访问本地文件：</div>          <div>{"http://localhost:8082/ipfs/" + this.state.imageHash}</div>          <div>访问IPFS网关：</div>          <div>{"https://ipfs.io/ipfs/" + this.state.imageHash}</div>          <img alt="" style={{width: 100, height: 100 }} src={"https://ipfs.io/ipfs/" + this.state.imageHash}/>        </div>      : <img alt=""/>    }    </div>);  }}export default App7.6 新建终端，执行"npm start"命令，结果如图:
  / S$ U" p) P5 |  T% W! V( F4 B
  ) T0 Z0 |( h7 T' U4 x
  % A4 t: v+ T; H+ D* Znpm_start
  
  会自动打开网页，然后上传一张本地图片，之后点击"图片哈希写入区块链"按钮
  ; w+ x7 E4 a% C: e  K8 t9 P" _. T
  8 u0 [( O! N' g9 [4 p! X
  8 D% i+ w. Y2 C5 d
  ! E$ D  l' R/ C4 u. J7 u! t9 H运行结果1
  5 n0 L5 ^* P" i
  最终效果如图:
  & U$ y$ Q* S% l
  2 P( H& o# P. T5 R  k
  
  
  运行结果
  . B1 J9 M# N8 g/ H
  8 `' R8 q. q5 D- [. Z访问IPFS网关：
  https://ipfs.io/ipfs/QmbHptfJfyuGAZxstFYgAVfz33cytR1seTD3ZabBSDd899
  发现图片已经成功写入IPFS，如图：
  
  
  
  
  1 x) r6 q' F6 g; J9 a* j: A运行结果3
  + O# T' \5 K, b& C
  / v$ U& d0 r! k, T# q备注：本地IPFS网关端口默认为8080，我的电脑上端口冲突了，系统自动修改为8082。
  搞定，收工。
  ! E4 |! v1 _1 k. w. B& b+ gPS：刚入坑的小白，很多不懂，还请各位大佬多赐教，谢谢！