blockstack/gaia-hub

Gaia Hub：去中心化高性能存储系统镜像

镜像概述

Gaia Hub是一个去中心化高性能存储系统，允许用户选择将数据存储在自己偏好的现有存储系统（如S3、Azure Blob Storage等）中，并通过统一API供应用访问。本镜像为quay.io/blockstack/gaia-hub的镜像，注意：原仓库已迁移，建议使用stacksnetwork/gaia-hub镜像。

开发者若要使用Gaia存储系统，可参考https://github.com/blockstack/blockstack.js/tree/master/src/storage%E5%8F%8Ahttp://blockstack.github.io/blockstack.js/#storage%E3%80%82Gaia Hub的搭建和配置说明详见https://github.com/blockstack/gaia/blob/master/hub/README.md%E3%80%82

核心功能与特性

去中心化与用户控制

• 用户可自主选择Gaia Hub及后端存储提供商，数据控制权完全由用户掌握
• 通过用户区域文件（zonefile）和签名配置文件实现数据存储位置的灵活切换
• 认证流程由用户浏览器生成，确保应用获取的存储根URL受用户控制

读写URL保证

• 写入URL与读取URL的后缀路径一致，仅前缀可能不同
• 通过GET /hub_info/端点获取read_url_prefix，可精确预测文件读取地址
• 示例：若写入URL为https://myservice.org/store/1DHvWDj834zPAkwMhpXdYbCYh4PomwQfzz/0/profile.json，则读取URL为https://myservice.org/read/1DHvWDj834zPAkwMhpXdYbCYh4PomwQfzz/0/profile.json（假设read_url_prefix为https://myservice.org/read/）

基于地址的访问控制

• 仅允许控制对应地址的用户写入/store/<address>/<file>路径
• 支持V1认证方案（JWT令牌）和旧版认证方案（签名消息）
• V1认证JWT需包含iss（公钥）、exp（过期时间）、gaiaChallenge（挑战文本）等必要字段
• 支持关联令牌（association token），允许用户将多个密钥绑定到已白名单地址，无需单独白名单配置

驱动模型

• 支持多种后端存储驱动（目前支持S3、Azure Blob Storage，可扩展）
• 驱动需实现performWrite（执行写入）、getReadURLPrefix（获取读取前缀）、listFiles（列出文件）三个核心函数

HTTP API

• 读取文件：GET ${read-url-prefix}/${address}/${path}，返回存储数据，需设置正确CORS头
• 写入文件：POST ${hubUrl}/store/${address}/${path}，需包含Bearer认证令牌，成功返回202状态及publicUrl
• 获取Hub信息：GET ${hubUrl}/hub_info/，返回包含challenge_text（挑战文本）、read_url_prefix（读取前缀）、latest_auth_version（最新认证版本）的JSON对象

使用场景与适用范围

• 用户控制数据存储：适用于重视数据主权的用户，可自主选择存储位置和服务提供商
• 去中心化应用开发：为Blockstack生态应用提供统一数据存储接口，简化开发流程
• 存储服务提供商：可部署开放成员Hub支持多用户，或部署私有Hub为特定用户提供服务

使用方法与配置说明

配置文件

• 配置文件为JSON格式，可存储在Hub服务器顶层目录，或通过环境变量CONFIG_PATH指定路径
• 配置项包括：日志级别、写入所需的社交证明数量、后端驱动类型、驱动凭证、存储提供商的readURL等
• 示例配置文件可参考https://github.com/blockstack/gaia/blob/master/hub/config.sample.json

部署模式

私有Hub

• 仅服务单个用户，通过白名单限制允许写入的地址
• 需为每个应用添加单独的地址到白名单，或使用V1认证方案生成关联令牌（用户白名单自己的地址，为每个应用生成关联令牌）

开放成员Hub

• 允许任何地址写入，需验证写入请求的有效认证令牌
• 可配置要求用户profile.json包含社交证明才能写入，通过配置文件控制

部署示例

Docker Run命令

bash
docker run -d \
  -p 8000:8000 \
  -e CONFIG_PATH=/config/config.json \
  -v /path/to/your/config:/config \
  stacksnetwork/gaia-hub

Docker Compose配置

yaml
version: '3'
services:
  gaia-hub:
    image: stacksnetwork/gaia-hub
    ports:
      - "8000:8000"
    environment:
      - CONFIG_PATH=/config/config.json
    volumes:
      - /path/to/your/config:/config
    restart: unless-stopped

数据存储格式

• Gaia Hub按原样存储写入数据，不保证数据格式有效性、签名有效性或加密状态
• 数据验证、签名和加密等功能由客户端库（如blockstack.js）实现

部署服务注意事项

• 官方部署服务限制：每秒最多20个写入请求，最大文件大小5MB
• 自行部署Gaia Hub可解除上述限制，根据需求调整配置

未来设计目标

• 减少DNS依赖：支持基于Blockstack名称系统等非传统DNS的URL方案
• 可扩展成员集限制：允许服务提供商通过插件实现自定义用户认证模型
• .storage命名空间：创建去中心化存储市场，支持Gaia节点间数据读写和服务计费