IPFS基本使用

[TOC]

在IPFS新增一个文件

新建test.txt文件

打开终端，切换到桌面，新建一个文件夹test，切换到test中，通过vi新建一个文件test.txt，文件里面输入Hello World保存并且退出。

$ cd Desktop/
$ mkdir test
$ cd test/
$ vi test.txt
$ cat test.txt
Hello World

将test.txt添加到ipfs节点

使用ipfs add命令添加：

$ cd Desktop/test
$ ipfs add test.txt
added QmUXTtySmd7LD4p6RG6rZW6RuUuPZXTtNMmRQ6DSQo3aMw test.txt
$ ipfs cat QmUXTtySmd7LD4p6RG6rZW6RuUuPZXTtNMmRQ6DSQo3aMw
Hello World

1. 执行ipfs add test.txt命令将test.txt添加到ipfs当前的节点中；

2. 添加到节点之后，会对test.txt文件生成一个唯一hash QmUXTtySmd7LD4p6RG6rZW6RuUuPZXTtNMmRQ6DSQo3aMw；

3. 通过ipfs cat QmUXTtySmd7LD4p6RG6rZW6RuUuPZXTtNMmRQ6DSQo3aMw命令进行查看。

   ⚠️：数据已经添加到当前本地的ipfs节点中，但是并没有同步到ipfs网络，所以还需同步到ipfs 网络。

4. 同步节点，新建一个终端，执行ipfs daemon命令。

   $ ipfs daemon
   Initializing daemon...
   Successfully raised file descriptor limit to 2048.
   Swarm listening on /ip4/127.0.0.1/tcp/4001
   Swarm listening on /ip4/192.168.17.52/tcp/4001
   Swarm listening on /ip6/::1/tcp/4001
   Swarm listening on /p2p-circuit/ipfs/QmZXXApnUUTD75bph88eNii3Sc97fiumTX7AMBv5CKHGdf
   Swarm announcing /ip4/127.0.0.1/tcp/4001
   Swarm announcing /ip4/192.168.17.52/tcp/4001
   Swarm announcing /ip6/::1/tcp/4001
   API server listening on /ip4/127.0.0.1/tcp/5001
   Gateway (readonly) server listening on /ip4/127.0.0.1/tcp/8080
   Daemon is ready
   

5. 浏览器访问https://ipfs.io/ipfs/QmUXTtySmd7LD4p6RG6rZW6RuUuPZXTtNMmRQ6DSQo3aMw，显示数据为Hello World，说明已经同步至ipfs网络。

通过IPFS创建目录

通过ipfs files的相关命令在ipfs的根目录下面创建文件夹，并且将test.txt文件移动或者拷贝到我们创建的文件夹中。

$ ipfs files mkdir /Jisen
$ ipfs files cp /ipfs/QmUXTtySmd7LD4p6RG6rZW6RuUuPZXTtNMmRQ6DSQo3aMw /Jisen/test.txt
$ ipfs files ls
Jisen
$ ipfs files ls /Jisen
test.txt
$ ipfs files read /Jisen/test.txt
Hello World

⚠️：cp不会改变文件hash，mv会改变hash寻址。

在IPFS新增一个目录

1. 使用ipfs add -r可以上传一整个目录

   $ ipfs add -r ipfs-test
   added QmRkk3DQWpJ6A98NJr75fXLeX6GT3Hk3Mmqir6kRWvb3ZP ipfs-test/cryptowallet.png
   added QmZbi1n5wBUx1mx8azhuhBpEq2fewFexrHmRXLeWHofZ7h ipfs-test/dribble_ill.png
   added QmRNFmmrD9yFMn9EP4AiUZmqj9nnmrLQz9q3qHo2u9w7tT ipfs-test/ipfs_test.txt
   added QmabKwXZfpT8uZvJRKKW7fHN3Rg5ZjuRMPFnSc1VzMQ7ao ipfs-test
   

