VaultS3 项目背景与路线图:作者为何离开 MinIO 打造自己的对象存储?贡献指南全解读
VaultS3 项目背景与路线图:作者为何离开 MinIO 打造自己的对象存储?贡献指南全解读
VaultS3 是一款轻量级、S3 兼容的自建对象存储服务器:单一二进制、空闲仅 17 MB 内存、内置 Web 管理面板、数据默认静态加密。它源于一个真实故事——作者长期使用 MinIO,却眼看自己依赖的功能被移到付费版之后,不愿"把已有功能再租回去",于是亲手重写了这套对象存储。本文带你读懂 VaultS3 的来龙去脉、四条公开承诺、完整路线图,以及如何参与它的开发。
一、为什么写 VaultS3:一个人如何被 MinIO 逼到自建对象存储
VaultS3 的作者在 README.md#L38-L47 里说得直白:
"我为自己造了 VaultS3。我此前跑 MinIO,我依赖的那些组件被移到了付费层之后,而我不想把已经拥有的东西再租回来。于是我自己写了一套。"
这是一名自运维、自使用的维护者:它跑在自己的生产环境里,出问题他先撞上,所以也先修。换句话说,你得到的是一个"自己天天在用它"的项目,而不是背后有一家公司。作者也坦诚地提示——这仍是一个单人项目,采用前请心里有数。
这套设计带来三个鲜明卖点(见 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、审计、搜索、备份,支持中、英、德、法、俄五种语言。
核心能力一览(详见 docs/FEATURES.md):
- S3 API:80+ 操作、SigV4、分片上传、断点续传、预签名 URL。
- 访问控制:IAM 用户/组/策略、OIDC/JWT 单点登录、STS、审计日志、IP 白名单。
- 加密:AES-256-GCM 静态加密,SSE-S3 / SSE-KMS / SSE-C,支持按桶密钥轮转与"加密销毁"。
- 数据管理:版本控制(带 diff 与回滚)、对象锁、生命周期、压缩、分级存储、定时备份。
- 搜索:元数据与标签全文检索,以及可选的语义检索。
四、VaultS3 的四条公开承诺(免费版永不收费)
作者在 README.md#L198-L227 用带日期的方式公开立誓,这是理解该项目气质的关键:
- 今天免费的,永远不搬进付费层——看板、集群、纠删码、加密、版本、搜索,只要现在在盒子里,就一直留在盒子里。
- 核心始终是 AGPL-3.0,不会被改签为私有协议。
- 无遥测——服务器从不"打电话回家",因为根本没有遥测代码。
- 下载无需账号、运行无需许可证密钥;且每个安全修复都发布公开通告,包括那些"有点丢人"的。
商业化的边界也被说得很清楚:面向大规模部署的付费插件(多集群 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。默认配置在公网即安全:强制认证、默认拒绝、开箱限流。
七、贡献指南全解读:从本地构建到提交 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):
- internal/s3/ —— S3 API 处理器(PutObject、ListObjectsV2、分片等)
- internal/erasure/ —— Reed-Solomon 纠删码 + 后台修复器
- internal/cluster/ —— Raft 元数据、一致性哈希环、故障检测
- internal/replication/ —— 双向复制(向量时钟)
- web/ —— React 管理面板
提交 PR 的规范(CONTRIBUTING.md#L84-L91):
- Fork 后从
main拉功能分支; - 一个 PR 只做一个逻辑变更;
- 开 PR 前跑
go test ./...、npm run build(改面板还要npx vitest run); - 提交信息用现在时、写清楚(如
Fix versioned ListObjectsV2 empty result); - 变更用户可见行为时,同步更新 README 与文档;
- 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 一起把它往前推,这个项目值得一看。



