有多种方法可以在系统上安装IPFS。我们通常建议安装预先构建的软件包,但以下是一些其他支持的选项:
请注意,这些指令都需要使用命令行。我们$
用来指示命令提示符 – 要键入的命令位于带有前缀的行上,而输出行没有前缀。
从预构建包安装
首先,下载正确系统版本的IPFS:
Mac OS X和Linux
下载后,解压缩文件,然后使用脚本将ipfs
二进制文件移动到可执行文件$PATH
中的某个位置install.sh
:
$ tar xvfz go-ipfs.tar.gz
$ cd go-ipfs
$ ./install.sh
测试一下:
$ ipfs help
USAGE:
ipfs - Global p2p merkle-dag filesystem.
...
恭喜!您现在在计算机上安装了有效的IPFS。
Windows
下载后,解压缩文件,然后移动ipfs.exe
到%PATH%
路径下。
测试一下:
$ ipfs help
USAGE:
ipfs - Global p2p merkle-dag filesystem.
...
恭喜!您现在在计算机上安装了有效的IPFS。
使用ipfs-update进行安装
ipfs-update
是一个用于安装和升级ipfs
二进制文件的命令行工具。
获取ipfs-update
ipfs-update
可以在以下网址下载适用于您的系统的版本:https://dist.ipfs.io/#ipfs-update
如果您有一个正常运行的Go语言环境(> = 1.8),您也可以使用以下命令安装它:
$ go get -u github.com/ipfs/ipfs-update
安装新版本ipfs
或升级时,请确保使用的是最新版本ipfs-update
。
使用ipfs-update安装ipfs
ipfs-update versions
列出了ipfs
可供下载的所有可用版本:
$ ipfs-update versions
v0.3.2
v0.3.4
v0.3.5
v0.3.6
v0.3.7
v0.3.8
v0.3.9
v0.3.10
v0.3.11
v0.4.0
v0.4.1
v0.4.2
v0.4.3
v0.4.4
v0.4.5
v0.4.6
v0.4.7-rc1
ipfs-update install latest
将安装最新的可用版本:
$ ipfs-update install latest
fetching go-ipfs version v0.4.7-rc1
binary downloaded, verifying...
success!
stashing old binary
installing new binary to /home/hector/go/bin/ipfs
checking if repo migration is needed...
Installation complete!
请注意,最新的可用版本可能不稳定(即表单中的候选版本vX.X.X-rcX
)。因此,建议指定要安装的版本,例如:ipfs-update install v0.4.6
。
从源代码编译
如果需要,你还可以从源代码编译IPFS。如果您使用的是Mac OS X或Linux,请查看自述文件以获取安装说明。如果您在Windows上,请查看此文档以获取说明。
升级IPFS
ipfs
升级(和降级)可能涉及fs-repo-migrations工具执行的存储库升级过程 。
使用ipfs-update升级
ipfs-update install
将fs-repo-migrations
在安装新版本或旧ipfs
版本时(如上所述)在需要时下载并运行。这是最简单的升级方式。
手动升级
要执行手动升级ipfs
,您需要手动运行所有的存储库迁移。步骤如下:
- 如果
ipfs
守护进程正在运行,请将其停止 - 备份
ipfs
数据文件夹(即cp -aL ~/.ipfs ~/.ipfs.bk
)(可选) - 从https://dist.ipfs.io/#go-ipfs下载并安装
ipfs
最新版本 - 运行
ipfs daemon
。
当需要存储库迁移时,ipfs
将通知用户,下载并安装fs-repo-migrations
并执行升级。如果希望过程无人值守,请使用--migrate
标签启动守护进程。
也可以通过fs-repo-migrations
并按照这些说明手动运行迁移,从https://dist.ipfs.io/#fs-repo-migrations下载最新版本。
故障排除
帮助!
如果您有任何问题,请在#ipfs或通过邮件列表获取实时帮助 。
检查Go版本
IPFS适用于Go 1.7.0或更高版本。要检查已安装的版本,请键入go version
。这是我输出的:
$ go version
go version go1.7 linux/amd64
如果需要更新,建议从规范的Go包安装 。包管理器自带的Go语言包通常是过时的。
安装FUSE
有关设置FUSE的更多详细信息(以便可以挂载文件系统),请参阅github.com/ipfs/go-ipfs/blob/master/docs/fuse.md