VaultS3 项目背景与路线图:作者为何离开 MinIO 打造自己的对象存储?贡献指南全解读

原创2026-10-11 10:22:171,430 阅读

VaultS3 项目背景与路线图:作者为何离开 MinIO 打造自己的对象存储?贡献指南全解读

VaultS3 是一款轻量级、S3 兼容的自建对象存储服务器:单一二进制、空闲仅 17 MB 内存、内置 Web 管理面板、数据默认静态加密。它源于一个真实故事——作者长期使用 MinIO,却眼看自己依赖的功能被移到付费版之后,不愿"把已有功能再租回去",于是亲手重写了这套对象存储。本文带你读懂 VaultS3 的来龙去脉、四条公开承诺、完整路线图,以及如何参与它的开发。


一、为什么写 VaultS3:一个人如何被 MinIO 逼到自建对象存储

VaultS3 的作者在 README.md#L38-L47 里说得直白:

"我为自己造了 VaultS3。我此前跑 MinIO,我依赖的那些组件被移到了付费层之后,而我不想把已经拥有的东西再租回来。于是我自己写了一套。"

这是一名自运维、自使用的维护者:它跑在自己的生产环境里,出问题他先撞上,所以也先修。换句话说,你得到的是一个"自己天天在用它"的项目,而不是背后有一家公司。作者也坦诚地提示——这仍是一个单人项目,采用前请心里有数。

VaultS3 对象存储服务器内置管理面板登录页

这套设计带来三个鲜明卖点(见 README.md):

  • 单二进制:一条命令跑起 S3 API + 管理面板,无需额外组件。
  • 极低内存:空闲约 17 MB,是同类里最小之一。
  • 功能不被收费墙拦住:看板、集群、纠删码、加密、版本、搜索,开箱即用、无遥测。

二、MinIO 的开源版怎么了?同类对象存储横向速览

作者离开 MinIO 的触发点,与 MinIO 的路线调整直接相关。据 README.md#L59 说明,MinIO 在 2025 年把管理控制台从社区版移除,并在 2026 年 2 月归档了其开源仓库,完整管理如今需要付费产品。

