正文 

当前位置： 首页 > 开发 > java教程

ipfs使用入门(代码片段)

tinyxiong tinyxiong     2023-02-21     281

关键词：

在上一篇文章介绍了IPFS要做什么， 本篇文章介绍下IPFS怎么用， 按照本站的风格，我不会仅仅把一个个命令列出来，同时会说明命令在后面为我们做了什么。

IPFS 安装

要使用IPFS， 第一步肯定是先把IPFS安装好，IPFS在Mac OS X 、Linux及Window平台均有提供， 可以通过这个链接下载对应平台可执行文件的压缩包。

对于Mac OS X 及 Linux 平台，使用一下命令进行安装：

$ tar xvfz go-ipfs.tar.gz
$ cd go-ipfs
$ ./install.sh

上面先使用tar 对压缩包进行解压，然后执行install.sh 进行安装，安装脚本install.sh其实就是把可执行文件ipfs移动到$PATH目录下。安装完成之后，可以在命令行终端敲入ipfs试试看，如果显示一堆命令说明，则说明IPFS安装成功。

在Windows平台也是类似，把ipfs.exe移动到环境变量%PATH%指定的目录下。

IPFS 基本用法

IPFS初始化

安装完成之后，要使用IPFS第一步是要对IPFS进行初始化，使用ipfs init进行初始化

> ipfs init
initializing ipfs node at /Users/Emmett/.ipfs
generating 2048-bit RSA keypair...done
peer identity: QmYM36s4ut2TiufVvVUABSVWmx8VvmDU7xKUiVeswBuTva
to get started, enter:

  ipfs cat /ipfs/QmS4ustL54uo8FzR9455qaxZwuMiUhyvMcX9Ba8nUH4uVv/readme

上面是执行命令即对应输出，在执行ipfs init进行初始化时，会有一下行为：

  1. 生成一个秘钥对并产生对应的节点id， 即命令提示：peer identity后面的hash值。

节点的id用来标识和连接一个节点，每个节点的id是独一无二的， 因此大家看到的提示也会和我的不一样。

  1. 在当前用户的主目录（~ 目录）下产生一个.ipfs 的隐藏目录，这个目录称之为库（repository）目录，ipfs 所有相关的数据都会放在这个目录下。
    如同步文件数据块放在.ipfs/blocks 目录，秘钥在.ipfs/keystore 目录，ipfs配置文件为：.ipfs/config。

IPFS 配置修改

在IPFS初始化之后，可以根据需要修改配置（可选），修改方法如下：

cd ~/.ipfs
export EDITOR=/usr/bin/vim
ipfs config edit

或者直接编辑 ~/.ipfs/config 文件。

上传文件到IPFS

我们先创建一个upchain.pro.txt文件，可以使用如下方式：

> echo "登链学院：区块链教育领先品牌" >> upchain.pro.txt

ipfs 使用add 命令来添加内容到节点中， 在命令行输入：

> ipfs add upchain.pro.txt
added QmQgMZKqHzyEdyJja5ioF8WaXrbUDVjqhJDoaUKDymgioi upchain.pro.txt
 43 B / 43 B [=====================================================] 100%

当它文件添加到节点时，会为文件生成唯一的hash: QmQgMZKqHzyEdyJja5ioF8WaXrbUDVjqhJDoaUKDymgioi, 可以使用ipfs cat 查看文件的内容：

> ipfs cat QmQgMZKqHzyEdyJja5ioF8WaXrbUDVjqhJDoaUKDymgioi
登链学院：区块链教育领先品牌

注意，此时文件仅仅是上传在本地的IPFS节点中，如果需要把文件同步到网络，就需要开启 daemon 服务， 使用命令：

