快速上手

BrewFS 是一个 Rust 原生的分布式文件系统，为多智能体协作读写负载、RandRW 密集访问模式 与对象存储基础设施而构建。

快速开始

LocalFS + SQLite 是运行 BrewFS 并观察其数据布局的最简方式。

1. 前置条件。 Rust、FUSE、一个挂载目录和一个数据目录（当前仅支持 Linux 挂载）。
2. 克隆仓库并用 cargo build --release 构建。
3. 使用 LocalFS + SQLite 后端挂载。
4. 通过普通文件路径读写与检查文件。

git clone https://github.com/brewfs/brewfs
cd brewfs
cargo build --release

mkdir -p /tmp/brewfs-mnt /tmp/brewfs-data

cargo run -p brewfs -- mount /tmp/brewfs-mnt \
  --data-backend local-fs \
  --data-dir     /tmp/brewfs-data \
  --meta-backend sqlx \
  --meta-url     sqlite:///tmp/brewfs-meta.db

echo "hello brewfs" > /tmp/brewfs-mnt/hello.txt
cat /tmp/brewfs-mnt/hello.txt
ls -lh /tmp/brewfs-mnt

之后可以切换到 S3 兼容对象存储，以及 Redis、etcd、TiKV 或 PostgreSQL 等元数据后端。

下一步

• 快速上手 — 安装、挂载、配置与 CLI。
• 架构 — FUSE、VFS、元数据、Chunk / Block / Slice、对象后端。
• 基准测试 — RandRW、元数据密集、多智能体扩展、可复现性。
• 基准测试方法 — Redis + RustFS 环境、fio profile、公开结果与公平比较规则。
• POSIX 测试 — xfstests、pjdfstest、LTP、stress-ng 覆盖、runner 与明确限制。
• 性能调优 — 缓存、FUSE、S3、writeback 与元数据 profile。
• Kubernetes Operator — 在 Kubernetes 中部署和消费 BrewFS 挂载。
• 运维 — 可观测性、控制平面、GC、测试与部署。
• 开发者 — SDK、示例、后端适配指南、参与贡献。
• 设计笔记 — BrewFS vs JuiceFS、agent 负载设计、已知限制。