下表数据来自各项目自身文档与实测(README.md#L51-L59):

对比维度 VaultS3 MinIO Silo RustFS SeaweedFS Garage
许可协议 AGPL-3.0 AGPL-3.0 AGPL-3.0 Apache-2.0 Apache-2.0 AGPL-3.0
是否公开维护 ✅ 是 ⚠️ 已归档 ✅ 是 ✅ 是 ✅ 是 ✅ 是
空闲内存 17 MiB 184 MiB 101 MiB 70 MiB 98 MiB 23 MiB
需运行的组件数 1 1 1 1 3 1

选型小建议(摘自 README.md#L64-L69):

  • 已用 MinIO、想让它继续跑 → Silo(同盘格式、同 API、同环境变量)。
  • 介意 AGPL 协议 → RustFS / SeaweedFS(均为 Apache-2.0)。
  • 要的是"分布式文件系统"而非对象存储 → SeaweedFS。
  • 要最小化、且不需要纠删码/版本 → Garage。

三、开箱即得:一个二进制里装了多少对象存储能力

VaultS3 把"本来要自己拼装或花钱买"的东西都放进了盒子。内置 Web 管理面板覆盖文件浏览、拖拽上传、统计、IAM、审计、搜索、备份,支持中、英、德、法、俄五种语言。

VaultS3 对象存储管理面板首页仪表盘

核心能力一览(详见 docs/FEATURES.md):

  • S3 API:80+ 操作、SigV4、分片上传、断点续传、预签名 URL。
  • 访问控制:IAM 用户/组/策略、OIDC/JWT 单点登录、STS、审计日志、IP 白名单。
  • 加密:AES-256-GCM 静态加密,SSE-S3 / SSE-KMS / SSE-C,支持按桶密钥轮转与"加密销毁"。
  • 数据管理:版本控制(带 diff 与回滚)、对象锁、生命周期、压缩、分级存储、定时备份。
  • 搜索:元数据与标签全文检索,以及可选的语义检索。

VaultS3 对象存储 IAM 用户与策略管理页


四、VaultS3 的四条公开承诺(免费版永不收费)

作者在 README.md#L198-L227 用带日期的方式公开立誓,这是理解该项目气质的关键:

  1. 今天免费的,永远不搬进付费层——看板、集群、纠删码、加密、版本、搜索,只要现在在盒子里,就一直留在盒子里。
  2. 核心始终是 AGPL-3.0,不会被改签为私有协议。
  3. 无遥测——服务器从不"打电话回家",因为根本没有遥测代码。
  4. 下载无需账号、运行无需许可证密钥;且每个安全修复都发布公开通告,包括那些"有点丢人"的。

商业化的边界也被说得很清楚:面向大规模部署的付费插件(多集群 Fleet Console、K8s Operator、多租户网关、合规包)是独立程序、走 API 对接核心,"存储引擎永远免费,我卖的是它周围的工具"。


五、路线图全解读:150+ 已交付,2 项在路上

docs/ROADMAP.md 是一份"已交付 vs 待办"清单,目前已勾选 150 余项,涵盖 S3 操作、加密、IAM、复制、FUSE 挂载、向量检索、病毒扫描、分级存储、备份等。

仍在路上的 2 项(docs/ROADMAP.md#L116-L117):

  • [ ] LDAP 认证与组映射
  • [ ] STS AssumeRole 与 session policies

换句话说,核心对象存储能力已相当完整,剩余多为"锦上添花"的身份集成项。想跟进度,可直接查 CHANGELOG.md 逐版本记录。


六、生产就绪度:哪些能力能上生产,哪些还是 Beta

VaultS3 对"经过实战"与"仍在成熟"区分得很诚实(README.md#L148-L159):

部署方式 成熟度 说明
单节点(S3 API、版本、IAM、面板) ✅ 稳定 默认部署,测试覆盖广
本地多盘纠删码 ✅ 稳定 Reed-Solomon 编解码 + 后台修复,含故障注入测试
分级存储与备份 ✅ 稳定 冷热迁移、透明回热、全量/增量备份
多节点 Raft 集群 🟡 Beta 已在真实 3 节点集群端到端验证
分片元数据 🟠 可选 新集群可选,默认关闭
双向 active-active 复制 🟡 Beta 向量时钟冲突解决已单测

安全:2026 年 8 月外部白盒评估报告了 14 项发现,全部在 4.4.56 修复,详见 SECURITY.md 与 docs/HARDENING.md。默认配置在公网即安全:强制认证、默认拒绝、开箱限流。

VaultS3 对象存储服务器配置设置页


七、贡献指南全解读:从本地构建到提交 PR

想参与?CONTRIBUTING.md 讲得很清楚。VaultS3 是一个 Go 服务端 + React (Vite) 面板,打成单一二进制。

环境依赖:Go 1.25+、Node.js 20.19+、make。

本地构建与测试(CONTRIBUTING.md#L16-L48):

make build        # 先构建 React 面板,再编译 server + CLI
./vaults3        # 在 :9000 启动(面板位于 /dashboard/)
go test ./...    # 跑全部 Go 单测

代码目录速览(CONTRIBUTING.md#L24-L39):

提交 PR 的规范(CONTRIBUTING.md#L84-L91):

  1. Fork 后从 main 拉功能分支;
  2. 一个 PR 只做一个逻辑变更;
  3. 开 PR 前跑 go test ./...、npm run build(改面板还要 npx vitest run);
  4. 提交信息用现在时、写清楚(如 Fix versioned ListObjectsV2 empty result);
  5. 变更用户可见行为时,同步更新 README 与文档;
  6. PR 描述讲清改了什么和为什么。

💡 测试门槛:erasure、cluster、replication 这三个"数据耐久性子系统"要求更高——新逻辑应带故障注入测试(破坏分片并修复、丢节点并重路由、两站点分区后校验收敛)。

翻译贡献(零代码):面板已有 5 种语言,加一种只需复制 web/src/i18n/locales/en.json 并翻译,保留 {占位符} 即可(CONTRIBUTING.md#L61-L82)。

其他要点:

  • CLA:首次 PR 由 CLA Assistant 机器人引导你签署一次,一次签署覆盖后续所有 PR。
  • 报 Bug:附版本(./vaults3 -version)、系统/架构、脱敏后的配置、复现步骤、期望 vs 实际。
  • 安全:漏洞不要开公开 issue,走 SECURITY.md 的披露流程。

写在最后

VaultS3 的故事,本质是一个自运维者对"功能被锁进付费墙"的直接回应:用单二进制、低内存、全功能、无遥测,换一份"开源且永久"的承诺。它的路线图已交付 150+ 项、仅剩 2 项身份集成在路上,生产路径也标注得清清楚楚。若你在找一款轻量、S3 兼容、可自建的开源对象存储,并愿意跟着 docs/ROADMAP.md 与 CONTRIBUTING.md 一起把它往前推,这个项目值得一看。

登录后查看全文
VaultS3