> ipfs daemon
Initializing daemon...
go-ipfs version: 0.4.18-
Repo version: 7
System version: amd64/darwin
Golang version: go1.11.1
Swarm listening on /ip4/127.0.0.1/tcp/4001
Swarm listening on /ip4/192.168.8.105/tcp/4001
Swarm listening on /ip6/2408:84f3:82e:cfcd:409:fee2:e261:4dc3/tcp/4001
Swarm listening on /ip6/2408:84f3:82e:cfcd:a9c6:116b:349f:8c2b/tcp/4001
Swarm listening on /ip6/2408:84f3:82e:cfcd:ec89:145d:cf27:4/tcp/4001
Swarm listening on /ip6/::1/tcp/4001
Swarm listening on /ip6/fd1d:43b:e89b:eb9b:c405:56af:8f52:67df/tcp/4001
Swarm listening on /p2p-circuit
Swarm announcing /ip4/127.0.0.1/tcp/4001
Swarm announcing /ip4/192.168.8.105/tcp/4001
Swarm announcing /ip6/2408:84f3:82e:cfcd:409:fee2:e261:4dc3/tcp/4001
Swarm announcing /ip6/2408:84f3:82e:cfcd:a9c6:116b:349f:8c2b/tcp/4001
Swarm announcing /ip6/2408:84f3:82e:cfcd:ec89:145d:cf27:4/tcp/4001
Swarm announcing /ip6/::1/tcp/4001
Swarm announcing /ip6/fd1d:43b:e89b:eb9b:c405:56af:8f52:67df/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

开启 daemon 之后，Swarm 就会尝试连接其他的节点，同步数据，同时在本地还会开启两个服务：API服务及Web网关服务，下面分别介绍下：

  1. API服务，默认在5001端口，可以通过 http://localhost:5001/webui 进行访问，界面如：

技术分享图片

这也是IPFS的一个Web版的管理控制台， 可以通过这个控制台添加文件，查看节点连接情况等等。

  1. 网关服务，默认在8080端口， 由于当前浏览器还不支持通过IPFS协议（ipfs://）来访问文件，如果我们要在浏览器里访问文件的话，就需要借助于IPFS 提供的网关服务，由浏览器先访问到网关，网关去获取IPFS网络杀过了的文件。 有了网关服务，就可以通过这个链接：http://localhost:8080/ipfs/QmQgMZKqHzyEdyJja5ioF8WaXrbUDVjqhJDoaUKDymgioi 来访问刚刚上传到ipfs 的文件。

ipfs 也提供了官方的网关服务：https://ipfs.io/， 因此也可以通过 https://ipfs.io/ipfs/QmQgMZKqHzyEdyJja5ioF8WaXrbUDVjqhJDoaUKDymgioi （需要FQ）来访问刚刚上传到ipfs 的文件。

上传目录到IPFS

我们先创建一个文件夹upchain, 并把之前的 upchain.pro.txt 放进目录。

> mkdir upchain
> mv upchain.pro.txt  upchain

上传目录到IPFS 需要在使用 add 命令时加上 -r ，如下：

> ipfs add -r upchain
added QmQgMZKqHzyEdyJja5ioF8WaXrbUDVjqhJDoaUKDymgioi upchain/upchain.pro.txt
added QmQYpGRFBpHVzoShpwU5C3XgGAxJKqY83X8VXfMbyktdbP upchain
 43 B / 43 B [===========================================================================] 100.00%

在上传时文件夹，文件夹也会生成一个对应的hash，可以通过hash后接文件名来进行访问， 如：

>ipfs cat QmQYpGRFBpHVzoShpwU5C3XgGAxJKqY83X8VXfMbyktdbP/upchain.pro.txt
登链学院：区块链教育领先品牌

在浏览器可以链接：http://127.0.0.1:8080/ipfs/QmQYpGRFBpHVzoShpwU5C3XgGAxJKqY83X8VXfMbyktdbP/upchain.pro.txt 来访问。

通过上传目录的方式，可以把整个静态网站的根目录上传到IPFS网络，这样就可以省去托管服务器，例如可以直接通过以下链接访问深入浅出区块链博客：
https://ipfs.io/ipfs/QmaFWgfpRNzeLgfDrH33BuBdiauRTejnF3Yw9AuCphq2ua/index.html

