RustFS 快速上手指南基于 Rust 的高性能 S3 兼容分布式对象存储部署实战【免费下载链接】rustfs2.3x faster than MinIO for 4KB object payloads. RustFS is an open-source, S3-compatible high-performance object storage system supporting migration and coexistence with other S3-compatible platforms such as MinIO and Ceph.项目地址: https://gitcode.com/GitHub_Trending/rus/rustfsRustFS 是一个基于 Rust 构建的高性能分布式对象存储系统本项目官方描述宣称其在 4KB 小对象负载上具备显著的吞吐优势并专为数据湖、AI 与大数据场景优化。本文以仓库根目录 README_ZH.md 为骨架完整覆盖一键脚本、Docker、源码编译、Helm、Nix Flake、X-CMD 六种部署方式并结合 docker-compose-simple.yml、entrypoint.sh、docker-buildx.sh 等源码与配置深入讲解非 root 容器权限、Pool 扩容拓扑、关键环境变量与启动链路读完即可独立完成从单机到集群、从容器到云原生环境的部署与验证。RustFS 是什么Rust 构建的高性能对象存储RustFS 结合了 MinIO 的简洁性与 Rust 的内存安全及高性能优势。Rust 是全球最受开发者喜爱的编程语言之一这让 RustFS 在语言层面天然避免了 Go/C 系对象存储常见的 GC 停顿与内存泄漏风险。它采用更宽松、商业友好的 Apache 2.0 许可证避免了 AGPL 协议的毒丸限制可自由用于商业场景。项目的核心特征包括高性能基于 Rust 构建确保极致的速度和资源效率分布式架构可扩展且容错的设计适用于大规模部署S3 兼容性与常见 S3 兼容应用和工具集成当前覆盖范围见 S3 兼容矩阵数据湖支持专为高吞吐量的大数据和 AI 工作负载优化完全开源Apache 2.0 许可证鼓励社区贡献和商业使用简单易用设计简洁易于部署和管理。从仓库结构看RustFS 是一个大型 Cargo workspace。根目录 Cargo.toml 声明了 50 余个成员 craterustfs是核心服务实现crates/ecstore负责纠删码存储crates/iam与crates/policy承载身份与策略crates/keystone提供 OpenStack Keystone 集成crates/protocols实现 FTPS、SFTP、WebDAV 等协议crates/obs提供可观测性基础设施crates/e2e_test则维护了覆盖 API 行为的大型端到端测试套件。workspace 全局启用了unsafe_code deny这一严格 lint从编译期约束代码安全边界。功能与状态一览功能状态功能状态S3 核心功能✅ 可用Bitrot (防数据腐烂)✅ 可用上传 / 下载✅ 可用单机模式✅ 可用版本控制✅ 可用存储桶复制✅ 可用日志功能✅ 可用生命周期管理 测试中事件通知✅ 可用分布式模式 测试中K8s Helm Chart✅ 可用OPA (策略引擎) 测试中值得说明的是仓库英文版 README.md 维护了一份粒度更细的功能清单其中对象锁WORM、服务端加密SSE、RustFS KMS、站点复制、桶配额、S3 Select、审计日志、SFTP/WebDAV 等已标记为 ✅ AvailableS3 TablesIceberg REST与 MinIO On-Disk 兼容标记为 Preview需 opt-in feature。状态以你部署的具体版本为准两版 README 可交叉参考。RustFS vs MinIO 性能对比README 公布了官方的压力测试环境参数注意以下为项目官方公布的基准环境具体性能数字建议结合你的硬件独立复测类型参数备注CPU2 核Intel Xeon (Sapphire Rapids) Platinum 8475B , 2.7/3.2 GHz内存4GB网络15Gbps硬盘40GB x 4IOPS 3800 / Drive官方性能对比视频README 内嵌展示了在该配置下 RustFS 与 MinIO 的吞吐差异。RustFS vs 其他对象存储特性RustFS其他对象存储控制台体验功能强大的控制台提供全面的管理界面基础/简陋的控制台通常功能过于简单或缺失关键特性语言与安全基于 Rust 开发天生的内存安全基于 Go 或 C 开发存在内存 GC 停顿或内存泄漏的潜在风险数据主权无遥测 / 完全合规防止未经授权的数据跨境传输符合 GDPR、CCPA、APPI 等法规潜在风险可能存在法律风险和隐蔽的数据遥测开源协议宽松的 Apache 2.0商业友好无毒丸条款受限的 AGPL v3存在许可证陷阱和知识产权污染的风险兼容性S3 核心兼容适配常见 S3 兼容客户端覆盖范围以兼容矩阵为准兼容性不一可能缺乏对本地云厂商或特定 API 的支持边缘与 IoT强大的边缘支持适合安全、创新的边缘设备边缘支持较弱对于边缘网关通常过于沉重成本稳定且免费免费社区支持稳定的商业定价高昂成本1PiB 的成本可能高达 250,000 美元风险控制企业级风险规避清晰的知识产权商业使用安全无忧法律风险知识产权归属模糊及使用限制风险部署方式一一键安装脚本官方提供了一键安装脚本适合快速体验curl -O https://rustfs.com/install_rustfs.sh bash install_rustfs.sh脚本会下载对应平台的 RustFS 二进制并完成基础环境准备。生产环境建议优先采用下文的方式二Docker或方式四Helm Chart以获得版本锁定与可复现的部署流程。部署方式二Docker 快速启动RustFS 容器以非 root 用户rustfsUID/GID10001:10001运行。如果通过 Docker 或 Compose 绑定挂载宿主机目录务必确保所有挂载路径都对该用户可写否则启动时可能出现权限拒绝错误。这不仅适用于数据目录和日志目录也适用于启用RUSTFS_TLS_PATH时挂载的 TLS 证书目录。# 创建数据和日志目录 mkdir -p data logs # 更改这两个目录的所有者 chown -R 10001:10001 data logs # 使用最新版本运行 docker run -d -p 9000:9000 -p 9001:9001 -v $(pwd)/data:/data -v $(pwd)/logs:/logs rustfs/rustfs:latest # 使用指定版本运行 docker run -d -p 9000:9000 -p 9001:9001 -v $(pwd)/data:/data -v $(pwd)/logs:/logs rustfs/rustfs:1.0.0-rc.5其中9000为 S3 API 端口9001为控制台端口。如果通过绑定挂载启用 TLS 证书目录请用同样方式准备该目录mkdir -p certs chown -R 10001:10001 certs使用 podman 的用户同样可以运行podman 会自动处理目录属主-v参数追加:Z,U用于 SELinux 标签与用户映射mkdir -p data logs podman run -d -p 9000:9000 -p 9001:9001 -v $(pwd)/data:/data:Z,U -v $(pwd)/logs:/logs:Z,U rustfs/rustfs:latestDocker Compose 部署使用仓库根目录下的docker-compose-simple.yml文件docker compose -f docker-compose-simple.yml up -d在使用 Compose 且包含宿主机绑定挂载时请先确认所有挂载到容器内的宿主机路径都对10001:10001可写如果启用了 TLS挂载到/opt/tls的证书目录也需要对10001:10001可读如果不方便调整宿主机目录归属可以为rustfs服务显式设置user: host-uid:host-giddocker-compose-simple.yml为命名 volume 提供了volume-permission-helper服务而它本身使用宿主机绑定挂载需要你在启动前自行准备目录权限。从 docker-compose-simple.yml 可以看到主服务的关键配置RUSTFS_VOLUMES/data/rustfs{0...3}声明 4 个存储卷RUSTFS_ADDRESS与RUSTFS_CONSOLE_ADDRESS分别绑定 S3 与控制台监听地址RUSTFS_UNSAFE_BYPASS_DISK_CHECK默认false以保持严格磁盘拓扑校验。volume-permission-helperdocker-compose-simple.yml是解决权限问题的关键它以alpine镜像在启动前执行chown -R 10001:10001修正命名卷属主并显式输出Volume Permissions fixed后退出。同时该 Compose 文件内置了健康检查默认探测:9000/health与:9001/rustfs/console/health开启 TLS 后自动切换为 HTTPS 探测。完整的 docker-compose.yml 则定义了更丰富的观测栈Tempo链路追踪、OTel Collector、Jaeger、Prometheus、Loki 与 Grafana 均以observabilityprofile 提供nginx 反向代理以proxyprofile 提供rustfs-dev开发容器以devprofile 提供。README 建议在运行前仔细审阅该文件因为其中定义了多个对 RustFS 可观测性有帮助的服务。Webhook 事件通知快速启动Dockerdocker run -d --name rustfs -p 9000:9000 \ -e RUSTFS_NOTIFY_ENABLEtrue \ -e RUSTFS_NOTIFY_WEBHOOK_ENABLE_PRIMARYon \ -e RUSTFS_NOTIFY_WEBHOOK_ENDPOINT_PRIMARYhttp://host-ip:3020/webhook \ -e RUSTFS_NOTIFY_WEBHOOK_QUEUE_DIR_PRIMARY/tmp/rustfs-events \ -e RUSTFS_OUTBOUND_ALLOW_ORIGINShttp://host-ip:3020 \ rustfs/rustfs:latest说明RUSTFS_NOTIFY_ENABLEtrue开启全局 notify 模块开关对于 ARNarn:rustfs:sqs::primary:webhook使用带_PRIMARY后缀的实例级环境变量省略 queue dir 时默认为/opt/rustfs/events需保证容器运行用户可写RUSTFS_NOTIFY_WEBHOOK_SKIP_TLS_VERIFY_PRIMARY默认false开启会跳过 webhook TLS 证书校验存在中间人MITM攻击风险并会在启动时打印警告私有 CA 场景请优先使用RUSTFS_NOTIFY_WEBHOOK_CLIENT_CA_PRIMARY自1.0.0-beta.11起位于私有网络或容器网络Docker Compose 服务名、host.docker.internal、RFC 1918 地址的 webhook 端点会被拦截除非其精确的scheme://host:portorigin不含路径被列入RUSTFS_OUTBOUND_ALLOW_ORIGINS详见 出站连接策略。这一策略并非通知模块独有。从 docs/operations/outbound-connection-policy.md 可以看出RustFS 对每个运维配置的出站目标通知 webhook、审计 webhook、OIDC 发现、Object Lambda、复制/迁移目标、分层温存储后端、Keystoneauth_url等都执行 SSRF 防护校验字面 URL 检查禁止 localhost、回环、私有、保留、链路本地等地址完整策略还会在每次新连接时重新校验 DNS 解析结果防止主机名被重新绑定到受限地址。部署方式三源码编译进阶用户适用于希望从源码构建支持多架构 RustFS Docker 镜像的开发者# 在本地构建多架构镜像 ./docker-buildx.sh --build-arg RELEASElatest # 构建并推送到仓库 ./docker-buildx.sh --push # 构建指定版本 ./docker-buildx.sh --release v1.0.0 --push # 构建并推送到自定义仓库 ./docker-buildx.sh --registry your-registry.com --namespace yourname --pushdocker-buildx.sh脚本见 docker-buildx.sh支持多架构构建linux/amd64,linux/arm64通过-p, --platforms自定义自动版本检测优先使用 git tags无 tag 时回退到 commit hashdocker-buildx.sh灵活的仓库支持支持 Docker Hub、GitHub Container Registry 等通过-r, --registry与-n, --namespace构建优化包含缓存和并行构建默认创建rustfs-builderdocker-container 驱动构建器构建结束后自动docker buildx prune -f清理缓存通道选择--channel dev可拉取 dev 通道二进制构建dev-latest/dev-version标签。为了方便起见也可以使用 Make 命令。仓库根目录 Justfile 提供了对应目标make docker-buildx # 本地构建 make docker-buildx-push # 构建并推送 make docker-buildx-version VERSIONv1.0.0 # 构建指定版本 make help-docker # 显示所有 Docker 相关命令注意 (macOS 交叉编译): macOS 默认的ulimit -n限制为 256因此在使用cargo zigbuild或./build-rustfs.sh --platform ...交叉编译 Linux 版本时可能会因ProcessFdQuotaExceeded失败。构建脚本会尝试自动提高限制但如果仍然看到警告请在构建前在终端运行ulimit -n 4096或更高。从性能实现角度看RustFS 在进程层面对内存分配做了专门优化。rustfs/src/main.rs 将全局分配器设置为 mimalloc启用hotpathhotpath-allocfeature 时还会包一层CountingAllocator做分配计数观测并配套了分配器转发与堆归属的单元测试根 Cargo.toml 的 release profile 采用opt-level 3、lto thin、codegen-units 1并剥离符号同时提供production与profiling两个继承 profile后者保留调试信息便于采样剖析。部署方式四Kubernetes 云原生部署Helm Chart在 Kubernetes 集群上安装 RustFS 请按 Helm Chart 说明操作。仓库 helm/rustfs 目录内置了完整的 ChartChart.yaml、values.yaml以及templates/下的 26 个模板文件Deployment、Service、StatefulSet 相关、健康检查、配置注入等。常见的自定义项包括镜像仓库与 tag、S3/控制台 Service 类型、存储卷声明、访问密钥与 Secret 注入方式。生产集群建议结合 Ingress 暴露控制台并为数据目录配置持久化存储。部署方式五Nix Flake含 NixOS 模块与 rc 客户端如果已启用 Nix Flakes 功能可以免安装直接运行或编译# 直接运行无需安装远程 flake nix run github:rustfs/rustfs # 编译二进制文件 nix build github:rustfs/rustfs ./result/bin/rustfs --help # 或者从本地检出的代码库运行/编译 nix build nix run该 Flakeflake.nix同时提供 NixOS 模块和 RustFSrc客户端。将inputs.rustfs.nixosModules.rustfs加入imports并通过运行时密钥文件例如 sops-nix 或 agenix配置accessKeyFile与secretKeyFile避免密钥进入 Nix storeimports [ inputs.rustfs.nixosModules.rustfs ]; services.rustfs { enable true; accessKeyFile /run/secrets/rustfs-access-key; secretKeyFile /run/secrets/rustfs-secret-key; volumes [ /var/lib/rustfs ]; };安装 S3 兼容客户端nix profile install github:rustfs/rustfs#rustfs-client可执行文件名为rc或使用inputs.rustfs.packages.${pkgs.system}.rustfs-client。客户端包也可通过 overlay 以rc别名获得。从 nix/rustfs-module.nix 的模块选项可以看出services.rustfs支持enable、package、user/group默认rustfs、volumes默认/var/lib/rustfs、addressS3 监听默认:9000、consoleEnable、consoleAddress默认127.0.0.1:9001以及accessKeyFile/secretKeyFile等选项全部通过RUSTFS_VOLUMES等环境变量透传给服务进程。部署方式六X-CMD如果你是 x-cmd 用户# 直接运行无需安装 x rustfs # 下载二进制文件并安装到全局环境中 x env use rustfs rustfs --help访问 RustFS控制台与 S3 客户端完成部署后按以下步骤开始使用访问控制台打开浏览器访问http://localhost:9001进入 RustFS 控制台默认账号/密码为rustfsadmin/rustfsadmin。生产环境务必通过环境变量覆盖默认凭据创建存储桶使用控制台为对象创建新的存储桶Bucket上传对象可直接通过控制台上传文件也可使用任何 S3 兼容 API/客户端如mc、AWS CLI、SDK与 RustFS 实例交互。注意如果希望通过https访问 RustFS 实例请参考 TLS 配置文档。仓库 deploy/config/rustfs.env 中给出了RUSTFS_TLS_PATH的配置示例指向证书目录entrypoint.sh 与 compose 健康检查在设置RUSTFS_TLS_PATH后会自动将健康探测切换为 HTTPS。关键环境变量与配置参考仓库 deploy/config/rustfs.env 是一份可参考的完整配置模板# RustFS administrator access key. Replace before deployment; do not use public defaults. RUSTFS_ACCESS_KEYREPLACE_WITH_UNIQUE_ACCESS_KEY RUSTFS_SECRET_KEYREPLACE_WITH_UNIQUE_SECRET_KEY # RustFS data volume storage paths, supports multiple volumes from vol1 to vol4 RUSTFS_VOLUMES./deploy/data/vol{1...4} # RustFS service listen address and port RUSTFS_ADDRESS0.0.0.0:9000 # Enable RustFS console functionality RUSTFS_CONSOLE_ENABLEtrue # RustFS console listen address and port RUSTFS_CONSOLE_ADDRESS0.0.0.0:9001 # Optional service domain(s) for virtual-hosted-style requests (comma-separated). # Required for clients that default to virtual-hosted-style addressing (AWS SDK, # Terraform/Pulumi). Without it, only path-style addressing works. # RUSTFS_SERVER_DOMAINSs3.example.com # Optional RustFS license content # RUSTFS_LICENSEREPLACE_WITH_LICENSE_CONTENT # Allocator reclaim is enabled by default to return freed allocator pages to the OS # RUSTFS_ALLOCATOR_RECLAIM_ENABLEDfalse # Observability configuration endpoint RUSTFS_OBS_ENDPOINThttp://localhost:4318 # Optional TLS certificates directory path RUSTFS_TLS_PATH/etc/default/tls各变量的作用要点RUSTFS_ACCESS_KEY/RUSTFS_SECRET_KEY管理员凭据模板明确要求替换默认值。容器入口 entrypoint.sh 会解析直接值RUSTFS_ACCESS_KEY与文件值RUSTFS_ACCESS_KEY_FILE两类来源并遵循严格策略同时设置两个来源报错退出值缺失仅告警进程回退到内置默认凭据并告警空值、不可读文件、使用默认rustfsadmin凭据都会触发告警其中同时设置与空值/不可读文件是硬失败exit 1。此外入口脚本还兼容RUSTFS_ROOT_*、MINIO_*等旧环境变量RUSTFS_VOLUMES数据卷声明支持{1...4}省略号表达式展开多盘也支持分布式 URL 形式如http://node{1...4}:9000/data/rustfs{0...3}。entrypoint.sh 中的展开逻辑会先展开卷列表中的数字范围再为本地路径mkdir -p并可选按RUSTFS_UID/RUSTFS_GID修正属主同时把裸绝对路径追加为 CLI 参数URL 形式的端点则由 rustfs 进程直接读取RUSTFS_ADDRESS/RUSTFS_CONSOLE_ADDRESSS3 API 与控制台监听地址RUSTFS_SERVER_DOMAINS虚拟主机风格virtual-hosted-style请求的域名列表。AWS SDK、Terraform/Pulumi 等客户端默认采用虚拟主机风格寻址若不设置则只能使用路径风格需在客户端设置s3_use_path_style true/force_path_styletrueRUSTFS_TLS_PATHTLS 证书目录RUSTFS_OBS_ENDPOINTOpenTelemetry OTLP 上报端点如http://localhost:4318。Pool 扩容拓扑规则务必先读[!IMPORTANT]Pool 扩容 Notice单节点单盘SNSD部署仅支持使用本地路径独立运行不支持原地扩容也不能作为 Pool 加入集群。如需改为多盘拓扑请创建新部署并通过 S3 迁移数据。已有多盘 Pool 的端点和 Erasure Set 宽度应保持不变扩容应追加新的 Pool。使用省略号表达式扩容时每个 Pool 参数都必须包含省略号表达式并展开为至少两个磁盘端点。允许单节点多盘 Pool也允许多节点、每节点一盘的 Pool但必须满足 Erasure Set 布局和 EC 配置要求配置合法不代表能够容忍整台主机故障。这些拓扑规则与 MinIO 一致但两者的默认 parity 选择方式存在差异。扩容前请阅读 Pool 布局兼容性与回归测试说明。pool-layout-compatibility.md 进一步明确了细则一个纠删 Pool 至少需要两个磁盘端点单节点多盘 Pool 与多节点单盘 Pool 都可能合法已有 Pool 的盘数与 Set 宽度不可变把/data{1...4}改成/data{1...8}属于扩容旧 Pool追加/other-data{1...4}才是新建 PoolSet 由 2~16 块盘组成16 不是 Pool 总盘数上限显式存储类 parity 必须满足parity drives_per_set / 2且STANDARD parity RRS parity。拓扑被接受并不等于高可用保证——单节点 Pool 失去唯一宿主机即失去该 Pool 全部分片两盘EC:1的 Set 在丢失一盘后只有读仲裁没有写仲裁故障域与仲裁需要单独规划。从源码看 RustFS 的启动链路理解启动流程有助于排查部署问题。入口 rustfs/src/main.rs 只做两件事构建 hotpath 观测 guard然后调用rustfs::startup_entrypoint::run_process()。而 startup_entrypoint.rs 的run_process是进程级致命边界先构建 Tokio 运行时阻塞执行async_main退出前显式 drop dial9 观测 guard 并封存 trace 段任何错误都以[FATAL]前缀输出到 stderr 后process::exit(1)。async_mainstartup_entrypoint.rs的执行顺序是记录容器资源检测cgroup结果 → 外部前缀兼容引导 → 用Opt::parse_command解析 CLI 子命令info、tls、diagnose、inspect、connect register、server→ 服务端预检含可观测性初始化→run(config)。run阶段再依次初始化监听上下文、存储地基init_startup_storage_foundation基于config.volumes构建 endpoint pools、HTTP 服务器S3 控制台、存储运行时与服务运行时最后进入run_startup_runtime_lifecycle统一生命周期管理。这与容器入口 entrypoint.sh 的分工一致脚本负责参数归一化、凭据来源解析与校验、卷展开与目录创建、日志目录处理真正的服务逻辑全部由/usr/bin/rustfs二进制承担。运维深化KMS、Scanner 与可观测性作为延伸参考仓库docs/operations/下还维护了多份与日常运维强相关的权威文档KMS 后端安全docs/operations/kms-backend-security.mdRustFS 支持Local、Static、Vault KV2、Vault Transit、AWS KMS 五种后端其差异核心在于主密钥材料存放在哪、谁能读取。Local与Static仅限开发与测试生产推荐 Vault Transit 或 AWS KMS密钥材料永不离开 Vault/AWS。文档还特别警示默认构建对 MinIO 加密过的对象SSE-S3/SSE-KMS/SSE-C采取 fail-closed 策略读取会返回 S3InvalidObjectState迁移 MinIO 前务必抽样读取加密对象验证Scanner 运行时控制docs/operations/scanner-runtime-controls.mdScanner 是后台维护循环驱动用量统计、生命周期过期与分层、复制修复、heal 与 bitrot 检查。其运行参数按环境变量 → 持久化 admin 配置 → 内置默认值的顺序解析支持RUSTFS_SCANNER_*系列热更新调节S3 兼容矩阵docs/architecture/s3-compatibility-matrix.md以scripts/s3-tests/下的测试清单为唯一事实来源桶/对象基础操作、Multipart、标签、策略、Presigned URL、Range 条件读等均标记为 SupportedSSE 行明确RustFS 加解密自身对象MinIO SSE 对象在默认构建中不可读需rio-v2迁移构建。结语本文以 README_ZH.md 为主线完整覆盖了 RustFS 的六种部署路径、控制台入门、关键环境变量与 Pool 扩容拓扑并结合 entrypoint.sh、docker-compose-simple.yml、docker-buildx.sh、flake.nix 与核心启动源码补充了容器权限模型、凭据解析、卷展开与启动链路等实现细节。下一步建议按 S3 兼容矩阵 验证你依赖的 API 覆盖阅读 Pool 布局兼容性说明 后再规划多盘/多节点拓扑并参照docs/operations/下的 KMS、Scanner 与出站连接策略文档完成生产加固。【免费下载链接】rustfs2.3x faster than MinIO for 4KB object payloads. RustFS is an open-source, S3-compatible high-performance object storage system supporting migration and coexistence with other S3-compatible platforms such as MinIO and Ceph.项目地址: https://gitcode.com/GitHub_Trending/rus/rustfs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
RustFS 快速上手指南：基于 Rust 的高性能 S3 兼容分布式对象存储部署实战
RustFS 快速上手指南基于 Rust 的高性能 S3 兼容分布式对象存储部署实战【免费下载链接】rustfs2.3x faster than MinIO for 4KB object payloads. RustFS is an open-source, S3-compatible high-performance object storage system supporting migration and coexistence with other S3-compatible platforms such as MinIO and Ceph.项目地址: https://gitcode.com/GitHub_Trending/rus/rustfsRustFS 是一个基于 Rust 构建的高性能分布式对象存储系统本项目官方描述宣称其在 4KB 小对象负载上具备显著的吞吐优势并专为数据湖、AI 与大数据场景优化。本文以仓库根目录 README_ZH.md 为骨架完整覆盖一键脚本、Docker、源码编译、Helm、Nix Flake、X-CMD 六种部署方式并结合 docker-compose-simple.yml、entrypoint.sh、docker-buildx.sh 等源码与配置深入讲解非 root 容器权限、Pool 扩容拓扑、关键环境变量与启动链路读完即可独立完成从单机到集群、从容器到云原生环境的部署与验证。RustFS 是什么Rust 构建的高性能对象存储RustFS 结合了 MinIO 的简洁性与 Rust 的内存安全及高性能优势。Rust 是全球最受开发者喜爱的编程语言之一这让 RustFS 在语言层面天然避免了 Go/C 系对象存储常见的 GC 停顿与内存泄漏风险。它采用更宽松、商业友好的 Apache 2.0 许可证避免了 AGPL 协议的毒丸限制可自由用于商业场景。项目的核心特征包括高性能基于 Rust 构建确保极致的速度和资源效率分布式架构可扩展且容错的设计适用于大规模部署S3 兼容性与常见 S3 兼容应用和工具集成当前覆盖范围见 S3 兼容矩阵数据湖支持专为高吞吐量的大数据和 AI 工作负载优化完全开源Apache 2.0 许可证鼓励社区贡献和商业使用简单易用设计简洁易于部署和管理。从仓库结构看RustFS 是一个大型 Cargo workspace。根目录 Cargo.toml 声明了 50 余个成员 craterustfs是核心服务实现crates/ecstore负责纠删码存储crates/iam与crates/policy承载身份与策略crates/keystone提供 OpenStack Keystone 集成crates/protocols实现 FTPS、SFTP、WebDAV 等协议crates/obs提供可观测性基础设施crates/e2e_test则维护了覆盖 API 行为的大型端到端测试套件。workspace 全局启用了unsafe_code deny这一严格 lint从编译期约束代码安全边界。功能与状态一览功能状态功能状态S3 核心功能✅ 可用Bitrot (防数据腐烂)✅ 可用上传 / 下载✅ 可用单机模式✅ 可用版本控制✅ 可用存储桶复制✅ 可用日志功能✅ 可用生命周期管理 测试中事件通知✅ 可用分布式模式 测试中K8s Helm Chart✅ 可用OPA (策略引擎) 测试中值得说明的是仓库英文版 README.md 维护了一份粒度更细的功能清单其中对象锁WORM、服务端加密SSE、RustFS KMS、站点复制、桶配额、S3 Select、审计日志、SFTP/WebDAV 等已标记为 ✅ AvailableS3 TablesIceberg REST与 MinIO On-Disk 兼容标记为 Preview需 opt-in feature。状态以你部署的具体版本为准两版 README 可交叉参考。RustFS vs MinIO 性能对比README 公布了官方的压力测试环境参数注意以下为项目官方公布的基准环境具体性能数字建议结合你的硬件独立复测类型参数备注CPU2 核Intel Xeon (Sapphire Rapids) Platinum 8475B , 2.7/3.2 GHz内存4GB网络15Gbps硬盘40GB x 4IOPS 3800 / Drive官方性能对比视频README 内嵌展示了在该配置下 RustFS 与 MinIO 的吞吐差异。RustFS vs 其他对象存储特性RustFS其他对象存储控制台体验功能强大的控制台提供全面的管理界面基础/简陋的控制台通常功能过于简单或缺失关键特性语言与安全基于 Rust 开发天生的内存安全基于 Go 或 C 开发存在内存 GC 停顿或内存泄漏的潜在风险数据主权无遥测 / 完全合规防止未经授权的数据跨境传输符合 GDPR、CCPA、APPI 等法规潜在风险可能存在法律风险和隐蔽的数据遥测开源协议宽松的 Apache 2.0商业友好无毒丸条款受限的 AGPL v3存在许可证陷阱和知识产权污染的风险兼容性S3 核心兼容适配常见 S3 兼容客户端覆盖范围以兼容矩阵为准兼容性不一可能缺乏对本地云厂商或特定 API 的支持边缘与 IoT强大的边缘支持适合安全、创新的边缘设备边缘支持较弱对于边缘网关通常过于沉重成本稳定且免费免费社区支持稳定的商业定价高昂成本1PiB 的成本可能高达 250,000 美元风险控制企业级风险规避清晰的知识产权商业使用安全无忧法律风险知识产权归属模糊及使用限制风险部署方式一一键安装脚本官方提供了一键安装脚本适合快速体验curl -O https://rustfs.com/install_rustfs.sh bash install_rustfs.sh脚本会下载对应平台的 RustFS 二进制并完成基础环境准备。生产环境建议优先采用下文的方式二Docker或方式四Helm Chart以获得版本锁定与可复现的部署流程。部署方式二Docker 快速启动RustFS 容器以非 root 用户rustfsUID/GID10001:10001运行。如果通过 Docker 或 Compose 绑定挂载宿主机目录务必确保所有挂载路径都对该用户可写否则启动时可能出现权限拒绝错误。这不仅适用于数据目录和日志目录也适用于启用RUSTFS_TLS_PATH时挂载的 TLS 证书目录。# 创建数据和日志目录 mkdir -p data logs # 更改这两个目录的所有者 chown -R 10001:10001 data logs # 使用最新版本运行 docker run -d -p 9000:9000 -p 9001:9001 -v $(pwd)/data:/data -v $(pwd)/logs:/logs rustfs/rustfs:latest # 使用指定版本运行 docker run -d -p 9000:9000 -p 9001:9001 -v $(pwd)/data:/data -v $(pwd)/logs:/logs rustfs/rustfs:1.0.0-rc.5其中9000为 S3 API 端口9001为控制台端口。如果通过绑定挂载启用 TLS 证书目录请用同样方式准备该目录mkdir -p certs chown -R 10001:10001 certs使用 podman 的用户同样可以运行podman 会自动处理目录属主-v参数追加:Z,U用于 SELinux 标签与用户映射mkdir -p data logs podman run -d -p 9000:9000 -p 9001:9001 -v $(pwd)/data:/data:Z,U -v $(pwd)/logs:/logs:Z,U rustfs/rustfs:latestDocker Compose 部署使用仓库根目录下的docker-compose-simple.yml文件docker compose -f docker-compose-simple.yml up -d在使用 Compose 且包含宿主机绑定挂载时请先确认所有挂载到容器内的宿主机路径都对10001:10001可写如果启用了 TLS挂载到/opt/tls的证书目录也需要对10001:10001可读如果不方便调整宿主机目录归属可以为rustfs服务显式设置user: host-uid:host-giddocker-compose-simple.yml为命名 volume 提供了volume-permission-helper服务而它本身使用宿主机绑定挂载需要你在启动前自行准备目录权限。从 docker-compose-simple.yml 可以看到主服务的关键配置RUSTFS_VOLUMES/data/rustfs{0...3}声明 4 个存储卷RUSTFS_ADDRESS与RUSTFS_CONSOLE_ADDRESS分别绑定 S3 与控制台监听地址RUSTFS_UNSAFE_BYPASS_DISK_CHECK默认false以保持严格磁盘拓扑校验。volume-permission-helperdocker-compose-simple.yml是解决权限问题的关键它以alpine镜像在启动前执行chown -R 10001:10001修正命名卷属主并显式输出Volume Permissions fixed后退出。同时该 Compose 文件内置了健康检查默认探测:9000/health与:9001/rustfs/console/health开启 TLS 后自动切换为 HTTPS 探测。完整的 docker-compose.yml 则定义了更丰富的观测栈Tempo链路追踪、OTel Collector、Jaeger、Prometheus、Loki 与 Grafana 均以observabilityprofile 提供nginx 反向代理以proxyprofile 提供rustfs-dev开发容器以devprofile 提供。README 建议在运行前仔细审阅该文件因为其中定义了多个对 RustFS 可观测性有帮助的服务。Webhook 事件通知快速启动Dockerdocker run -d --name rustfs -p 9000:9000 \ -e RUSTFS_NOTIFY_ENABLEtrue \ -e RUSTFS_NOTIFY_WEBHOOK_ENABLE_PRIMARYon \ -e RUSTFS_NOTIFY_WEBHOOK_ENDPOINT_PRIMARYhttp://host-ip:3020/webhook \ -e RUSTFS_NOTIFY_WEBHOOK_QUEUE_DIR_PRIMARY/tmp/rustfs-events \ -e RUSTFS_OUTBOUND_ALLOW_ORIGINShttp://host-ip:3020 \ rustfs/rustfs:latest说明RUSTFS_NOTIFY_ENABLEtrue开启全局 notify 模块开关对于 ARNarn:rustfs:sqs::primary:webhook使用带_PRIMARY后缀的实例级环境变量省略 queue dir 时默认为/opt/rustfs/events需保证容器运行用户可写RUSTFS_NOTIFY_WEBHOOK_SKIP_TLS_VERIFY_PRIMARY默认false开启会跳过 webhook TLS 证书校验存在中间人MITM攻击风险并会在启动时打印警告私有 CA 场景请优先使用RUSTFS_NOTIFY_WEBHOOK_CLIENT_CA_PRIMARY自1.0.0-beta.11起位于私有网络或容器网络Docker Compose 服务名、host.docker.internal、RFC 1918 地址的 webhook 端点会被拦截除非其精确的scheme://host:portorigin不含路径被列入RUSTFS_OUTBOUND_ALLOW_ORIGINS详见 出站连接策略。这一策略并非通知模块独有。从 docs/operations/outbound-connection-policy.md 可以看出RustFS 对每个运维配置的出站目标通知 webhook、审计 webhook、OIDC 发现、Object Lambda、复制/迁移目标、分层温存储后端、Keystoneauth_url等都执行 SSRF 防护校验字面 URL 检查禁止 localhost、回环、私有、保留、链路本地等地址完整策略还会在每次新连接时重新校验 DNS 解析结果防止主机名被重新绑定到受限地址。部署方式三源码编译进阶用户适用于希望从源码构建支持多架构 RustFS Docker 镜像的开发者# 在本地构建多架构镜像 ./docker-buildx.sh --build-arg RELEASElatest # 构建并推送到仓库 ./docker-buildx.sh --push # 构建指定版本 ./docker-buildx.sh --release v1.0.0 --push # 构建并推送到自定义仓库 ./docker-buildx.sh --registry your-registry.com --namespace yourname --pushdocker-buildx.sh脚本见 docker-buildx.sh支持多架构构建linux/amd64,linux/arm64通过-p, --platforms自定义自动版本检测优先使用 git tags无 tag 时回退到 commit hashdocker-buildx.sh灵活的仓库支持支持 Docker Hub、GitHub Container Registry 等通过-r, --registry与-n, --namespace构建优化包含缓存和并行构建默认创建rustfs-builderdocker-container 驱动构建器构建结束后自动docker buildx prune -f清理缓存通道选择--channel dev可拉取 dev 通道二进制构建dev-latest/dev-version标签。为了方便起见也可以使用 Make 命令。仓库根目录 Justfile 提供了对应目标make docker-buildx # 本地构建 make docker-buildx-push # 构建并推送 make docker-buildx-version VERSIONv1.0.0 # 构建指定版本 make help-docker # 显示所有 Docker 相关命令注意 (macOS 交叉编译): macOS 默认的ulimit -n限制为 256因此在使用cargo zigbuild或./build-rustfs.sh --platform ...交叉编译 Linux 版本时可能会因ProcessFdQuotaExceeded失败。构建脚本会尝试自动提高限制但如果仍然看到警告请在构建前在终端运行ulimit -n 4096或更高。从性能实现角度看RustFS 在进程层面对内存分配做了专门优化。rustfs/src/main.rs 将全局分配器设置为 mimalloc启用hotpathhotpath-allocfeature 时还会包一层CountingAllocator做分配计数观测并配套了分配器转发与堆归属的单元测试根 Cargo.toml 的 release profile 采用opt-level 3、lto thin、codegen-units 1并剥离符号同时提供production与profiling两个继承 profile后者保留调试信息便于采样剖析。部署方式四Kubernetes 云原生部署Helm Chart在 Kubernetes 集群上安装 RustFS 请按 Helm Chart 说明操作。仓库 helm/rustfs 目录内置了完整的 ChartChart.yaml、values.yaml以及templates/下的 26 个模板文件Deployment、Service、StatefulSet 相关、健康检查、配置注入等。常见的自定义项包括镜像仓库与 tag、S3/控制台 Service 类型、存储卷声明、访问密钥与 Secret 注入方式。生产集群建议结合 Ingress 暴露控制台并为数据目录配置持久化存储。部署方式五Nix Flake含 NixOS 模块与 rc 客户端如果已启用 Nix Flakes 功能可以免安装直接运行或编译# 直接运行无需安装远程 flake nix run github:rustfs/rustfs # 编译二进制文件 nix build github:rustfs/rustfs ./result/bin/rustfs --help # 或者从本地检出的代码库运行/编译 nix build nix run该 Flakeflake.nix同时提供 NixOS 模块和 RustFSrc客户端。将inputs.rustfs.nixosModules.rustfs加入imports并通过运行时密钥文件例如 sops-nix 或 agenix配置accessKeyFile与secretKeyFile避免密钥进入 Nix storeimports [ inputs.rustfs.nixosModules.rustfs ]; services.rustfs { enable true; accessKeyFile /run/secrets/rustfs-access-key; secretKeyFile /run/secrets/rustfs-secret-key; volumes [ /var/lib/rustfs ]; };安装 S3 兼容客户端nix profile install github:rustfs/rustfs#rustfs-client可执行文件名为rc或使用inputs.rustfs.packages.${pkgs.system}.rustfs-client。客户端包也可通过 overlay 以rc别名获得。从 nix/rustfs-module.nix 的模块选项可以看出services.rustfs支持enable、package、user/group默认rustfs、volumes默认/var/lib/rustfs、addressS3 监听默认:9000、consoleEnable、consoleAddress默认127.0.0.1:9001以及accessKeyFile/secretKeyFile等选项全部通过RUSTFS_VOLUMES等环境变量透传给服务进程。部署方式六X-CMD如果你是 x-cmd 用户# 直接运行无需安装 x rustfs # 下载二进制文件并安装到全局环境中 x env use rustfs rustfs --help访问 RustFS控制台与 S3 客户端完成部署后按以下步骤开始使用访问控制台打开浏览器访问http://localhost:9001进入 RustFS 控制台默认账号/密码为rustfsadmin/rustfsadmin。生产环境务必通过环境变量覆盖默认凭据创建存储桶使用控制台为对象创建新的存储桶Bucket上传对象可直接通过控制台上传文件也可使用任何 S3 兼容 API/客户端如mc、AWS CLI、SDK与 RustFS 实例交互。注意如果希望通过https访问 RustFS 实例请参考 TLS 配置文档。仓库 deploy/config/rustfs.env 中给出了RUSTFS_TLS_PATH的配置示例指向证书目录entrypoint.sh 与 compose 健康检查在设置RUSTFS_TLS_PATH后会自动将健康探测切换为 HTTPS。关键环境变量与配置参考仓库 deploy/config/rustfs.env 是一份可参考的完整配置模板# RustFS administrator access key. Replace before deployment; do not use public defaults. RUSTFS_ACCESS_KEYREPLACE_WITH_UNIQUE_ACCESS_KEY RUSTFS_SECRET_KEYREPLACE_WITH_UNIQUE_SECRET_KEY # RustFS data volume storage paths, supports multiple volumes from vol1 to vol4 RUSTFS_VOLUMES./deploy/data/vol{1...4} # RustFS service listen address and port RUSTFS_ADDRESS0.0.0.0:9000 # Enable RustFS console functionality RUSTFS_CONSOLE_ENABLEtrue # RustFS console listen address and port RUSTFS_CONSOLE_ADDRESS0.0.0.0:9001 # Optional service domain(s) for virtual-hosted-style requests (comma-separated). # Required for clients that default to virtual-hosted-style addressing (AWS SDK, # Terraform/Pulumi). Without it, only path-style addressing works. # RUSTFS_SERVER_DOMAINSs3.example.com # Optional RustFS license content # RUSTFS_LICENSEREPLACE_WITH_LICENSE_CONTENT # Allocator reclaim is enabled by default to return freed allocator pages to the OS # RUSTFS_ALLOCATOR_RECLAIM_ENABLEDfalse # Observability configuration endpoint RUSTFS_OBS_ENDPOINThttp://localhost:4318 # Optional TLS certificates directory path RUSTFS_TLS_PATH/etc/default/tls各变量的作用要点RUSTFS_ACCESS_KEY/RUSTFS_SECRET_KEY管理员凭据模板明确要求替换默认值。容器入口 entrypoint.sh 会解析直接值RUSTFS_ACCESS_KEY与文件值RUSTFS_ACCESS_KEY_FILE两类来源并遵循严格策略同时设置两个来源报错退出值缺失仅告警进程回退到内置默认凭据并告警空值、不可读文件、使用默认rustfsadmin凭据都会触发告警其中同时设置与空值/不可读文件是硬失败exit 1。此外入口脚本还兼容RUSTFS_ROOT_*、MINIO_*等旧环境变量RUSTFS_VOLUMES数据卷声明支持{1...4}省略号表达式展开多盘也支持分布式 URL 形式如http://node{1...4}:9000/data/rustfs{0...3}。entrypoint.sh 中的展开逻辑会先展开卷列表中的数字范围再为本地路径mkdir -p并可选按RUSTFS_UID/RUSTFS_GID修正属主同时把裸绝对路径追加为 CLI 参数URL 形式的端点则由 rustfs 进程直接读取RUSTFS_ADDRESS/RUSTFS_CONSOLE_ADDRESSS3 API 与控制台监听地址RUSTFS_SERVER_DOMAINS虚拟主机风格virtual-hosted-style请求的域名列表。AWS SDK、Terraform/Pulumi 等客户端默认采用虚拟主机风格寻址若不设置则只能使用路径风格需在客户端设置s3_use_path_style true/force_path_styletrueRUSTFS_TLS_PATHTLS 证书目录RUSTFS_OBS_ENDPOINTOpenTelemetry OTLP 上报端点如http://localhost:4318。Pool 扩容拓扑规则务必先读[!IMPORTANT]Pool 扩容 Notice单节点单盘SNSD部署仅支持使用本地路径独立运行不支持原地扩容也不能作为 Pool 加入集群。如需改为多盘拓扑请创建新部署并通过 S3 迁移数据。已有多盘 Pool 的端点和 Erasure Set 宽度应保持不变扩容应追加新的 Pool。使用省略号表达式扩容时每个 Pool 参数都必须包含省略号表达式并展开为至少两个磁盘端点。允许单节点多盘 Pool也允许多节点、每节点一盘的 Pool但必须满足 Erasure Set 布局和 EC 配置要求配置合法不代表能够容忍整台主机故障。这些拓扑规则与 MinIO 一致但两者的默认 parity 选择方式存在差异。扩容前请阅读 Pool 布局兼容性与回归测试说明。pool-layout-compatibility.md 进一步明确了细则一个纠删 Pool 至少需要两个磁盘端点单节点多盘 Pool 与多节点单盘 Pool 都可能合法已有 Pool 的盘数与 Set 宽度不可变把/data{1...4}改成/data{1...8}属于扩容旧 Pool追加/other-data{1...4}才是新建 PoolSet 由 2~16 块盘组成16 不是 Pool 总盘数上限显式存储类 parity 必须满足parity drives_per_set / 2且STANDARD parity RRS parity。拓扑被接受并不等于高可用保证——单节点 Pool 失去唯一宿主机即失去该 Pool 全部分片两盘EC:1的 Set 在丢失一盘后只有读仲裁没有写仲裁故障域与仲裁需要单独规划。从源码看 RustFS 的启动链路理解启动流程有助于排查部署问题。入口 rustfs/src/main.rs 只做两件事构建 hotpath 观测 guard然后调用rustfs::startup_entrypoint::run_process()。而 startup_entrypoint.rs 的run_process是进程级致命边界先构建 Tokio 运行时阻塞执行async_main退出前显式 drop dial9 观测 guard 并封存 trace 段任何错误都以[FATAL]前缀输出到 stderr 后process::exit(1)。async_mainstartup_entrypoint.rs的执行顺序是记录容器资源检测cgroup结果 → 外部前缀兼容引导 → 用Opt::parse_command解析 CLI 子命令info、tls、diagnose、inspect、connect register、server→ 服务端预检含可观测性初始化→run(config)。run阶段再依次初始化监听上下文、存储地基init_startup_storage_foundation基于config.volumes构建 endpoint pools、HTTP 服务器S3 控制台、存储运行时与服务运行时最后进入run_startup_runtime_lifecycle统一生命周期管理。这与容器入口 entrypoint.sh 的分工一致脚本负责参数归一化、凭据来源解析与校验、卷展开与目录创建、日志目录处理真正的服务逻辑全部由/usr/bin/rustfs二进制承担。运维深化KMS、Scanner 与可观测性作为延伸参考仓库docs/operations/下还维护了多份与日常运维强相关的权威文档KMS 后端安全docs/operations/kms-backend-security.mdRustFS 支持Local、Static、Vault KV2、Vault Transit、AWS KMS 五种后端其差异核心在于主密钥材料存放在哪、谁能读取。Local与Static仅限开发与测试生产推荐 Vault Transit 或 AWS KMS密钥材料永不离开 Vault/AWS。文档还特别警示默认构建对 MinIO 加密过的对象SSE-S3/SSE-KMS/SSE-C采取 fail-closed 策略读取会返回 S3InvalidObjectState迁移 MinIO 前务必抽样读取加密对象验证Scanner 运行时控制docs/operations/scanner-runtime-controls.mdScanner 是后台维护循环驱动用量统计、生命周期过期与分层、复制修复、heal 与 bitrot 检查。其运行参数按环境变量 → 持久化 admin 配置 → 内置默认值的顺序解析支持RUSTFS_SCANNER_*系列热更新调节S3 兼容矩阵docs/architecture/s3-compatibility-matrix.md以scripts/s3-tests/下的测试清单为唯一事实来源桶/对象基础操作、Multipart、标签、策略、Presigned URL、Range 条件读等均标记为 SupportedSSE 行明确RustFS 加解密自身对象MinIO SSE 对象在默认构建中不可读需rio-v2迁移构建。结语本文以 README_ZH.md 为主线完整覆盖了 RustFS 的六种部署路径、控制台入门、关键环境变量与 Pool 扩容拓扑并结合 entrypoint.sh、docker-compose-simple.yml、docker-buildx.sh、flake.nix 与核心启动源码补充了容器权限模型、凭据解析、卷展开与启动链路等实现细节。下一步建议按 S3 兼容矩阵 验证你依赖的 API 覆盖阅读 Pool 布局兼容性说明 后再规划多盘/多节点拓扑并参照docs/operations/下的 KMS、Scanner 与出站连接策略文档完成生产加固。【免费下载链接】rustfs2.3x faster than MinIO for 4KB object payloads. RustFS is an open-source, S3-compatible high-performance object storage system supporting migration and coexistence with other S3-compatible platforms such as MinIO and Ceph.项目地址: https://gitcode.com/GitHub_Trending/rus/rustfs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
