prologic/fbox

fbox - 盒子里的文件系统

!GitHub All Releases 

镜像概述和主要用途

fbox是一个使用Go编写的分布式文件系统。其设计初衷是作为分布式文件系统的教育实践，同时致力于提供一个免费开源、具备可靠性、可扩展性和耐用性的分布式文件存储解决方案，以解决现有分布式文件系统复杂难用或许可费用高昂的问题。

核心功能和特性

当前特性

• 单一可移植二进制：部署简单，无需复杂依赖
• 易于设置和维护：简化的配置和管理流程
• Web界面支持拖放：直观的文件管理操作
• 数据冗余：通过纠删码和分片实现数据可靠性

计划特性

• POSIX兼容的FUSE接口
• S3对象存储接口
• Docker卷驱动

使用场景和适用范围

fbox适用于需要简单设置和维护的分布式存储场景，例如：

• 个人或小型团队的文件存储需求
• 分布式系统学习和研究环境
• 对数据可靠性有要求但资源有限的场景

使用方法和配置说明

准备存储

创建本地数据目录（用于测试）：

console
mkdir data1 data2 data3

启动主节点

console
fbox -a 127.0.0.1:8000 -b :8000 -d ./data1

启动数据节点

console
# 第一个数据节点
fbox -a 127.0.0.1:8001 -b :8001 -d ./data2 -m http://127.0.0.1:8000

# 第二个数据节点
fbox -a 127.0.0.1:8002 -b :8002 -d ./data3 -m http://127.0.0.1:8000

上述命令将在本地搭建一个3节点集群（仅用于测试）。通过访问http://127.0.0.1:8000/ui/可打开Web界面。

Docker部署示例

启动主节点容器

console
docker run -d \
  -p 8000:8000 \
  -v $(pwd)/data1:/data \
  --name fbox-master \
  prologic/fbox \
  -a 0.0.0.0:8000 \
  -b :8000 \
  -d /data

启动数据节点容器

console
# 数据节点1
docker run -d \
  -p 8001:8001 \
  -v $(pwd)/data2:/data \
  --name fbox-node1 \
  prologic/fbox \
  -a 0.0.0.0:8001 \
  -b :8001 \
  -d /data \
  -m http://fbox-master:8000

# 数据节点2
docker run -d \
  -p 8002:8002 \
  -v $(pwd)/data3:/data \
  --name fbox-node2 \
  prologic/fbox \
  -a 0.0.0.0:8002 \
  -b :8002 \
  -d /data \
  -m http://fbox-master:8000

命令行使用

查看帮助

console
fbox --help

上传文件

console
echo "Hello World" > hello.txt
fbox -m http://127.0.0.1:8000 put hello.txt

下载文件

console
fbox -m http://127.0.0.1:8000 cat hello.txt

配置参数说明

许可证

fbox基于MIT许可证开源。