AgentSkillsCN

rustfs

RustFS——用Rust编写的S3兼容分布式对象存储。在使用RustFS构建应用，或询问其API、配置、部署、Docker设置，或集成时使用。获取最新版的实时文档，以了解最新详情。

SKILL.md
--- frontmatter
name: rustfs
description: "RustFS — S3-compatible distributed object storage written in Rust. Use when building with RustFS or asking about its APIs, configuration, deployment, Docker setup, or integration. Fetch live documentation for up-to-date details."

RustFS

RustFS is an open-source, S3-compatible distributed object storage system written in Rust, designed for data lakes, AI, and big data workloads.

Documentation

GitHub repo

Key Capabilities

  • •Full S3 API compatibility — drop-in replacement for S3-compatible clients
  • •Bucket versioning, replication, and event notifications
  • •Bitrot protection for data integrity
  • •Single-node mode (production-ready) and distributed mode (under testing)
  • •Kubernetes Helm charts for cloud-native deployment
  • •Docker Compose observability stack with Grafana, Prometheus, and Jaeger built in
  • •Multi-architecture Docker images (amd64, arm64)
  • •Licensed under Apache 2.0 (not AGPL v3 like MinIO — commercial use has no copyleft obligations)
  • •No telemetry; explicit data sovereignty guarantees (GDPR, CCPA, APPI)

Best Practices

Set Docker volume ownership to UID 10001. The container runs as non-root user rustfs (UID 10001). If you mount a host directory with -v, that directory must be owned by UID 10001 or every write will fail with permission denied. Run chown -R 10001:10011 /your/data/path before starting the container.

Default credentials are rustfsadmin / rustfsadmin, not MinIO defaults. The S3 API listens on port 9000; the management console is on port 9001. Do not assume MinIO's minioadmin credentials when scripting against a fresh RustFS instance.

Do not use distributed mode in production yet. As of early 2026, distributed mode is still under testing. Single-node mode is the only production-ready deployment target. Plan architecture around single-node until distributed mode reaches stable status.