VaultS3：轻量 S3 兼容对象存储

项目简介

VaultS3 是一个用 Go 编写的轻量级、兼容 S3 的对象存储服务端。它以单个二进制的形式发布，空闲时内存占用约 17 MiB，内置完整的 Web 控制台（Dashboard），并支持静态加密。项目不依赖配置文件即可启动，会自动创建所需目录，并支持 Docker、各类系统包（.deb / .rpm / .apk）、静态二进制以及 Helm Chart 等部署方式。

作者明确说明这是一个单人维护的项目：它由作者自用并在生产环境中运行，问题也由作者在使用中发现并修复；但它背后没有公司实体支撑，是否托付数据需要使用者自行判断。

主要功能

• S3 兼容 API：实现 80+ 项 S3 操作，可直接用 aws CLI 等标准 S3 客户端访问。
• 内置 Dashboard：S3 API 与 Web 控制台监听同一端口，浏览器打开 /dashboard/ 即可管理。
• 身份与权限：IAM，支持策略（policies）与 OIDC。
• 版本控制：支持版本 diff 与回滚。
• 加密：按桶加密，支持密钥轮换与 crypto-shredding。
• 数据可靠性：纠删码（erasure coding）、Raft 集群、双活复制（active-active replication）。
• 运维能力：生命周期规则、事件通知、分层存储（tiering）、定时备份。
• 扩展能力：FUSE 挂载、全文与向量搜索、病毒扫描。
• 开放且克制：所有功能都不放在付费层后面，且没有遥测。
• 配套 CLI：镜像内附带与服务端同一次提交构建的 vaults3-cli，用于日常用户与密钥管理。

安装与使用

Docker（推荐）

docker run -d --name vaults3 -p 9000:9000 \
  -e VAULTS3_ACCESS_KEY=myadmin \
  -e VAULTS3_SECRET_KEY=mysupersecret \
  -v vaults3-data:/data -v vaults3-meta:/metadata \
  eniz1806/vaults3

S3 API 与控制台都监听 9000 端口：

aws --endpoint-url http://localhost:9000 s3 mb s3://my-bucket
aws --endpoint-url http://localhost:9000 s3 cp ./file.txt s3://my-bucket/
open http://localhost:9000/dashboard/

无需配置文件。VaultS3 使用内置默认值启动、自动创建所需目录，并在首次启动时生成一个管理员密钥（只打印一次）。若想使用自己的凭据，在首次启动前设置 VAULTS3_ACCESS_KEY 与 VAULTS3_SECRET_KEY。

镜像中还包含 vaults3-cli，与服务端由同一提交构建，日常运维无需额外安装：

docker exec vaults3 vaults3-cli user create alice
docker exec vaults3 vaults3-cli key create alice --bucket my-bucket   # 密钥对只打印一次

二进制与系统包

从 releases 页面下载对应平台的压缩包，解压后直接运行：

tar xzf vaults3-<os>-<arch>.tar.gz
./vaults3

每个 release 同时提供 .deb、.rpm、.apk 包、静态二进制、经项目发布密钥签名的 checksums.txt、各平台的 SPDX SBOM，以及可离线验证的 Sigstore provenance：

sudo apt install ./vaults3_5.0.8_amd64.deb
sudo systemctl enable --now vaults3
gh attestation verify vaults3_5.0.8_amd64.deb --repo Kodiqa-Solutions/VaultS3

从源码构建使用 make build；Kubernetes 部署可用 Helm Chart 或单份 manifest。生产环境的磁盘布局等细节见项目安装文档。

注意事项

• 单人维护：项目由一位维护者开发并在生产环境使用，没有公司背书；出现问题时通过 issue 反馈，也欢迎 PR。
• 许可证：AGPL-3.0，如果 AGPL 对你的场景不合适，需要考虑其他方案。
• 可靠性取决于你自己的磁盘与配置：它提供的是自托管对象存储能力，持久性与规模上限由部署方式决定。
• 支持平台：Linux（amd64、arm64）、macOS（amd64、arm64）、Windows（amd64）。

---

本作品整理自 GitHub 开源项目 Kodiqa-Solutions/VaultS3，原作者 @Kodiqa-Solutions，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。