Repolode
提交项目
ipfs

ipfs/kubo

Kubo 是 IPFS 的原始 Go 语言实现，提供按内容寻址存储和分发数据的守护进程、命令行工具、HTTP 网关与 RPC API。

在 GitHub 查看官网
Star
17,151
Fork
3,175
未关闭 Issue
879
最近提交
11小时前

这是什么？

Kubo 运行一个 IPFS 节点，按数据的内容哈希而非存放位置来存储、获取和分发数据。文件与目录使用 UnixFS 表示，节点之间通过 Bitswap 和 HTTP 交换数据块，并借助局域网 mDNS 与广域网 Amino DHT 发现彼此。

除守护进程外，Kubo 还提供命令行工具、用于节点管理的 WebUI、支持可信与无信任检索的 HTTP 网关，以及用于控制节点的 HTTP RPC API。它还包含 HTTP Routing V1 的客户端与服务端，用于委托路由；实验性的 FUSE 挂载可将 /ipfs、/ipns 和 /mfs 暴露为本地文件系统。

Kubo 可通过预编译二进制、Docker 镜像、社区维护的包管理器或使用 Go 从源码构建安装。公共节点运营者还可以通过拒绝列表进行内容屏蔽。

核心功能

  • 01在局域网（mDNS）与广域网（Amino DHT）上运行 IPFS 节点
  • 02命令行工具用于添加、读取和管理内容
  • 03支持可信与无信任两种模式的 HTTP 网关
  • 04HTTP RPC API 用于控制守护进程
  • 05HTTP Routing V1 客户端与服务端，支持委托路由
  • 06实验性 FUSE 挂载，可将 /ipfs、/ipns 和 /mfs 作为本地文件系统

适用场景

  • 通过 IPFS 托管和分发文件或静态网站
  • 运行公共网关或固定（pinning）节点以保证内容可用
  • 基于 RPC API 构建使用内容寻址存储的应用
  • 在本地网络中实验 IPFS 协议与内容寻址

快速上手

  1. 1

    安装 Kubo（macOS 使用 Homebrew）

    brew install ipfs
  2. 2

    初始化节点

    ipfs init --profile=unixfs-v1-2025
  3. 3

    启动守护进程

    ipfs daemon

使用前须知

  • 目前没有专职维护者，Shipyard 团队的维护工作已于 2026 年 9 月 30 日结束。
  • 推荐配置至少需要 6 GB 内存和 2 个 CPU 核心，更大的固定集需要更多内存。
  • FUSE 挂载功能仍处于实验阶段。

标签

#ipfs#peer-to-peer#distributed-storage#content-addressing#go#decentralized#http-gateway

常见问题

kubo 是什么？
Kubo 是 IPFS 的原始 Go 语言实现，提供按内容寻址存储和分发数据的守护进程、命令行工具、HTTP 网关与 RPC API。 Kubo 运行一个 IPFS 节点，按数据的内容哈希而非存放位置来存储、获取和分发数据。文件与目录使用 UnixFS 表示，节点之间通过 Bitswap 和 HTTP 交换数据块，并借助局域网 mDNS 与广域网 Amino DHT 发现彼此。
kubo 可以免费使用吗？用的什么许可证？
kubo 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。
kubo 还在维护吗？
活跃维护中。kubo 最近一次提交是在 2026年10月21日。
kubo 适合用来做什么？
通过 IPFS 托管和分发文件或静态网站 运行公共网关或固定（pinning）节点以保证内容可用 基于 RPC API 构建使用内容寻址存储的应用 在本地网络中实验 IPFS 协议与内容寻址
kubo 怎么安装和运行？
安装 Kubo（macOS 使用 Homebrew）: brew install ipfs 初始化节点: ipfs init --profile=unixfs-v1-2025 启动守护进程: ipfs daemon
在哪里获取 kubo？
源代码和安装说明在 GitHub 上：https://github.com/ipfs/kubo

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目