Linux 服务器部署 IPFS 星际文件系统

三葉Leaves Author

IPFS,又名星际文件系统,是 Web3 技术的重要一环,本文以我自己正在部署的一个区块链项目为例,教你从零开始搭建一个 IPFS Server 并且用在你自己的项目中。

我的部署环境

Debian GNU/Linux12 (bookworm) 2 vCPU 2 GiB
IPFS 官方推荐的配置是 2 c 6 g

安装 IPFS

我参考了官方文档:

关于 kubo

Kubo(之前称为 go-ipfs)是 IPFS 的完整实现,用 Go 语言编写,自带 CLI。它可以在服务器和用户机器上运行,具有完整的 IPFS 功能。你可以安装 IPFS Kubo 或查看 Kubo 的 README

  1. 从 dist.ipfs.tech  下载 Linux 的二进制文件。
1
wget https://dist.ipfs.tech/kubo/v0.34.1/kubo_v0.34.1_linux-amd64.tar.gz
  1. 解压文件:
1
2
3
4
5
6
7
8
tar -xvzf kubo_v0.34.1_linux-amd64.tar.gz

> x kubo/install.sh
> x kubo/ipfs
> x kubo/LICENSE
> x kubo/LICENSE-APACHE
> x kubo/LICENSE-MIT
> x kubo/README.md
  1. 移动到 kubo 文件夹:
1
cd kubo
  1. 运行安装脚本
1
2
3
sudo bash install.sh

> Moved ./ipfs to /usr/local/bin
  1. 测试 Kubo 是否安装正确:
1
2
3
ipfs --version

> ipfs version 0.34.1

启动守护进程

我参考了官方文档:Basic CLI operations with Kubo | IPFS Docs

安装 Kubo 后,我们需要启动我们的节点。如果您是第一次使用 Kubo,您首先需要初始化配置文件:

1
ipfs init

这将输出类似的内容:

1
2
3
4
5
6
initializing ipfs node at /Users/<user>/.ipfs
generating 2048-bit RSA keypair...done
peer identity: Qm...
to get started, enter:

ipfs cat /ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG/readme

现在,我们已经准备好启动 IPFS 守护进程,使节点上线。运行 ipfs daemon 命令:

1
ipfs daemon

这将输出类似的内容:

1
2
3
4
5
6
Initializing daemon...
Kubo version: 0.12.0
Repo version: 12
System version: arm64/darwin
[...]
Daemon is ready

会占用的端口

IPFS 默认会用下面这些端口,要使用 IPFS ,你可以选择开放他们:

  • 4001: IPFS P2P 节点通信
  • 5001: IPFS 的 webui && API
  • 8080: IPFS 的网关

某些时候,前端会用到 8080,这样一来就和 IPFS 冲突了,我们可以改一下 IPFS 默认的网关端口

1
ipfs config Addresses.Gateway /ip4/0.0.0.0/tcp/8081
  • 标题: Linux 服务器部署 IPFS 星际文件系统
  • 作者: 三葉Leaves
  • 创建于 : 2025-04-18 00:00:00
  • 更新于 : 2025-04-25 00:07:45
  • 链接: https://blog.oksanye.com/35f62ad750b9/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
评论
目录
Linux 服务器部署 IPFS 星际文件系统