ipfs/kubo

Kubo: IPFS的Go语言实现

!Kubo logo

IPFS的首个实现。

什么是Kubo？

Kubo是第一个IPFS实现，也是目前使用最广泛的实现。它实现了星际文件系统（IPFS）——Web上内容寻址的标准，可与HTTP互操作。基于面向未来的数据模型和用于网络通信的libp2p构建，Kubo使用Go语言编写。

功能集

• 运行IPFS节点作为网络服务，属于LAN和WAN DHT的一部分
• 原生支持UnixFS（IPFS上表示文件和目录的最流行方式）
• HTTP网关（/ipfs 和 /ipns）功能，用于可信和无信任内容检索
• HTTP路由V1（/routing/v1）客户端和服务器实现，用于委托路由查找
• HTTP Kubo RPC API（/api/v0），用于访问和控制守护进程
• 基于（/api/v0）RPC API的命令行界面
• 用于管理Kubo节点的https://github.com/ipfs/ipfs-webui/#readme
• 为公共节点运营商提供指标和内容阻止支持

Docker文档

• https://github.com/ipfs/kubo#readme
• 在Docker中运行IPFS
  • 设置
  • 通过在容器的/container-init.d目录中挂载脚本来自定义节点

基本使用方法

使用docker run运行Kubo节点

bash
docker run -d --name ipfs_host -v /path/to/ipfs/data:/data/ipfs -p 4001:4001 -p 127.0.0.1:8080:8080 -p 127.0.0.1:5001:5001 ipfs/kubo:latest

查看节点日志

bash
docker logs -f ipfs_host

访问WebUI

启动后，可以通过 [***] 访问Web界面管理IPFS节点。

自定义节点配置

可以通过挂载/container-init.d目录中的脚本来自定义节点：

bash
docker run -d --name ipfs_host -v /path/to/ipfs/data:/data/ipfs -v /path/to/init/scripts:/container-init.d -p 4001:4001 -p 127.0.0.1:8080:8080 -p 127.0.0.1:5001:5001 ipfs/kubo:latest

常用端口说明

• 4001: IPFS swarm监听端口（P2P网络通信）
• 8080: HTTP网关端口（用于通过HTTP访问IPFS内容）
• 5001: API端口（用于通过API控制IPFS节点）

持久化数据

为了确保IPFS数据持久化，建议挂载数据卷：

bash
docker volume create ipfs_data
docker run -d --name ipfs_host -v ipfs_data:/data/ipfs -p 4001:4001 -p 127.0.0.1:8080:8080 -p 127.0.0.1:5001:5001 ipfs/kubo:latest

docker-compose配置示例

yaml
version: '3'

services:
  ipfs:
    image: ipfs/kubo:latest
    container_name: ipfs_host
    volumes:
      - ipfs_data:/data/ipfs
      # 可选：挂载自定义初始化脚本
      # - ./init-scripts:/container-init.d
    ports:
      - "4001:4001"           #  swarm监听端口
      - "127.0.0.1:8080:8080" #  HTTP网关（仅本地访问）
      - "127.0.0.1:5001:5001" #  API端口（仅本地访问）
    restart: unless-stopped

volumes:
  ipfs_data:

安全注意事项

• 默认情况下，API和网关仅绑定到localhost（127.0.0.1）
• 如果需要从外部访问API或网关，请谨慎配置并确保适当的访问控制
• 对于公共节点，建议启用内容阻止和监控功能