2. 通过路径访问ipfs_test.txt文件数据

   $ ipfs cat QmRNFmmrD9yFMn9EP4AiUZmqj9nnmrLQz9q3qHo2u9w7tT
   Welcome IPFS!
   $ ipfs cat /ipfs/QmRNFmmrD9yFMn9EP4AiUZmqj9nnmrLQz9q3qHo2u9w7tT
   Welcome IPFS!
   $ ipfs cat /ipfs/QmabKwXZfpT8uZvJRKKW7fHN3Rg5ZjuRMPFnSc1VzMQ7ao/ipfs_test.txt
   Welcome IPFS!
   

3. 通过Hash查看数据IPFS网络数据

   • 访问目录：https://ipfs.io/ipfs/QmabKwXZfpT8uZvJRKKW7fHN3Rg5ZjuRMPFnSc1VzMQ7ao
   • 通过目录访问文件：https://ipfs.io/ipfs/QmabKwXZfpT8uZvJRKKW7fHN3Rg5ZjuRMPFnSc1VzMQ7ao/ipfs_test.txt
   • 通过文件hash直接访问：https://ipfs.io/ipfs/QmRNFmmrD9yFMn9EP4AiUZmqj9nnmrLQz9q3qHo2u9w7tT

发布简易网页到IPFS

新建一个site文件夹，然后按照下面的步骤在site文件夹中建立index.html和style.css文件。

1. 创建一个index.html文件

   
   
   
     
     
     
   
   
     
   Hello IPFS!
   
   
   

2. 创建一个style.css文件

   h1 {
     color: green;
   }
   

3. 添加到ipfs

   $ ipfs add -r site/
   added QmS4a85WLxie6Zy6Tntg6CccyGHyV4823Vo1vkjGBYhetP site/index.html
   added QmZL2UBTwnhcLv66fARL9UV8W8a9ZA4iwTLcaUCsB1u1yW site/style.css
   added QmPAygbESghBjPbLhGJAda5rA9GCBMHMGfgwLoB61DfnxX site
   

4. 网络同步

   $ ipfs daemon
   

5. 访问网站：https://ipfs.io/ipfs/QmPAygbESghBjPbLhGJAda5rA9GCBMHMGfgwLoB61DfnxX

发布到IPNS

修改网页内容重新添加到ipfs时，hash会发生变化，这时我们可以将网页发布到IPNS，在IPNS中，允许我们节点的域名空间中引用一个IPFS hash，也就是说我们可以通过节点ID对项目根目录的IPFS HASH进行绑定，以后我们访问网页时直接通过节点ID访问即可，当我们更新网页时，重新发布到IPNS即可。

$ ipfs name publish QmPAygbESghBjPbLhGJAda5rA9GCBMHMGfgwLoB61DfnxX
Published to QmZXXApnUUTD75bph88eNii3Sc97fiumTX7AMBv5CKHGdf: /ipfs/QmPAygbESghBjPbLhGJAda5rA9GCBMHMGfgwLoB61DfnxX
$ ipfs id
{
    "ID": "QmZXXApnUUTD75bph88eNii3Sc97fiumTX7AMBv5CKHGdf"
    ......
}

当我们执行ipfs name publish命令时，会返回我们的节点ID，你可以通过ipfs id进行查看验证是否是你的节点ID。

⚠️：验证

$ ipfs name resolve QmZXXApnUUTD75bph88eNii3Sc97fiumTX7AMBv5CKHGdf
/ipfs/QmPAygbESghBjPbLhGJAda5rA9GCBMHMGfgwLoB61DfnxX

接下来，就可以通过IPNS进行访问了：https://ipfs.io/ipns/QmZXXApnUUTD75bph88eNii3Sc97fiumTX7AMBv5CKHGdf

⚠️：访问的时候注意上面链接是ipns而不是ipfs。

最后需要⚠️：如果网站数据修改，需要重新发布到IPNS。