使用IPNS解决文件更新问题

因为IPFS在IPFS中，对一个文件的内容修改后（如升级），会生成一个完全不同的新Hash，使用IPNS就可以利用同一个链接总是指向更新的内容，其实使用也很简单，只需要每次在内容更新之后使用ipfs name publish hash 发布到节点。

例如把upchain.pro.txt发布到节点，使用下面的命令:

> ipfs name publish QmQgMZKqHzyEdyJja5ioF8WaXrbUDVjqhJDoaUKDymgioi
Published to QmYM36s4ut2TiufVvVUABSVWmx8VvmDU7xKUiVeswBuTva: /ipfs/QmQgMZKqHzyEdyJja5ioF8WaXrbUDVjqhJDoaUKDymgioi

命令中的QmQgMZKqHzyEdyJja5ioF8WaXrbUDVjqhJDoaUKDymgioi是upchain.pro.txt的hash, 命令提示中的QmYM36s4ut2TiufVvVUABSVWmx8VvmDU7xKUiVeswBuTva是当前节点id(大家可以回看一个前面ipfs init 的输出)。

发布之后就可以使用http://127.0.0.1:8080/ipns/QmYM36s4ut2TiufVvVUABSVWmx8VvmDU7xKUiVeswBuTva 或 https://ipfs.io/ipns/QmYM36s4ut2TiufVvVUABSVWmx8VvmDU7xKUiVeswBuTva 来访问upchain.pro.txt的内容，如图：

技术分享图片

其实理想下是使用 ipns://QmYM36s4ut2TiufVvVUABSVWmx8VvmDU7xKUiVeswBuTva 来访问，通过网站还是前面提到的浏览器暂不支持ipfs协议。

现在我们来更新一下upchain.pro.txt 加入文字："创办人：Tiny熊"

> echo "创办人：Tiny熊" >>  upchain.pro.txt
> ipfs add upchain.pro.txt
added QmUUiDN6tWtj89xmUw1iCK2NczBqE6m3zH9QnbhHoMvZ5S upchain.pro.txt
 63 B / 63 B [=============================================================] 100.00%

重新发布一下：

> ipfs name publish QmUUiDN6tWtj89xmUw1iCK2NczBqE6m3zH9QnbhHoMvZ5S
Published to QmYM36s4ut2TiufVvVUABSVWmx8VvmDU7xKUiVeswBuTva: /ipfs/QmUUiDN6tWtj89xmUw1iCK2NczBqE6m3zH9QnbhHoMvZ5S

再次访问 http://127.0.0.1:8080/ipns/QmYM36s4ut2TiufVvVUABSVWmx8VvmDU7xKUiVeswBuTva （这个链接和上面的链接一样）可以看到内容更新了。

技术分享图片

如果我们要查询 节点id 指向的hash 可以使用 ipfs name resolve 进行查询：

> ipfs name resolve
/ipfs/QmUUiDN6tWtj89xmUw1iCK2NczBqE6m3zH9QnbhHoMvZ5

有一点值得大家注意： 节点id其实是公钥的hash，它的关联信息是需要经过私钥签名才可以发布，因此只有我们自己才可以更新节点的指向。

如果我们有多个站点需要更新，可以新产生一个秘钥对，使用新的key 发布，如：

> ipfs key gen --type=rsa --size=2048 mykey
QmVZvdYEsdfHSR43Qm1fY8eDFrhB3UNZ2oVyEuVUH3VHrg
> ipfs name publish --key=mykey  hashxxx

Pinning

Pinning 在IPFS里是一个很重要的概念，当我们每次请求一个网络上的内容的时候，IPFS总是会把内容先同步的本地提供服务，而为了防止 IPFS 存储空间不停增长，实际上使用cache 机制来处理文件， 如果文件在一段时间内没有被使用，文件会被”回收“。 Pinning 的作用就是把文件”钉“住，确保文件在本地不被”回收“。 如果是重要的文件，就可以使用 Pinning 防止文件被删除。

