farcasterxyz/hubble

Farcaster Hub Docker镜像文档

概述

Farcaster是一个用于构建充分去中心化社交网络的协议，本Docker镜像提供了运行Farcaster hub节点的便捷部署方式。通过容器化方案，简化了hub节点的配置与运行流程，是搭建去中心化社交网络基础设施的关键组件。

核心功能与特性

• 便捷部署：基于Docker Compose实现快速配置与启动，降低节点运行技术门槛
• 数据持久化：通过Docker卷（volumes）分别存储hub身份数据（hub_identity_data）和RocksDB数据（rocksdb_data），确保节点数据持久化不丢失
• 端口映射：默认映射2282和2283端口，满足hub节点网络通信需求
• 身份管理：集成身份创建命令，支持首次部署时生成节点身份信息

使用场景与适用范围

适用于需要部署Farcaster hub节点的开发者、技术团队或组织，用于构建和运行去中心化社交网络基础设施，支持社交网络数据的分布式存储与通信。

详细使用方法

前提条件

• 已安装Docker和Docker Compose

Docker Compose配置

创建docker-compose.yml文件，内容如下：

yaml
version: '3.9'

services:
  hubble:
    image: farcasterxyz/hubble:latest
    ports:
      - '2282:2282'
      - '2283:2283'
    volumes:
      - hub_identity_data:/home/node/app/apps/hubble/.hub
      - rocksdb_data:/home/node/app/apps/hubble/.rocks

volumes:
  hub_identity_data:
  rocksdb_data:

部署步骤

1. 创建身份（首次运行时）
   若为首次运行hub节点，执行以下命令创建身份：

   bash
   docker compose run hubble yarn identity create
   

   （已运行过hub节点可跳过此步骤）

2. 启动hub节点
   执行以下命令启动节点：

   bash
   docker compose up
   

完成上述步骤后，Farcaster hub节点即成功运行。