手把手教你搭建IPFS私有网络与使用(附IPFS API参考文档)
在联盟链的场景下,IPFS 作为去中心化存储的首选方案,本文将介绍如何使用go-ipfs搭建一个私有网络并进行简单使用。
我的环境
由于资源限制,我这里使用docker来搭建一个两个节点的 IPFS 私有网络。如果有条件可以直接在多台机器或者多个虚拟机上安装。
开始搭建
1、生成 swarm.key
swarm.key 是一个共享密钥,只有拥有相同密钥的节点才能互相通信,组成一个私钥网络。swarm.key 可以使用 工具 生成,工具的安装命令是:
go get -u github.com/Kubuxu/go-ipfs-swarm-key-gen/ipfs-swarm-key-gen
安装完成后,生成 swarm.key,命令是:
ipfs-swarm-key-gen > /Users/sixdays/tmp/ipfs/swarm.key
其中
- /Users/sixdays/tmp/ipfs/ 目录是我 ipfs 目录。
- /Users/sixdays/tmp/ipfs/node1 是我 ipfs 节点 1 目录。
- /Users/sixdays/tmp/ipfs/node2 是我 ipfs 节点 2 目录。
2、启动节点
运行节点 1 和节点 2
// 运行节点 1 docker run -d --name ipfs_node_1 -e IPFS_SWARM_KEY_FILE=/Users/sixdays/tmp/ipfs/swarm.key -v /Users/sixdays/tmp/ipfs/node1/staging:/export -v /Users/sixdays/tmp/ipfs/node1/data:/data/ipfs -p 4001:4001 -p 4001:4001/udp -p 127.0.0.1:8080:8080 -p 127.0.0.1:5001:5001 ipfs/go-ipfs:latest // 运行节点 2 docker run -d --name ipfs_node_2 -e IPFS_SWARM_KEY_FILE=/Users/sixdays/tmp/ipfs/swarm.key -v /Users/sixdays/tmp/ipfs/node2/staging:/export -v /Users/sixdays/tmp/ipfs/node2/data:/data/ipfs -p 4002:4001 -p 4002:4001/udp -p 127.0.0.1:8081:8080 -p 127.0.0.1:5002:5001 ipfs/go-ipfs:latest
清除所有缺省启动节点 bootstrap
docker exec ipfs_node_1 ipfs bootstrap rm all docker exec ipfs_node_2 ipfs bootstrap rm all
查看节点 id
docker exec ipfs_node_1 ipfs id docker exec ipfs_node_2 ipfs id
这里,我节点 1 的 Id 是 :
12D3KooWEVo8FqH8YUT1noXvca5hgSRWBRcDQomEcFY2zXwA7dbw
节点 1 的 address 是:
/ip4/172.17.0.3/tcp/4001/p2p/12D3KooWEVo8FqH8YUT1noXvca5hgSRWBRcDQomEcFY2zXwA7dbw
节点 2 的 Id 是
12D3KooWRcx6gpbsbvb6YiNsDpJgnmNHFCgCiUmVF42o4zn2W5Pj
节点 2 的 address 是
/ip4/172.17.0.4/tcp/4001/p2p/12D3KooWRcx6gpbsbvb6YiNsDpJgnmNHFCgCiUmVF42o4zn2W5Pj
节点的 address 我用的是 docker 给分配的 ip 地址。
添加节点 id
在节点 1 中添加节点 2 地址
docker exec ipfs_node_1 ipfs bootstrap add /ip4/172.17.0.4/tcp/4001/p2p/12D3KooWRcx6gpbsbvb6YiNsDpJgnmNHFCgCiUmVF42o4zn2W5Pj
在节点 2 中添加节点 1 地址
docker exec ipfs_node_1 ipfs bootstrap add /ip4/172.17.0.3/tcp/4001/p2p/12D3KooWEVo8FqH8YUT1noXvca5hgSRWBRcDQomEcFY2zXwA7dbw
至此,我们 2 个节点的 IPFS 私有网络已搭建完成。
用一下
使用命令
docker exec ipfs_node_1 ipfs -h
可以看到 IPFS 的基础命令。
添加文件 add
$ docker exec ipfs_node_1 ipfs add /data/ipfs/swarm.key added QmRitSEMhFJtNhLYtwGRJvhDrTTT4gQLjuLepZjo9C8a2X swarm.key
其中 :
- /data/ipfs/swarm.key 为 ipfs_node_1 容器的目录。
- QmRitSEMhFJtNhLYtwGRJvhDrTTT4gQLjuLepZjo9C8a2X 为文件 hash
查看文件 cat
$ docker exec ipfs_node_2 ipfs cat QmRitSEMhFJtNhLYtwGRJvhDrTTT4gQLjuLepZjo9C8a2X /key/swarm/psk/1.0.0/ /base16/ 5b9941085678c502b44cc98e2614dd648cb801115dcb6acee8e83d9bf8cf454c
可以看到我们可以在 node2 中查看到 node1 上传的文件内容。
下载文件 get
$ docker exec ipfs_node_2 ipfs get QmRitSEMhFJtNhLYtwGRJvhDrTTT4gQLjuLepZjo9C8a2X -o /data/ipfs/test.key Saving file(s) to /data/ipfs/test.key 95 B / 95 B 100.00% 0s
其中 -o 表示输出目录,docker 容器中的 /data/ipfs 对应我们主机目录为 /Users/sixdays/tmp/ipfs/node2/data
查看文件列表 ls
$ docker exec ipfs_node_2 ipfs pin ls QmQ5vhrL7uv6tuoN9KeVBwd4PwfQkXdVVmDLUZuTNxqgvm indirect QmU5k7ter3RdjZXu3sHghsga1UQtrztnQxmTL22nPnsu3g indirect QmYCvbfNbCwFR45HiNP45rwJgvatpiW38D961L5qAhUM5Y indirect QmejvEPop4D7YUadeGqYWmZxHhLc4JBUCzJJHWMzdcMe2y indirect QmPZ9gcCEpqKTo6aq61g2nXGUhM4iCL3ewB6LDXZCtioEB indirect QmQGiYLVAdSHJQKYFRTJZMG4BXBHqKperaZtyKGmCRLmsF indirect QmQPeNsJPyVWPFDVHb77w8G42Fvo15z4bG2X8D2GhfbSXc recursive QmQy6xmJhrcC5QLboAcGFcAE1tC8CrwDVkrHdEYJkLscrQ indirect QmUNLLsPACCz1vLxQVkXqqLX5R1X345qqfHbsf67hvA3Nn recursive
其中 recursive 表示文件夹,indirect 表示文件
参考:IPFS API参考文档
到此这篇关于手把手教你搭建IPFS私有网络与使用(附IPFS API参考文档)的文章就介绍到这了,更多相关搭建IPFS私有网络内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!
你可能感兴趣的文章
-
2026最野DeFi收益策略:不赌暴涨,吃尽链上投机手续费
感觉 DeFi 夏日又回来了,但大多数高风险投机者忙着在 Meme 币上亏钱,而不是靠这些投机者亏的钱来赚钱,你无需持有 Meme 币,也可以从这些投机者的亏损中挖矿获利, 我觉得这…
2026-09-03 -
Robinhood Chain新手完全指南:能做什么、用什么工具、要注意什么风险(
作为基于Arbitrum技术构建的以太坊Layer 2,Robinhood Chain最初的定位并不是单纯承载加密资产,而是试图把股票、ETF、稳定币、DeFi、Meme以及AI Agent等资产和应用放到同…
2026-09-03 -
Robinhood Chain目前有哪些主要协议? 一文看懂Robinhood Chain的生态地
作为基于Arbitrum技术构建的以太坊Layer 2,Robinhood Chain最初的定位并不是单纯承载加密资产,而是试图把多个资产放到同一条链上,本文梳理了Robinhood Chain目前有哪些…
2026-09-03 -
什么是模块化区块链?优势、挑战及安全性解析
模块化区块链是一种将交易处理、共识、数据可用性等功能拆分到不同专业层的区块链设计,文章用初、中、高三种模式,对比了它与传统单片区块链在可扩展性、灵活性、安全性和…
2026-09-02 -
什么是云挖矿?运作原理、适用币种与投资风险解析
云挖矿是租用远程矿场算力参与 PoW 币种挖矿的模式,降低挖矿硬件门槛,本文解析云挖矿运作逻辑,梳理优势、潜在风险、适配币种,同时拆解影响收益的关键要素,帮助用户客观…
2026-09-02 -
Fomo App使用完整指南:社交型交易 、手续费与风险分析
Fomo 是一款移动端与网页端 trading 应用,旨在将复杂的区块链底层技术隐藏在消费者友好的界面之下,本文深入解析Fomo的社交交易功能、手续费规则与潜在风险,需要的朋友可…
2026-09-01 -
FOMO实用教程:从找人到找币,Social Trading怎么玩?
以前主要是 Meme 玩家在用,最近已经看到不少做二级、今天 @seyong 说,FOMO 现在平均每分钟有 30 个新用户加入,但很多人注册之后,面对一堆英文页面其实不知道该怎么看,所…
2026-09-01 -
八层资产、两种逻辑:Robinhood Chain财富效应全拆解
Robinhood Chain 上线两个月 TVL 破 10 亿美元,但因其无原生 Gas 代币,生态价值分散在八个资产层级中,投资者需根据价值捕获路径的清晰度而非短期涨幅进行分层布局,本文…
2026-09-01 -
目前有多少个股票板块?股票板块简介与分类方式全面介绍
无论您是进行个股交易,还是构建长期投资组合,了解板块的运作逻辑都是做出明智投资决策的第一步,本文将介绍 11 个主要股票板块、它们的分类方式,以及板块意识为何对每一…
2026-09-01 -
跨链交换与加密桥:有什么区别?差异、风险与适用场景对比
加密跨链桥与跨链交换是两种跨链方案,本文介绍二者工作原理,对比操作流程、成本与风险差异,跨链桥适合转移同种资产,跨链交换可直接兑换不同资产,用户应结合自身需求合…
2026-08-31










