IPFS 搭建
官网
https://ipfs.io 可能需要梯子
下载和编译
下载代码
git clone https://github.com/ipfs/go-ipfs.git
首先需要 1.16版本以上的go环境
下载go
安装go
ubuntu@ubuntu-sol:~/IPFS$wget https://golang.org/dl/go1.17.2.linux-amd64.tar.gz
ubuntu@ubuntu-sol:~/IPFS$tar -zxvf go1.17.2.linux-amd64.tar.gz
ubuntu@ubuntu-sol:~/IPFS$sudo mv go /usr/local
ubuntu@ubuntu-sol:~/IPFS$vi ~/.profile
在末尾输入 export PATH=$PATH:/usr/local/go/bin
ubuntu@ubuntu-sol:~/IPFS$source ~/.profile
ubuntu@ubuntu-sol:~/IPFS$ go version
go version go1.17.2 linux/amd64
源码
找一个目录，下载源码
ubuntu@ubuntu-sol:~/IPFS$ mkdir ipfs && cd ipfs
ubuntu@ubuntu-sol:~/IPFS/ipfs$ git clone https://github.com/ipfs/go-ipfs.git
ubuntu@ubuntu-sol:~/IPFS/ipfs$ cd go-ipfs
## 选择需要的版本
ubuntu@ubuntu-sol:~/IPFS/ipfs/go-ipfs$ git checkout v0.10.0
编译IPFS
编译安装比较久，可以使用下面的官方直接下载release好的ipfs进行安装
ubuntu@ubuntu-sol:~/IPFS/ipfs/go-ipfs$ make build
ubuntu@ubuntu-sol:~/IPFS/ipfs/go-ipfs$ make install
官方release的ipfs
可以通过下面的链接直接下载官方编译好的ipfs
https://github.com/ipfs/go-ipfs/releases
文档采用的是下面这个地址
https://github.com/ipfs/go-ipfs/releases/download/v0.10.0/go-ipfs_v0.10.0_linux-amd64.tar.gz
压缩包里面的和源码 go-ipfs/cmd/ipfs/dist目录下内容是一样的，只是没有ipfs 文件，源码编译后，会在ipfs目录下生成ipfs文件
ubuntu@ubuntu-sol:~/IPFS/ipfs$ tar -zxf go-ipfs_v0.10.0_linux-amd64.tar.gz
ubuntu@ubuntu-sol:~/IPFS/ipfs$ cd go-ipfs
ubuntu@ubuntu-sol:~/IPFS/ipfs/go-ipfs$ ls
install.sh ipfs LICENSE LICENSE-APACHE LICENSE-MIT README.md
ubuntu@ubuntu-sol:~/IPFS/ipfs/go-ipfs$ sudo ./install.sh
Moved ./ipfs to /usr/local/bin
测试
输入ipfs help 测试安装成功
ubuntu@ubuntu-sol:~/IPFS/ipfs/go-ipfs$ ipfs --version
ipfs version 0.10.0
ubuntu@ubuntu-sol:~/IPFS/ipfs/go-ipfs$ ipfs help
USAGE
ipfs - Global p2p merkle-dag filesystem.
SYNOPSIS
ipfs [--config=<config> | -c] [--debug | -D] [--help] [-h] [--api=<api>] [--offline] [--cid-base=<base>] [--upgrade-cidv0-in-output] [--encoding=<encoding> | --enc] [--timeout=<timeout>] <command> ...
OPTIONS
-c, --config string - Path to the configuration file to use.
-D, --debug bool - Operate in debug mode.
--help bool - Show the full command help text.
-h bool - Show a short version of the command help text.
-L, --local bool - Run the command locally, instead of using the daemon. DEPRECATED: use --offline.
--offline bool - Run the command offline.
--api string - Use a specific API instance (defaults to /ip4/127.0.0.1/tcp/5001).
--cid-base string - Multibase encoding used for version 1 CIDs in output.
--upgrade-cidv0-in-output bool - Upgrade version 0 to version 1 CIDs in output.
--enc, --encoding string - The encoding type the output should be encoded with (json, xml, or text). Default: text.
--stream-channels bool - Stream channel output.
--timeout string - Set a global timeout on the command.
SUBCOMMANDS
BASIC COMMANDS
init Initialize local IPFS configuration
add <path> Add a file to IPFS
cat <ref> Show IPFS object data
get <ref> Download IPFS objects
ls <ref> List links from an object
refs <ref> List hashes of links from an object
DATA STRUCTURE COMMANDS
dag Interact with IPLD DAG nodes
files Interact with files as if they were a unix filesystem
block Interact with raw blocks in the datastore
TEXT ENCODING COMMANDS
cid Convert and discover properties of CIDs
multibase Encode and decode data with Multibase format
ADVANCED COMMANDS
daemon Start a long-running daemon process
mount Mount an IPFS read-only mount point
resolve Resolve any type of name
name Publish and resolve IPNS names
key Create and list IPNS name keypairs
dns Resolve DNS links
pin Pin objects to local storage
repo Manipulate the IPFS repository
stats Various operational stats
p2p Libp2p stream mounting
filestore Manage the filestore (experimental)
NETWORK COMMANDS
id Show info about IPFS peers
bootstrap Add or remove bootstrap peers
swarm Manage connections to the p2p network
dht Query the DHT for values or peers
ping Measure the latency of a connection
diag Print diagnostics
bitswap Inspect bitswap state
pubsub Send and receive messages via pubsub
TOOL COMMANDS
config Manage configuration
version Show IPFS version information
update Download and apply go-ipfs updates
commands List all available commands
log Manage and show logs of running daemon
Use 'ipfs <command> --help' to learn more about each command.
ipfs uses a repository in the local file system. By default, the repo is
located at ~/.ipfs. To change the repo location, set the $IPFS_PATH
environment variable:
export IPFS_PATH=/path/to/ipfsrepo
EXIT STATUS
The CLI will exit with one of the following values:
0 Successful execution.
1 Failed executions.
For more information about each command, use:
'ipfs <subcmd> --help'
初始化ipfs
ubuntu@ubuntu-sol:~/IPFS/ipfs/go-ipfs$ ipfs init
generating ED25519 keypair...done
peer identity: 12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6
initializing IPFS node at /home/ubuntu/.ipfs
to get started, enter:
ipfs cat /ipfs/QmQPeNsJPyVWPFDVHb77w8G42Fvo15z4bG2X8D2GhfbSXc/readme
ubuntu@ubuntu-sol:~/IPFS/ipfs/go-ipfs$ ipfs cat /ipfs/QmQPeNsJPyVWPFDVHb77w8G42Fvo15z4bG2X8D2GhfbSXc/readme
Hello and Welcome to IPFS!
██╗██████╗ ███████╗███████╗
██║██╔══██╗██╔════╝██╔════╝
██║██████╔╝█████╗ ███████╗
██║██╔═══╝ ██╔══╝ ╚════██║
██║██║ ██║ ███████║
╚═╝╚═╝ ╚═╝ ╚══════╝
If you're seeing this, you have successfully installed
IPFS 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
查看id
节点搭建成功之后我们可以通过 ipfs id 命令查看自己的本机id
ubuntu@ubuntu-sol:~/IPFS/ipfs/go-ipfs$ ipfs id
{
"ID": "12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6",
"PublicKey": "CAESIMzaxMDeC5b4HZgWuNxfh94PWg9al4C22hhBt2wks+6F",
"Addresses": null,
"AgentVersion": "go-ipfs/0.10.0/",
"ProtocolVersion": "ipfs/0.1.0",
"Protocols": null
}
配置启动
默认配置会配置连接附近的IPFS节点，在~/.ipfs/config配置文件的Bootstrap里面设置，如果需要只是本地私有用，将Bootstrap 的内容设置为空就可以
"Bootstrap": [
"/ip4/104.131.131.82/tcp/4001/p2p/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ",
"/ip4/104.131.131.82/udp/4001/quic/p2p/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ",
"/dnsaddr/bootstrap.libp2p.io/p2p/QmNnooDu7bfjPFoTZYxMNLWUQJyrVwtbZg5gBMjTezGAJN",
"/dnsaddr/bootstrap.libp2p.io/p2p/QmQCU2EcMqAqQPR2i9bChDtGNJchTbq5TbXJJ16u19uLTa",
"/dnsaddr/bootstrap.libp2p.io/p2p/QmbLHAnMoJPWSCR5Zhtx6BHJX9KiKNN6tpvbUcqanj75Nb",
"/dnsaddr/bootstrap.libp2p.io/p2p/QmcZf59bWwK5XFi76CZX8cbJ4BhTzzA3gU1ZjYZcYW3dwt"
],
配置其他机器访问
ipfs config --json API.HTTPHeaders.Access-Control-Allow-Origin '["*"]'
ipfs config --json Addresses.API '"/ip4/0.0.0.0/tcp/5001"'
启动
ubuntu@ubuntu-sol:~/IPFS/ipfs/go-ipfs$ ipfs daemon
Initializing daemon...
go-ipfs version: 0.10.0
Repo version: 11
System version: amd64/linux
Golang version: go1.16.8
2021/10/26 15:17:14 failed to sufficiently increase receive buffer size (was: 208 kiB, wanted: 2048 kiB, got: 416 kiB). See https://github.com/lucas-clemente/quic-go/wiki/UDP-Receive-Buffer-Size for details.
Swarm listening on /ip4/127.0.0.1/tcp/4001
Swarm listening on /ip4/127.0.0.1/udp/4001/quic
Swarm listening on /ip4/192.168.0.17/tcp/4001
Swarm listening on /ip4/192.168.0.17/udp/4001/quic
Swarm listening on /ip6/::1/tcp/4001
Swarm listening on /ip6/::1/udp/4001/quic
Swarm listening on /p2p-circuit
Swarm announcing /ip4/127.0.0.1/tcp/4001
Swarm announcing /ip4/127.0.0.1/udp/4001/quic
Swarm announcing /ip4/192.168.0.17/tcp/4001
Swarm announcing /ip4/192.168.0.17/udp/4001/quic
Swarm announcing /ip6/::1/tcp/4001
Swarm announcing /ip6/::1/udp/4001/quic
API server listening on /ip4/0.0.0.0/tcp/5001
WebUI: http://0.0.0.0:5001/webui
Gateway (readonly) server listening on /ip4/127.0.0.1/tcp/8080
Daemon is ready
启动后查看id
ubuntu@ubuntu-sol:~/.ipfs$ ipfs id
{
"ID": "12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6",
"PublicKey": "CAESIMzaxMDeC5b4HZgWuNxfh94PWg9al4C22hhBt2wks+6F",
"Addresses": [
"/ip4/127.0.0.1/tcp/4001/p2p/12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6",
"/ip4/127.0.0.1/udp/4001/quic/p2p/12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6",
"/ip4/192.168.0.17/tcp/4001/p2p/12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6",
"/ip4/192.168.0.17/udp/4001/quic/p2p/12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6",
"/ip4/220.189.210.50/tcp/2417/p2p/12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6",
"/ip4/220.189.210.50/tcp/2418/p2p/12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6",
"/ip4/220.189.210.50/udp/2431/quic/p2p/12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6",
"/ip4/220.189.210.50/udp/2457/quic/p2p/12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6",
"/ip6/::1/tcp/4001/p2p/12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6",
"/ip6/::1/udp/4001/quic/p2p/12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6"
],
"AgentVersion": "go-ipfs/0.10.0/",
"ProtocolVersion": "ipfs/0.1.0",
"Protocols": [
"/ipfs/bitswap",
"/ipfs/bitswap/1.0.0",
"/ipfs/bitswap/1.1.0",
"/ipfs/bitswap/1.2.0",
"/ipfs/id/1.0.0",
"/ipfs/id/push/1.0.0",
"/ipfs/lan/kad/1.0.0",
"/ipfs/ping/1.0.0",
"/libp2p/autonat/1.0.0",
"/libp2p/circuit/relay/0.1.0",
"/p2p/id/delta/1.0.0",
"/x/"
]
}
网页查看
http://192.186.0.17:5001/webui
会跳转到
http://192.168.0.17:5001/ipfs/bafybeihcyruaeza7uyjd6ugicbcrqumejf6uf353e5etdkhotqffwtguva/#/
示例
直接使用ipfs 上传文件
ubuntu@ubuntu-sol:~/test$ ipfs add test3
added QmTZpQW6Vq65LTHUuJUbrNHmFdgGwP1spTvLRZkQwGmdj9 test3
15 B / 15 B [======================] 100.00%
使用ipfs 上传目录
ubuntu@ubuntu-sol:~/test$ ipfs add -r testdir
added QmSwLYeFSWzifHNypYrkfx39zPXTpGNDLD5WdmLS8hWLot testdir/test2
added QmTZpQW6Vq65LTHUuJUbrNHmFdgGwP1spTvLRZkQwGmdj9 testdir/test3
added QmTqoHrSQuJXdJ4cFgVpv59P1yVjpjcajDqUeWDVSaiaxb testdir
21 B / 21 B [======================] 100.00%
使用HTTP API 上传文件
curl example
curl -X POST -F file=@myfile "http://127.0.0.1:5001/api/v0/add?quiet=<value>&quieter=<value>&silent=<value>&progress=<value>&trickle=<value>&only-hash=<value>&wrap-with-directory=<value>&chunker=size-262144&pin=true&raw-leaves=<value>&nocopy=<value>&fscache=<value>&cid-version=<value>&hash=sha2-256&inline=<value>&inline-limit=32"
上面<value> 是参数的值，需要修改，除了cid-version 是int类型，其他都是bool类型（可以用true/false 或者0/1），参数根据需要使用
参数说明可以参考 IPFS HTTP API http-commands
注意file=@myfile这个@，没有这个@上传的就成了文件名，而不是文件的内容了
下面是上传一个文件名为 tstst 的测试文件的例子
默认情况下可以不加参数
ubuntu@ubuntu-sol:~/test/heihei$ curl -X POST -F file=@tstst "http://127.0.0.1:5001/api/v0/add"
{"Name":"tstst","Hash":"QmfUJdALjZxhsiyBLyccj9sZFpygAEhk5UUfLVCi45rZND","Size":"34"}
ubuntu@ubuntu-sol:~/test/heihei$ ipfs cat /ipfs/QmfUJdALjZxhsiyBLyccj9sZFpygAEhk5UUfLVCi45rZND
This is a ipfs test file.
如上所示，上传成功后可看到文件的Hash值，可以通过这个Hash 去webui查看上传的文件是不是正确的
也可以通过webui上传文件
查看文件的cid为QmVP7TY79k7ozPna5vPnxUANS68kpPdcLs4s7XTtdzN7Vn
通过ipfs的命令获取文件
ipfs cat /ipfs/QmVP7TY79k7ozPna5vPnxUANS68kpPdcLs4s7XTtdzN7Vn > tu.jpg
因为这里上传的是一个图片，直接获取看不到，所以重定向到一个jpg文件查看
使用IPNS
在IPFS中，对一个文件的内容修改后（如升级），会生成一个完全不同的新Hash，使用IPNS就可以利用同一个链接总是指向更新的内容，其实使用也很简单，只需要每次在内容更新之后使用ipfs name publish hash 发布到节点。
ubuntu@ubuntu-sol:~/test$ ipfs name publish QmTZpQW6Vq65LTHUuJUbrNHmFdgGwP1spTvLRZkQwGmdj9
Published to k51qzi5uqu5dlaeb0xwy5kx53q8ofyj036rhn8n529n1js070983cdgu8y3kw5: /ipfs/QmTZpQW6Vq65LTHUuJU$ ipfs name publish QmSwLYeFSWzifHNypYrkfx39zPXTpGNDLD5WdmLS8hWLot
Published to k51qzi5uqu5dlaeb0xwy5kx53q8ofyj036rhn8n529n1js070983cdgu8y3kw5: /ipfs/QmSwLYeFSWzifHNypYrkfx39zPXTpGNDLD5WdmLS8hWLot
这里 QmTZpQW6Vq65LTHUuJUbrNHmFdgGwP1spTvLRZkQwGmdj9 是test3文件的hash，QmSwLYeFSWzifHNypYrkfx39zPXTpGNDLD5WdmLS8hWLot 是test2文件的hash，两次publish后可以看到得到的是相同的地址，k51qzi5uqu5dlaeb0xwy5kx53q8ofyj036rhn8n529n1js070983cdgu8y3kw5，前后两次 访问相同的地址http://192.168.0.17:8080/ipns/k51qzi5uqu5dlaeb0xwy5kx53q8ofyj036rhn8n529n1js070983cdgu8y3kw5 得到的内容分别是test3和test2的内容
也可以通过当前节点ID来访问，就是 ipfs init 命令后生成的 peer identity，通过ipfs id可以查看当前节点ID http://192.168.0.17:8080/ipns/12D3KooWPc2pTzK4VtPnoN8x9dTdGUvUSzVkRX9U7gX6sg7Szoh6 的结果和上面http://192.168.0.17:8080/ipns/k51qzi5uqu5dlaeb0xwy5kx53q8ofyj036rhn8n529n1js070983cdgu8y3kw5的结果是一样的
查看目前链接所指向的文件
ubuntu@ubuntu-sol:~/test$ ipfs name resolve
/ipfs/QmSwLYeFSWzifHNypYrkfx39zPXTpGNDLD5WdmLS8hWLot
如果有多个文件需要使用IPNS，可以新建一key，将不同的文件 publish 到不同的key 上去，上面的k51qzi5uqu5dlaeb0xwy5kx53q8ofyj036rhn8n529n1js070983cdgu8y3kw5其实就是系统生成的默认的key，
# 生成key
ubuntu@ubuntu-sol:~/test/$ ipfs key gen --type=rsa --size=2048 mykey
k2k4r8o5eus56y2m378zzjhuwu6x5rb2p0rv0bg6slb3nt9spzreg6u8
# 使用生成的key publish QmTZpQW6Vq65LTHUuJUbrNHmFdgGwP1spTvLRZkQwGmdj9
ubuntu@ubuntu-sol:~/test$ ipfs name publish -key=mykey QmTZpQW6Vq65LTHUuJUbrNHmFdgGwP1spTvLRZkQwGmdj9
Published to k2k4r8o5eus56y2m378zzjhuwu6x5rb2p0rv0bg6slb3nt9spzreg6u8: /ipfs/QmTZpQW6Vq65LTHUuJUbrNHmFdgGwP1spTvLRZkQwGmdj9
# 使用ipfs name resolve 看到的还是默认的
ubuntu@ubuntu-sol:~/test/heihei$ ipfs name resolve
/ipfs/QmSwLYeFSWzifHNypYrkfx39zPXTpGNDLD5WdmLS8hWLot
# 使用 ipfs name resolve 加 key 可以看到该 key 对应的文件
ubuntu@ubuntu-sol:~/test/heihei$ ipfs name resolve k2k4r8o5eus56y2m378zzjhuwu6x5rb2p0rv0bg6slb3nt9spzreg6u8
/ipfs/QmTZpQW6Vq65LTHUuJUbrNHmFdgGwP1spTvLRZkQwGmdj9
API
https://docs.ipfs.io/reference/http/api/
参考
https://docs.ipfs.io/
https://github.com/ipfs/go-ipfs/tree/v0.10.0#install-prebuilt-binaries
https://github.com/ipfs/go-ipfs/tree/v0.10.0#download-and-compile-ipfs
今天的文章IPFS 搭建_云计算平台搭建与管理「建议收藏」分享到此就结束了，感谢您的阅读。
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 举报，一经查实，本站将立刻删除。
如需转载请保留出处：http://bianchenghao.cn/77843.html
