rook/edgefs

EdgeFS 镜像文档

镜像概述

EdgeFS是一款专为分布式环境设计的高性能对象存储系统，核心特点是低延迟数据处理与地理透明访问能力。该系统通过优化的存储引擎和分布式架构，提供高效的数据读写性能，同时支持跨地域数据访问的无缝管理，适用于边缘计算、企业分布式存储及跨地域数据协同场景。

核心功能与特性

1. 高性能与低延迟

• 采用优化的I/O路径和存储引擎，支持高吞吐量（GB/s级）和低响应时间（毫秒级）数据操作
• 针对随机读写和顺序访问场景均做专项优化，适应多样化负载需求

2. 地理透明数据访问

• 跨地域数据访问无需手动配置路由，系统自动处理数据定位与传输
• 支持多站点数据同步与冗余，确保跨区域数据一致性与可用性

3. 弹性扩展能力

• 支持横向扩展架构，可通过添加节点动态提升存储容量与性能
• 无单点故障设计，节点故障自动恢复，保障服务连续性

4. 兼容性与标准化

• 兼容S3 API接口，可无缝集成现有基于S3协议的应用系统
• 支持POSIX文件系统接口，满足传统文件存储场景需求

5. 数据可靠性保障

• 内置多副本/纠删码机制，支持数据自动修复
• 端到端数据校验与加密，保障数据传输与存储安全

使用场景与适用范围

典型应用场景

• 边缘计算环境：在边缘节点部署，满足物联网设备、边缘服务器的低延迟数据存储需求
• 跨地域企业存储：统一管理分布在不同数据中心的存储资源，实现全局数据视图
• 云边协同架构：作为云端与边缘设备的数据枢纽，支持数据双向流动与协同处理
• 高并发日志/监控系统：接收并存储大规模分布式系统产生的日志、指标数据，支持实时查询

适用规模

• 中小型部署：单节点或3-5节点集群，满足TB级数据存储需求
• 大型部署：数十至数百节点集群，支持PB级数据扩展

使用方法与配置说明

基本部署（Docker Run）

单节点快速启动

bash
docker run -d \
  --name edgefs-node \
  --net=host \
  -v /edgefs/data:/var/lib/edgefs \
  -v /edgefs/config:/etc/edgefs \
  -e EDGEFS_CLUSTER_NAME="my-edgefs-cluster" \
  -e EDGEFS_NODE_ROLE="primary" \
  edgefs/edgefs:latest

参数说明

• --net=host：推荐使用host网络模式以优化网络性能（边缘场景网络效率优先）
• -v /edgefs/data:/var/lib/edgefs：挂载数据卷，持久化存储元数据与用户数据
• -v /edgefs/config:/etc/edgefs：挂载配置目录，保存集群配置文件
• 环境变量EDGEFS_CLUSTER_NAME：指定集群名称（必填，同一集群节点需一致）
• 环境变量EDGEFS_NODE_ROLE：节点角色（primary/secondary，主节点/从节点）

集群部署（Docker Compose示例）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  edgefs-primary:
    image: edgefs/edgefs:latest
    network_mode: host
    volumes:
      - /edgefs/primary/data:/var/lib/edgefs
      - /edgefs/primary/config:/etc/edgefs
    environment:
      - EDGEFS_CLUSTER_NAME=my-cluster
      - EDGEFS_NODE_ROLE=primary
      - EDGEFS_ADMIN_USER=admin
      - EDGEFS_ADMIN_PASSWORD=securepassword
    restart: always

  edgefs-secondary:
    image: edgefs/edgefs:latest
    network_mode: host
    volumes:
      - /edgefs/secondary/data:/var/lib/edgefs
      - /edgefs/secondary/config:/etc/edgefs
    environment:
      - EDGEFS_CLUSTER_NAME=my-cluster
      - EDGEFS_NODE_ROLE=secondary
      - EDGEFS_PRIMARY_NODE=192.168.1.100  # 主节点IP
    restart: always

核心配置参数

基本操作步骤

1. 启动集群
   按上述docker-compose配置启动主节点，待主节点初始化完成（约2-3分钟）后启动从节点。

2. 访问管理界面
   通过浏览器访问主节点IP的8080端口（默认管理端口），使用配置的管理员账户登录。

3. 创建存储资源
   在管理界面"存储池"模块创建存储池，指定副本数/纠删码策略；在"对象存储"模块创建S3兼容存储桶。

4. 配置地理访问策略
   在"地理复制"模块添加远程站点，配置数据同步规则（如实时同步/定时同步），实现跨地域数据透明访问。

注意事项

• 生产环境建议至少部署3节点集群以保障高可用
• 数据卷需使用高性能存储介质（如SSD）以发挥低延迟特性
• 跨地域部署时需确保节点间网络带宽≥1Gbps，减少同步延迟
• 定期备份/etc/edgefs目录下的集群配置文件，避免配置丢失