当我们使用ipfs add 添加文件时，默认会进行Pinning(使用其他命令获取的文件不会进行pinning），

IPFS 提供了pin命令进行Pinning操作, 比如我们查询下某一个hash 是否被pin:

> ipfs pin ls QmUUiDN6tWtj89xmUw1iCK2NczBqE6m3zH9QnbhHoMvZ5S
QmUUiDN6tWtj89xmUw1iCK2NczBqE6m3zH9QnbhHoMvZ5S recursive

> ipfs pin ls QmWnrAEKyDVUQ1jh9vDtQhtBSNEgUnQhAJyMmo3JjwJZK7
Error: path ‘QmWnrAEKyDVUQ1jh9vDtQhtBSNEgUnQhAJyMmo3JjwJZK7‘ is not pinned

可以使用 pin add 手动钉住一个文件，如：

> ipfs pin add QmWnrAEKyDVUQ1jh9vDtQhtBSNEgUnQhAJyMmo3JjwJZK7
pinned QmWnrAEKyDVUQ1jh9vDtQhtBSNEgUnQhAJyMmo3JjwJZK7 recursively

如果要删除pin的状态，使用pin rm ， 如:

> ipfs pin rm -r QmWnrAEKyDVUQ1jh9vDtQhtBSNEgUnQhAJyMmo3JjwJZK7
unpinned QmWnrAEKyDVUQ1jh9vDtQhtBSNEgUnQhAJyMmo3JjwJZK7

pin rm 的参数 -r 表示递归的删除pin 状态，对于没有pin住的文件， 如果执行GC操作 ipfs repo gc 文件会被删除。

欢迎来知识星球提问，星球内已经聚集了300多位区块链技术爱好者。
深入浅出区块链 - 系统学习区块链，打造最好的区块链技术博客。




ipfilter快速入门指南(代码片段)

...为ipf)是一个开放源码的防火墙，可以在多个操作系统上使用，包括FreeBSD、NetBSD、OpenBSD和Solaris。IPFILTER作为内核可加载模块包含在基本的FreeBSD安装中。这个快速入门指南提供了一些有用的命令和技术来帮助调试IPFilter。 开始... 查看详情

冲向星际的下一代互联网协议ipfs(代码片段)

...么有IPFS3IPFS的目标4IPFS包含哪些内容5IPFS与Filecoin6IPFS开发入门6.1部署私有IPFS6.1.1环境准备6.1.2配置golang环境6.1.3IPFS部署6.1.4生成共享key6.1.5添加网络节点6.1.6启动IPFS6.1.7测试文本传输6.2架构说明6.2.1IPFS总体架构图6.2.2CLI、HTTP-API架构... 查看详情

董天一ipfs:pubsub功能的使用(代码片段)

作者简介：董天一，IPFS/Filecoin中国区技术布道人，《IPFS指南》作者毕业于北京大学软件与微电子学院，资深区块链技术开发者，现致力于IPFS/Filecoin在中国的技术推广，本文原载微信公众号：IPFS指南(ipfs_guide)什么是pubsub？发布... 查看详情

36.fabric与ipfs使用(代码片段)

...伴关心Fabric如何与IPFS相结合，本节我们来聊聊为什么要使用IPFS，哪些场景需要使用IPFS，并使用ipfsgolangsdk管理IPFS数据。1.什么是IPFSIPFS是分布式存储，可将文件信息存储至IPFS系统，并返回文件Hash值，用户可通过Hash值查询到文件... 查看详情

使用docker安装ipfs星际文件系统(代码片段)

...中心化共享文件节点GitDHTs哈希区块链P2PBitTorrent存储特性使用存储对象的哈希值来获取对象内容。相同内容的文件由于哈希值一样，在系统中只会存在一份，有效的节约存储空间。注意：用户无法在提交文件后修改文... 查看详情

使用腾讯云轻量下载安装go-ipfs(代码片段)

