一、go环境搭建、 安装Docker
sudo tar -zvxf go1.6.2.linux-amd64.tar.gz
sudo mv go /usr/local/go
#设置环境变量
vi /etc/profile
export GOROOT=/usr/local/go
export GOPATH=$HOME/gocode
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
source /etc/profile
- 更新系统软件包:`sudo yum update`
- 安装Docker的依赖包:`sudo yum install -y yum-utils device-mapper-persistent-data lvm2`
- 添加Docker的官方GPG密钥:`sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo`
- 安装Docker:`sudo yum install docker-ce`
- 启动Docker服务:`sudo systemctl start docker`
- 设置Docker开机自启:`sudo systemctl enable docker`
- 验证Docker安装是否成功:`sudo docker run hello-world`
二、生成共享秘钥
搭建IPFS私有网络,首先需要使所有节点共享一个密钥swarm.key。
git clone https://github.com/Kubuxu/go-ipfs-swarm-key-gen.git
cd go-ipfs-swarm-key-gen
go run main.go > swarm.key
三、网络搭建
拉取镜像
docker pull ipfs/go-ipfs:latest
启动节点
- 准备工作
首先,分别创建两个节点目录node1和node2。
其次,在node1和node2目录下再创建ipfs_staging和ipfs_data目录。
最后,把swarm.key文件分别放置node1和node2目录下。 - 启动节点1
进入node1目录,并执行命令
**
# 启动命令
docker run -d --name ipfs_node1 -e IPFS_SWARM_KEY_FILE=$PWD/swarm.key -v $PWD/ipfs_staging:/export -v $PWD/ipfs_data:/data/ipfs -p 4001:4001 -p 8081:8080 -p 5001:5001 ipfs/go-ipfs:latest
# 清除容器默认的bootstrap
docker exec -it ipfs_node1 ipfs bootstrap rm --all
查看启动日志:
**
oot@OCI-SIN01-050-ops-bsnbase-com:/bsn/ipfs/node1# docker logs ipfs_node1
Changing user to ipfs
ipfs version 0.25.0
Found IPFS fs-repo at /data/ipfs
Initializing daemon...
Kubo version: 0.25.0-413a52d
Repo version: 15
System version: amd64/linux
Golang version: go1.21.5
2024/01/22 08:59:56 failed to sufficiently increase receive buffer size (was: 208 kiB, wanted: 2048 kiB, got: 416 kiB). See https://github.com/quic-go/quic-go/wiki/UDP-Buffer-Sizes for details.
Swarm listening on /ip4/127.0.0.1/tcp/4001
Swarm listening on /ip4/127.0.0.1/udp/4001/quic-v1
Swarm listening on /ip4/127.0.0.1/udp/4001/quic-v1/webtransport/certhash/uEiBMxbXF0Z5PsoeOBaUmDYj8T0ZgI2bRAHKgFHtzTW926A/certhash/uEiCVGlB0BZI5VJeO9JxnQ7yxr6HO0jDW3HdWmr6Pssz6Vg
Swarm listening on /ip4/172.17.0.2/tcp/4001
Swarm listening on /ip4/172.17.0.2/udp/4001/quic-v1
Swarm listening on /ip4/172.17.0.2/udp/4001/quic-v1/webtransport/certhash/uEiBMxbXF0Z5PsoeOBaUmDYj8T0ZgI2bRAHKgFHtzTW926A/certhash/uEiCVGlB0BZI5VJeO9JxnQ7yxr6HO0jDW3HdWmr6Pssz6Vg
Swarm listening on /p2p-circuit
Swarm announcing /ip4/120.26.92.83/tcp/4001
Swarm announcing /ip4/127.0.0.1/tcp/4001
Swarm announcing /ip4/127.0.0.1/udp/4001/quic-v1
Swarm announcing /ip4/127.0.0.1/udp/4001/quic-v1/webtransport/certhash/uEiBMxbXF0Z5PsoeOBaUmDYj8T0ZgI2bRAHKgFHtzTW926A/certhash/uEiCVGlB0BZI5VJeO9JxnQ7yxr6HO0jDW3HdWmr6Pssz6Vg
Swarm announcing /ip4/172.17.0.2/tcp/4001
Swarm announcing /ip4/172.17.0.2/udp/4001/quic-v1
Swarm announcing /ip4/172.17.0.2/udp/4001/quic-v1/webtransport/certhash/uEiBMxbXF0Z5PsoeOBaUmDYj8T0ZgI2bRAHKgFHtzTW926A/certhash/uEiCVGlB0BZI5VJeO9JxnQ7yxr6HO0jDW3HdWmr6Pssz6Vg
RPC API server listening on /ip4/0.0.0.0/tcp/5001
WebUI: http://0.0.0.0:5001/webui
Gateway server listening on /ip4/0.0.0.0/tcp/8080
Daemon is ready
删除默认节点日志:
**
root@OCI-SIN01-050-ops-bsnbase-com:/bsn/ipfs/node1# docker exec -it ipfs_node1 ipfs bootstrap rm --all
ipfs: Reading from /dev/stdin; send Ctrl-d to stop.
removed /dnsaddr/bootstrap.libp2p.io/p2p/QmNnooDu7bfjPFoTZYxMNLWUQJyrVwtbZg5gBMjTezGAJN
removed /dnsaddr/bootstrap.libp2p.io/p2p/QmQCU2EcMqAqQPR2i9bChDtGNJchTbq5TbXJJ16u19uLTa
removed /dnsaddr/bootstrap.libp2p.io/p2p/QmbLHAnMoJPWSCR5Zhtx6BHJX9KiKNN6tpvbUcqanj75Nb
removed /dnsaddr/bootstrap.libp2p.io/p2p/QmcZf59bWwK5XFi76CZX8cbJ4BhTzzA3gU1ZjYZcYW3dwt
removed /ip4/104.131.131.82/tcp/4001/p2p/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ
removed /ip4/104.131.131.82/udp/4001/quic/p2p/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ
root@OCI-SIN01-050-ops-bsnbase-com:/bsn/ipfs/node1#
- 启动节点2
进入node2目录,并执行命令
**
# 启动命令
docker run -d --name ipfs_node2 -e IPFS_SWARM_KEY_FILE=$PWD/swarm.key -v $PWD/ipfs_staging:/export -v $PWD/ipfs_data:/data/ipfs -p 4002:4001 -p 8082:8080 -p 5002:5001 ipfs/go-ipfs:latest
# 清除容器默认的bootstrap
docker exec -it ipfs_node2 ipfs bootstrap rm --all
# 查看node1的id信息
docker exec ipfs_node2 ipfs id
启动日志:
**
root@OCI-SIN01-050-ops-bsnbase-com:/bsn/ipfs/node2# docker logs ipfs_node2
Changing user to ipfs
ipfs version 0.25.0
Found IPFS fs-repo at /data/ipfs
Initializing daemon...
Kubo version: 0.25.0-413a52d
Repo version: 15
System version: amd64/linux
Golang version: go1.21.5
2024/01/22 09:03:14 failed to sufficiently increase receive buffer size (was: 208 kiB, wanted: 2048 kiB, got: 416 kiB). See https://github.com/quic-go/quic-go/wiki/UDP-Buffer-Sizes for details.
Swarm listening on /ip4/127.0.0.1/tcp/4001
Swarm listening on /ip4/127.0.0.1/udp/4001/quic-v1
Swarm listening on /ip4/127.0.0.1/udp/4001/quic-v1/webtransport/certhash/uEiA0kc9qjqS2UdyRg1SKeaHPi85pB4fuGFMYawtWPqVyxA/certhash/uEiAi4k7gTTl_xomqgoYEfg6eeN3eoxgiGK13cadJoIEF0w
Swarm listening on /ip4/172.17.0.3/tcp/4001
Swarm listening on /ip4/172.17.0.3/udp/4001/quic-v1
Swarm listening on /ip4/172.17.0.3/udp/4001/quic-v1/webtransport/certhash/uEiA0kc9qjqS2UdyRg1SKeaHPi85pB4fuGFMYawtWPqVyxA/certhash/uEiAi4k7gTTl_xomqgoYEfg6eeN3eoxgiGK13cadJoIEF0w
Swarm listening on /p2p-circuit
Swarm announcing /ip4/127.0.0.1/tcp/4001
Swarm announcing /ip4/127.0.0.1/udp/4001/quic-v1
Swarm announcing /ip4/127.0.0.1/udp/4001/quic-v1/webtransport/certhash/uEiA0kc9qjqS2UdyRg1SKeaHPi85pB4fuGFMYawtWPqVyxA/certhash/uEiAi4k7gTTl_xomqgoYEfg6eeN3eoxgiGK13cadJoIEF0w
Swarm announcing /ip4/172.17.0.3/tcp/4001
Swarm announcing /ip4/172.17.0.3/udp/4001/quic-v1
Swarm announcing /ip4/172.17.0.3/udp/4001/quic-v1/webtransport/certhash/uEiA0kc9qjqS2UdyRg1SKeaHPi85pB4fuGFMYawtWPqVyxA/certhash/uEiAi4k7gTTl_xomqgoYEfg6eeN3eoxgiGK13cadJoIEF0w
RPC API server listening on /ip4/0.0.0.0/tcp/5001
WebUI: http://0.0.0.0:5001/webui
Gateway server listening on /ip4/0.0.0.0/tcp/8080
Daemon is ready
删除默认节点日志:
**
root@OCI-SIN01-050-ops-bsnbase-com:/bsn/ipfs/node2# docker exec -it ipfs_node2 sh
/ # ipfs bootstrap list
/dnsaddr/bootstrap.libp2p.io/p2p/QmNnooDu7bfjPFoTZYxMNLWUQJyrVwtbZg5gBMjTezGAJN
/dnsaddr/bootstrap.libp2p.io/p2p/QmQCU2EcMqAqQPR2i9bChDtGNJchTbq5TbXJJ16u19uLTa
/dnsaddr/bootstrap.libp2p.io/p2p/QmbLHAnMoJPWSCR5Zhtx6BHJX9KiKNN6tpvbUcqanj75Nb
/dnsaddr/bootstrap.libp2p.io/p2p/QmcZf59bWwK5XFi76CZX8cbJ4BhTzzA3gU1ZjYZcYW3dwt
/ip4/104.131.131.82/tcp/4001/p2p/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ
/ip4/104.131.131.82/udp/4001/quic/p2p/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ
/ # ipfs bootstrap rm --all
removed /dnsaddr/bootstrap.libp2p.io/p2p/QmNnooDu7bfjPFoTZYxMNLWUQJyrVwtbZg5gBMjTezGAJN
removed /dnsaddr/bootstrap.libp2p.io/p2p/QmQCU2EcMqAqQPR2i9bChDtGNJchTbq5TbXJJ16u19uLTa
removed /dnsaddr/bootstrap.libp2p.io/p2p/QmbLHAnMoJPWSCR5Zhtx6BHJX9KiKNN6tpvbUcqanj75Nb
removed /dnsaddr/bootstrap.libp2p.io/p2p/QmcZf59bWwK5XFi76CZX8cbJ4BhTzzA3gU1ZjYZcYW3dwt
removed /ip4/104.131.131.82/tcp/4001/p2p/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ
removed /ip4/104.131.131.82/udp/4001/quic/p2p/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ
/ #
- 添加bootstrap节点
查看node1的id信息
**
root@OCI-SIN01-050-ops-bsnbase-com:/bsn/ipfs/node1# docker exec ipfs_node1 ipfs id
{
"ID": "12D3KooWSx8QTS5cXEXHB7in3oZqk3AYymamv6RECp97SM41dJar",
"PublicKey": "CAESIP6Twv3Z/IAdyoy+HhO0zfDScpqMVB/mHEfC4aeLD1MP",
"Addresses": [
"/ip4/120.26.92.83/tcp/4001/p2p/12D3KooWSx8QTS5cXEXHB7in3oZqk3AYymamv6RECp97SM41dJar",
"/ip4/127.0.0.1/tcp/4001/p2p/12D3KooWSx8QTS5cXEXHB7in3oZqk3AYymamv6RECp97SM41dJar",
"/ip4/127.0.0.1/udp/4001/quic-v1/p2p/12D3KooWSx8QTS5cXEXHB7in3oZqk3AYymamv6RECp97SM41dJar",
"/ip4/127.0.0.1/udp/4001/quic-v1/webtransport/certhash/uEiBMxbXF0Z5PsoeOBaUmDYj8T0ZgI2bRAHKgFHtzTW926A/certhash/uEiCVGlB0BZI5VJeO9JxnQ7yxr6HO0jDW3HdWmr6Pssz6Vg/p2p/12D3KooWSx8QTS5cXEXHB7in3oZqk3AYymamv6RECp97SM41dJar",
"/ip4/172.17.0.2/tcp/4001/p2p/12D3KooWSx8QTS5cXEXHB7in3oZqk3AYymamv6RECp97SM41dJar",
"/ip4/172.17.0.2/udp/4001/quic-v1/p2p/12D3KooWSx8QTS5cXEXHB7in3oZqk3AYymamv6RECp97SM41dJar",
"/ip4/172.17.0.2/udp/4001/quic-v1/webtransport/certhash/uEiBMxbXF0Z5PsoeOBaUmDYj8T0ZgI2bRAHKgFHtzTW926A/certhash/uEiCVGlB0BZI5VJeO9JxnQ7yxr6HO0jDW3HdWmr6Pssz6Vg/p2p/12D3KooWSx8QTS5cXEXHB7in3oZqk3AYymamv6RECp97SM41dJar"
],
"AgentVersion": "kubo/0.25.0/413a52d/docker",
"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/kad/1.0.0",
"/ipfs/lan/kad/1.0.0",
"/ipfs/ping/1.0.0",
"/libp2p/autonat/1.0.0",
"/libp2p/circuit/relay/0.2.0/hop",
"/libp2p/circuit/relay/0.2.0/stop",
"/libp2p/dcutr",
"/x/"
]
}
查看node2的id信息
**
root@OCI-SIN01-050-ops-bsnbase-com:/bsn/ipfs/node2# docker exec ipfs_node2 ipfs id
{
"ID": "12D3KooWAfNAS3f8bMEVoaUfDzkxVThf6YYViGUYhZxfZZ7kc6PN",
"PublicKey": "CAESIAyNdBzm1QfrcEHLG12XI1zxNkGQ1G8WIozZhG7pANGt",
"Addresses": [
"/ip4/111.67.199.115/tcp/4001/p2p/12D3KooWHSg8vYB3rE53HviM9XFnsi9AismKzAwhUiHNfR9XoYkU/p2p-circuit/p2p/12D3KooWAfNAS3f8bMEVoaUfDzkxVThf6YYViGUYhZxfZZ7kc6PN",
"/ip4/111.67.199.115/udp/4001/quic-v1/webtransport/certhash/uEiCYvcxI2As1fs96VLvL7i30t8ZNAqD0Nz221tu82EmcYQ/certhash/uEiACZSLgWC4FiOxkL4o3-0OAVFQSkM5f1Q-8Gtw5z26mvQ/p2p/12D3KooWHSg8vYB3rE53HviM9XFnsi9AismKzAwhUiHNfR9XoYkU/p2p-circuit/p2p/12D3KooWAfNAS3f8bMEVoaUfDzkxVThf6YYViGUYhZxfZZ7kc6PN",
"/ip4/127.0.0.1/tcp/4001/p2p/12D3KooWAfNAS3f8bMEVoaUfDzkxVThf6YYViGUYhZxfZZ7kc6PN",
"/ip4/127.0.0.1/udp/4001/quic-v1/p2p/12D3KooWAfNAS3f8bMEVoaUfDzkxVThf6YYViGUYhZxfZZ7kc6PN",
"/ip4/127.0.0.1/udp/4001/quic-v1/webtransport/certhash/uEiAi4k7gTTl_xomqgoYEfg6eeN3eoxgiGK13cadJoIEF0w/certhash/uEiAtEyP0-LQnKLeWyadDEj89awA9ADpP37Tgs4EvBascDg/p2p/12D3KooWAfNAS3f8bMEVoaUfDzkxVThf6YYViGUYhZxfZZ7kc6PN",
"/ip4/172.17.0.3/tcp/4001/p2p/12D3KooWAfNAS3f8bMEVoaUfDzkxVThf6YYViGUYhZxfZZ7kc6PN",
"/ip4/172.17.0.3/udp/4001/quic-v1/p2p/12D3KooWAfNAS3f8bMEVoaUfDzkxVThf6YYViGUYhZxfZZ7kc6PN",
"/ip4/172.17.0.3/udp/4001/quic-v1/webtransport/certhash/uEiAi4k7gTTl_xomqgoYEfg6eeN3eoxgiGK13cadJoIEF0w/certhash/uEiAtEyP0-LQnKLeWyadDEj89awA9ADpP37Tgs4EvBascDg/p2p/12D3KooWAfNAS3f8bMEVoaUfDzkxVThf6YYViGUYhZxfZZ7kc6PN",
"/ip4/31.14.252.66/tcp/4001/p2p/12D3KooWFgzeEtnQ5kb8X58yT4gWKbkcrkHUapFFhuX84UxuvtXb/p2p-circuit/p2p/12D3KooWAfNAS3f8bMEVoaUfDzkxVThf6YYViGUYhZxfZZ7kc6PN",
"/ip6/64:ff9b::1f0e:fc42/tcp/4001/p2p/12D3KooWFgzeEtnQ5kb8X58yT4gWKbkcrkHUapFFhuX84UxuvtXb/p2p-circuit/p2p/12D3KooWAfNAS3f8bMEVoaUfDzkxVThf6YYViGUYhZxfZZ7kc6PN"
],
"AgentVersion": "kubo/0.25.0/413a52d/docker",
"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/circuit/relay/0.2.0/stop",
"/libp2p/dcutr",
"/x/"
]
}
分别在两个节点进行bootstrap添加
tips: 仅在一个节点另一个节点可以,会自动发现。但建议多节点时添加多个引导节点。
**
# 在节点1的bootstrap添加将节点2的地址信息。
# 注意端口号4001需要改成4002
docker exec -it ipfs_node1 ipfs bootstrap add /ip4/111.67.199.115/tcp/4002/p2p/12D3KooWAfNAS3f8bMEVoaUfDzkxVThf6YYViGUYhZxfZZ7kc6PN
# 在节点2的bootstrap添加将节点1的地址信息。
docker exec -it ipfs_node1 ipfs bootstrap add /ip4/111.67.199.115/tcp/4001/p2p/12D3KooWSx8QTS5cXEXHB7in3oZqk3AYymamv6RECp97SM41dJar
至此,两个节点的网络搭建完成!!!
四、测试网络
cli 方式
在node1上传一个测试文件'test.txt',再node2进行下载
- node1 添加文件
root@OCI-SIN01-050-ops-bsnbase-com:/opt/ipfs/node1# docker exec ipfs_node1 ipfs add /data/ipfs/test.txt
23 B / 23 B 100.00%added QmUwbXRZW5T3yUbAitkLKMPrh1R8iPkQWtqwsRPYRaZbNY test.txt
- node2下载文件
# 查看文件
root@OCI-SIN01-050-ops-bsnbase-com:/opt/ipfs/node2# docker exec ipfs_node2 ipfs cat QmUwbXRZW5T3yUbAitkLKMPrh1R8iPkQWtqwsRPYRaZbNY
文件内容---测试
# 下载文件
root@OCI-SIN01-050-ops-bsnbase-com:/opt/ipfs/node2/ipfs_data# ll
total 20
drwxr-xr-x 5 opc root 147 Aug 24 16:58 ./
drwxr-xr-x 4 root root 60 Aug 24 15:48 ../
-rw-r--r-- 1 opc users 23 Aug 24 16:56 api
drwxr-xr-x 5 opc users 93 Aug 24 17:30 blocks/
-rw------- 1 opc users 3053 Aug 24 16:58 config
drwxr-xr-x 2 opc users 122 Aug 24 16:56 datastore/
-rw------- 1 opc users 190 Aug 24 16:54 datastore_spec
-rw-r--r-- 1 opc users 21 Aug 24 16:56 gateway
drwx------ 2 opc users 6 Aug 24 16:54 keystore/
-rw-r--r-- 1 opc users 0 Aug 24 16:56 repo.lock
-rw-r--r-- 1 opc users 3 Aug 24 16:54 version
root@OCI-SIN01-050-ops-bsnbase-com:/opt/ipfs/node2/ipfs_data# docker exec ipfs_node2 ipfs get QmUwbXRZW5T3yUbAitkLKMPrh1R8iPkQWtqwsRPYRaZbNY -o /data/ipfs/test.txt
Saving file(s) to /data/ipfs/test.txt
34 B / 34 B 100.00% 0s
root@OCI-SIN01-050-ops-bsnbase-com:/opt/ipfs/node2/ipfs_data# ll
total 24
drwxr-xr-x 5 opc root 169 Aug 24 17:32 ./
drwxr-xr-x 4 root root 60 Aug 24 15:48 ../
-rw-r--r-- 1 opc users 23 Aug 24 16:56 api
drwxr-xr-x 5 opc users 93 Aug 24 17:30 blocks/
-rw------- 1 opc users 3053 Aug 24 16:58 config
drwxr-xr-x 2 opc users 122 Aug 24 16:56 datastore/
-rw------- 1 opc users 190 Aug 24 16:54 datastore_spec
-rw-r--r-- 1 opc users 21 Aug 24 16:56 gateway
drwx------ 2 opc users 6 Aug 24 16:54 keystore/
-rw-r--r-- 1 opc users 0 Aug 24 16:56 repo.lock
-rw-r--r-- 1 opc users 3 Aug 24 16:54 version
-rw------- 1 root root 34 Aug 24 17:32 test.txt
root@OCI-SIN01-050-ops-bsnbase-c
API方式
使用postman 工具 https://ip:5001/api/v0/add
-
上传文件
五、使用内置的webui系统
1、使用ipfs desktop
2、使用浏览器
参考: 解决跨域问题
node1、node2 分别执行:
docker exec ipfs_node1 ipfs config --json API.HTTPHeaders.Access-Control-Allow-Origin '["http://外网ip:5001","http://内网IP:5001"]'
docker exec ipfs_node1 ipfs config --json API.HTTPHeaders.Access-Control-Allow-Methods '["PUT", "POST"]'