...下自己搭建ipfs节点的过程分享给大家go-ipfs下载安装本文使用的是腾讯云轻量服务器,系统为centos7.go版本的下载来直接运行即可腾讯云轻量应用服务器链接:https://curl.qcloud.com/oweLHGUr#下载wgethttps://github.com/ipfs/go-ipfs/releases/download/v0.9... 查看详情

ipfs搭建(代码片段)

IPFS搭建官网https://ipfs.io可能需要梯子下载和编译下载代码gitclonehttps://github.com/ipfs/go-ipfs.git首先需要1.16版本以上的go环境下载go安装goubuntu@ubuntu-sol:~/IPFS$wgethttps://golang.org/dl/go1.17.2.linux-amd64.tar.gzubuntu@u 查看详情

ipfs初探(代码片段)

背景：听说IPFS=bittorrent+bitcoin+git+afs，有可能取代http，好像厉害的不行，所以要研究一下。编译参考：https://github.com/ipfs/go-ipfs 结果各种墙都翻好了，一切基础设施都到位了，还是没编译成功shit(最后还是编过了)。退而求其次... 查看详情

第133篇ipfs介绍(代码片段)

本文简单介绍IPFS，不包含技术细节，所有内容来自网络；一、IPFS是什么星际文件系统IPFS（InterPlanetaryFileSystem）是一个面向全球的、点对点的分布式版本文件系统，目标是为了补充（甚至是取代）目前统治互联网的超文本传输协... 查看详情

第133篇ipfs介绍(代码片段)

本文简单介绍IPFS，不包含技术细节，所有内容来自网络；一、IPFS是什么星际文件系统IPFS（InterPlanetaryFileSystem）是一个面向全球的、点对点的分布式版本文件系统，目标是为了补充（甚至是取代）目前统治互联网的超文本传输协... 查看详情

让ipfs一直在后台运行,顺带学习如何创建一个service服务(代码片段)

在使用IPFS遇到一个问题，就是在服务器端启动了ipfsdaemon命令后，关闭终端对应守护进程也会停止，但我并不想让他停止运行，所以就查到相关信息资料，如下分享：当我们需要让IPFS一直在后台保持运行时... 查看详情

sh从ipfs中删除所有固定对象(代码片段)

查看详情

ipfs探索(代码片段)

IPFS探索比特币当前是用于存金融交易数据，有leveldb存关键小的交易数据。那么我们的文件，譬如一个网站里面的staticfile怎么办？IPFS（InterPlanetaryFileSystem）是一个点对点的分布式超媒体分发协议，它整合了过去几年最好的分布... 查看详情

markdownhttp://ipfs-arkticker.ddns.net/(代码片段)

查看详情

go-ipfs入门及介绍

1、go-ipfs安装 参考： https://mp.weixin.qq.com/s?__biz=MzUwOTE3NjY3Mw==&mid=2247483734&idx=1&sn=ef73c1d7b796ccfc2dae19be25ee04d6&chksm=f9177f58ce60f64edb3ea928d3a9984e1caf22b67143b 查看详情

快速搭建部署spa应用到web3.0（ipfs）(代码片段)

...现迅速部署自己的第一个SPA应用至星际文件系统IPFS作为入门web3.0的第一个练习，拿我自身来说，前后端知识基本为0，我的基本流程如下：选择合适的应用类型(SPA)挑选简单模板并套用（H5+Bootstarp+原生java... 查看详情

让ipfs一直在后台运行,顺带学习如何创建一个service服务(代码片段)

在使用IPFS遇到一个问题，就是在服务器端启动了ipfsdaemon命令后，关闭终端对应守护进程也会停止，但我并不想让他停止运行，所以就查到相关信息资料，如下分享：当我们需要让IPFS一直在后台保持运行时... 查看详情

让ipfs一直在后台运行,顺带学习如何创建一个service服务(代码片段)

在使用IPFS遇到一个问题，就是在服务器端启动了ipfsdaemon命令后，关闭终端对应守护进程也会停止，但我并不想让他停止运行，所以就查到相关信息资料，如下分享：当我们需要让IPFS一直在后台保持运行时... 查看详情