{"id":29461831,"url":"https://github.com/rustfs/rustfs","last_synced_at":"2026-04-19T11:01:17.852Z","repository":{"id":239141934,"uuid":"722597620","full_name":"rustfs/rustfs","owner":"rustfs","description":"🚀2.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.","archived":false,"fork":false,"pushed_at":"2026-04-16T10:53:59.000Z","size":19868,"stargazers_count":25967,"open_issues_count":95,"forks_count":1109,"subscribers_count":67,"default_branch":"main","last_synced_at":"2026-04-16T11:37:30.552Z","etag":null,"topics":["ai-native","ai-storage","amazon-s3","bigdata","cloud-native","filesystem","minio","multi-cloud","object-storage","objectstorage","rust","s3"],"latest_commit_sha":null,"homepage":"https://rustfs.com/download/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rustfs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":".github/AGENTS.md","dco":null,"cla":"CLA.md"}},"created_at":"2023-11-23T13:45:10.000Z","updated_at":"2026-04-16T11:16:36.000Z","dependencies_parsed_at":"2024-05-10T09:39:37.765Z","dependency_job_id":"2f56653f-0c65-401c-a09c-1629ece68879","html_url":"https://github.com/rustfs/rustfs","commit_stats":{"total_commits":13,"total_committers":3,"mean_commits":4.333333333333333,"dds":0.3846153846153846,"last_synced_commit":"a4a2a28ff58ee4b3d2a4cec8bc2b8a90f9c3ddaa"},"previous_names":["rustfs/rustfs"],"tags_count":94,"template":false,"template_full_name":null,"purl":"pkg:github/rustfs/rustfs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rustfs%2Frustfs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rustfs%2Frustfs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rustfs%2Frustfs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rustfs%2Frustfs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rustfs","download_url":"https://codeload.github.com/rustfs/rustfs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rustfs%2Frustfs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32004043,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-native","ai-storage","amazon-s3","bigdata","cloud-native","filesystem","minio","multi-cloud","object-storage","objectstorage","rust","s3"],"created_at":"2025-07-14T03:03:02.351Z","updated_at":"2026-04-19T11:01:17.843Z","avatar_url":"https://github.com/rustfs.png","language":"Rust","readme":"[![RustFS](https://repository-images.githubusercontent.com/722597620/0fa936a2-8164-4f53-867f-def4beb64b21)](https://rustfs.com)\n\n\u003cp align=\"center\"\u003eRustFS is a high-performance, distributed object storage system built in Rust.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/rustfs/rustfs/actions/workflows/ci.yml\"\u003e\u003cimg alt=\"CI\" src=\"https://github.com/rustfs/rustfs/actions/workflows/ci.yml/badge.svg\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/rustfs/rustfs/actions/workflows/docker.yml\"\u003e\u003cimg alt=\"Build and Push Docker Images\" src=\"https://github.com/rustfs/rustfs/actions/workflows/docker.yml/badge.svg\" /\u003e\u003c/a\u003e\n  \u003cimg alt=\"GitHub commit activity\" src=\"https://img.shields.io/github/commit-activity/m/rustfs/rustfs\"/\u003e\n  \u003cimg alt=\"Github Last Commit\" src=\"https://img.shields.io/github/last-commit/rustfs/rustfs\"/\u003e\n  \u003ca href=\"https://hellogithub.com/repository/rustfs/rustfs\" target=\"_blank\"\u003e\u003cimg src=\"https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=b95bcb72bdc340b68f16fdf6790b7d5b\u0026claim_uid=MsbvjYeLDKAH457\u0026theme=small\" alt=\"Featured｜HelloGitHub\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://trendshift.io/repositories/14181\" target=\"_blank\"\u003e\u003cimg src=\"https://trendshift.io/api/badge/repositories/14181\" alt=\"rustfs%2Frustfs | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"/\u003e\u003c/a\u003e \n\u003ca href=\"https://runacap.com/ross-index/q4-2025/\" target=\"_blank\" rel=\"noopener\"\u003e\u003cimg style=\"width: 260px; height: 55px\" src=\"https://runacap.com/wp-content/uploads/2026/01/ROSS_badge_white_Q4_2025.svg\" alt=\"ROSS Index - Fastest Growing Open-Source Startups in Q4 2025 | Runa Capital\" height=\"55\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://docs.rustfs.com/installation/\"\u003eGetting Started\u003c/a\u003e\n  · \u003ca href=\"https://docs.rustfs.com/\"\u003eDocs\u003c/a\u003e\n  · \u003ca href=\"https://github.com/rustfs/rustfs/issues\"\u003eBug reports\u003c/a\u003e\n  · \u003ca href=\"https://github.com/rustfs/rustfs/discussions\"\u003eDiscussions\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\nEnglish | \u003ca href=\"https://github.com/rustfs/rustfs/blob/main/README_ZH.md\"\u003e简体中文\u003c/a\u003e |\n  \u003ca href=\"https://readme-i18n.com/rustfs/rustfs?lang=de\"\u003eDeutsch\u003c/a\u003e |\n  \u003ca href=\"https://readme-i18n.com/rustfs/rustfs?lang=es\"\u003eEspañol\u003c/a\u003e |\n  \u003ca href=\"https://readme-i18n.com/rustfs/rustfs?lang=fr\"\u003efrançais\u003c/a\u003e |\n  \u003ca href=\"https://readme-i18n.com/rustfs/rustfs?lang=ja\"\u003e日本語\u003c/a\u003e |\n  \u003ca href=\"https://readme-i18n.com/rustfs/rustfs?lang=ko\"\u003e한국어\u003c/a\u003e |\n  \u003ca href=\"https://readme-i18n.com/rustfs/rustfs?lang=pt\"\u003ePortuguese\u003c/a\u003e |\n  \u003ca href=\"https://readme-i18n.com/rustfs/rustfs?lang=ru\"\u003eРусский\u003c/a\u003e\n\u003c/p\u003e\n\nRustFS is a high-performance, distributed object storage system built in Rust—one of the most loved programming languages worldwide. RustFS combines the simplicity of MinIO with the memory safety and raw performance of Rust. It offers full S3 compatibility, is completely open-source, and is optimized for data lakes, AI, and big data workloads.\n\nUnlike other storage systems, RustFS is released under the permissible Apache 2.0 license, avoiding the restrictions of AGPL. With Rust as its foundation, RustFS delivers superior speed and secure distributed features for next-generation object storage.\n\n## Feature \u0026 Status\n\n- **High Performance**: Built with Rust to ensure maximum speed and resource efficiency.\n- **Distributed Architecture**: Scalable and fault-tolerant design suitable for large-scale deployments.\n- **S3 Compatibility**: Seamless integration with existing S3-compatible applications and tools.\n- **OpenStack Swift API**: Native support for Swift protocol with Keystone authentication.\n- **OpenStack Keystone Integration**: Native support for OpenStack Keystone authentication with X-Auth-Token headers.\n- **Data Lake Support**: Optimized for high-throughput big data and AI workloads.\n- **Open Source**: Licensed under Apache 2.0, encouraging unrestricted community contributions and commercial usage.\n- **User-Friendly**: Designed with simplicity in mind for easy deployment and management.\n\n| Feature                 | Status       | Feature                  | Status           |\n| :---------------------- | :----------- | :----------------------- | :--------------- |\n| **S3 Core Features**    | ✅ Available | **Bitrot Protection**    | ✅ Available     |\n| **Upload / Download**   | ✅ Available | **Single Node Mode**     | ✅ Available     |\n| **Versioning**          | ✅ Available | **Bucket Replication**   | ✅ Available     |\n| **Logging**             | ✅ Available | **Lifecycle Management** | 🚧 Under Testing |\n| **Event Notifications** | ✅ Available | **Distributed Mode**     | 🚧 Under Testing |\n| **K8s Helm Charts**     | ✅ Available | **RustFS KMS**           | 🚧 Under Testing |\n| **Keystone Auth**       | ✅ Available | **Multi-Tenancy**        | ✅ Available     |\n| **Swift API**           | ✅ Available | **Swift Metadata Ops**   | 🚧 Partial       |\n\n## RustFS vs MinIO Performance\n\n**Stress Test Environment:**\n\n| Type    | Parameter | Remark                                                   |\n| ------- | --------- | -------------------------------------------------------- |\n| CPU     | 2 Core    | Intel Xeon (Sapphire Rapids) Platinum 8475B, 2.7/3.2 GHz |\n| Memory  | 4GB       |                                                          |\n| Network | 15Gbps    |                                                          |\n| Drive   | 40GB x 4  | IOPS 3800 / Drive                                        |\n\n\u003chttps://github.com/user-attachments/assets/2e4979b5-260c-4f2c-ac12-c87fd558072a\u003e\n\n### RustFS vs Other Object Storage\n\n| Feature                | RustFS                                                                                                                                                | Other Object Storage                                                                     |\n| :--------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------- |\n| **Console Experience** | **Powerful Console**\u003cbr\u003eComprehensive management interface.                                                                                           | **Basic / Limited Console**\u003cbr\u003eOften overly simple or lacking critical features.         |\n| **Language \u0026 Safety**  | **Rust-based**\u003cbr\u003eMemory safety by design.                                                                                                            | **Go or C-based**\u003cbr\u003ePotential for memory GC pauses or leaks.                            |\n| **Data Sovereignty**   | **No Telemetry / Full Compliance**\u003cbr\u003eGuards against unauthorized cross-border data egress. Compliant with GDPR (EU/UK), CCPA (US), and APPI (Japan). | **Potential Risk**\u003cbr\u003ePossible legal exposure and unwanted data telemetry.               |\n| **Licensing**          | **Permissive Apache 2.0**\u003cbr\u003eBusiness-friendly, no \"poison pill\" clauses.                                                                             | **Restrictive AGPL v3**\u003cbr\u003eRisk of license traps and intellectual property pollution.    |\n| **Compatibility**      | **100% S3 Compatible**\u003cbr\u003eWorks with any cloud provider or client, anywhere.                                                                          | **Variable Compatibility**\u003cbr\u003eMay lack support for local cloud vendors or specific APIs. |\n| **Edge \u0026 IoT**         | **Strong Edge Support**\u003cbr\u003eIdeal for secure, innovative edge devices.                                                                                 | **Weak Edge Support**\u003cbr\u003eOften too heavy for edge gateways.                              |\n| **Risk Profile**       | **Enterprise Risk Mitigation**\u003cbr\u003eClear IP rights and safe for commercial use.                                                                        | **Legal Risks**\u003cbr\u003eIntellectual property ambiguity and usage restrictions.               |\n\n## Staying ahead\n\nStar RustFS on GitHub and be instantly notified of new releases.\n\n\u003cimg src=\"https://github.com/user-attachments/assets/7ee40bb4-3e46-4eac-b0d0-5fbeb85ff8f3\" /\u003e\n\n## Quickstart\n\nTo get started with RustFS, follow these steps:\n\n### 1. One-click Installation (Option 1)\n\n```bash\ncurl -O https://rustfs.com/install_rustfs.sh \u0026\u0026 bash install_rustfs.sh\n```\n\n### 2. Docker Quick Start (Option 2)\n\nThe RustFS container runs as a non-root user `rustfs` (UID `10001`). If you run Docker with `-v` to mount a host directory, please ensure the host directory owner is set to `10001`, otherwise you will encounter permission denied errors.\n\n```bash\n# Create data and logs directories\nmkdir -p data logs\n\n# Change the owner of these directories\nchown -R 10001:10001 data logs\n\n# Using latest version\ndocker run -d -p 9000:9000 -p 9001:9001 -v $(pwd)/data:/data -v $(pwd)/logs:/logs rustfs/rustfs:latest\n\n# Using specific version\ndocker run -d -p 9000:9000 -p 9001:9001 -v $(pwd)/data:/data -v $(pwd)/logs:/logs rustfs/rustfs:1.0.0-alpha.76\n```\n\nIf you use [podman](https://github.com/containers/podman) instead of docker, you can install the RustFS with the below command\n\n```bash\npodman run -d -p 9000:9000 -p 9001:9001 -v $(pwd)/data:/data -v $(pwd)/logs:/logs rustfs/rustfs:latest\n```\n\nYou can also use Docker Compose. Using the `docker-compose.yml` file in the root directory:\n\n```bash\ndocker compose --profile observability up -d\n```\n\nSimilarly, you can run the command with podman\n\n```bash\npodman compose --profile observability up -d\n```\n\n**NOTE**: We recommend reviewing the `docker-compose.yml` file before running. It defines several services including Grafana, Prometheus, and Jaeger, which are helpful for RustFS observability. If you wish to start Redis or Nginx containers, you can specify the corresponding profiles.\n\n### 3\\. Build from Source (Option 3) - Advanced Users\n\nFor developers who want to build RustFS Docker images from source with multi-architecture support:\n\n```bash\n# Build multi-architecture images locally\n./docker-buildx.sh --build-arg RELEASE=latest\n\n# Build and push to registry\n./docker-buildx.sh --push\n\n# Build specific version\n./docker-buildx.sh --release v1.0.0 --push\n\n# Build for custom registry\n./docker-buildx.sh --registry your-registry.com --namespace yourname --push\n```\n\nThe `docker-buildx.sh` script supports:\n\n- **Multi-architecture builds**: `linux/amd64`, `linux/arm64`\n- **Automatic version detection**: Uses git tags or commit hashes\n- **Registry flexibility**: Supports Docker Hub, GitHub Container Registry, etc.\n- **Build optimization**: Includes caching and parallel builds\n\nYou can also use Make targets for convenience:\n\n```bash\nmake docker-buildx                    # Build locally\nmake docker-buildx-push               # Build and push\nmake docker-buildx-version VERSION=v1.0.0  # Build specific version\nmake help-docker                      # Show all Docker-related commands\n```\n\n\u003e **Heads-up (macOS cross-compilation)**: macOS keeps the default `ulimit -n` at 256, so `cargo zigbuild` or `./build-rustfs.sh --platform ...` may fail with `ProcessFdQuotaExceeded` when targeting Linux. The build script attempts to raise the limit automatically, but if you still see the warning, run `ulimit -n 4096` (or higher) in your shell before building.\n\n### 4\\. Build with Helm Chart (Option 4) - Cloud Native\n\nFollow the instructions in the [Helm Chart README](https://charts.rustfs.com/) to install RustFS on a Kubernetes cluster.\n\n### 5\\. Nix Flake (Option 5)\n\nIf you have [Nix with flakes enabled](https://nixos.wiki/wiki/Flakes#Enable_flakes):\n\n```bash\n# Run directly without installing\nnix run github:rustfs/rustfs\n\n# Build the binary\nnix build github:rustfs/rustfs\n./result/bin/rustfs --help\n\n# Or from a local checkout\nnix build\nnix run\n```\n\n### 6\\. X-CMD (Option 6)\n\nIf you are an [x-cmd](https://www.x-cmd.com/install/rustfs) user:\n\n```bash\n# Run directly without installing\nx rustfs\n\n# Download the binary and install it to the global environment\nx env use rustfs\nrustfs --help\n```\n\n---\n\n### Accessing RustFS\n\n1. **Access the Console**: Open your web browser and navigate to `http://localhost:9001` to access the RustFS console.\n    - Default credentials: `rustfsadmin` / `rustfsadmin`\n2. **Create a Bucket**: Use the console to create a new bucket for your objects.\n3. **Upload Objects**: You can upload files directly through the console or use S3-compatible APIs/clients to interact with your RustFS instance.\n\n**NOTE**: To access the RustFS instance via `https`, please refer to the [TLS Configuration Docs](https://docs.rustfs.com/integration/tls-configured.html).\n\n### OIDC Roles Claim (Microsoft Entra ID)\n\nRustFS supports mapping an OIDC claim containing role values into the existing\nauthorization pipeline. The `roles_claim` setting is **optional**: when unset or\nempty, only the `groups` claim contributes to authorization (same as older\nRustFS releases). For Microsoft Entra ID app roles, set `roles_claim=roles` so\nboth console admin checks and bucket IAM policies can evaluate those roles.\n\nExample environment configuration (opt-in roles claim):\n\n```bash\nRUSTFS_IDENTITY_OPENID_ENABLE=on\nRUSTFS_IDENTITY_OPENID_CONFIG_URL=\"https://login.microsoftonline.com/\u003ctenant-id\u003e/v2.0/.well-known/openid-configuration\"\nRUSTFS_IDENTITY_OPENID_CLIENT_ID=\"\u003cclient-id\u003e\"\nRUSTFS_IDENTITY_OPENID_CLIENT_SECRET=\"\u003cclient-secret\u003e\"\nRUSTFS_IDENTITY_OPENID_SCOPES=\"openid,profile,email\"\nRUSTFS_IDENTITY_OPENID_GROUPS_CLAIM=\"groups\"\nRUSTFS_IDENTITY_OPENID_ROLES_CLAIM=\"roles\"\n```\n\nPolicy condition example (evaluate app roles directly with `jwt:roles`; when\n`roles_claim` is configured, RustFS also merges those values into `jwt:groups`\nfor backward compatibility with older policies):\n\n```json\n{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Effect\": \"Allow\",\n      \"Action\": [\"admin:*\"],\n      \"Resource\": [\"arn:aws:s3:::*\"],\n      \"Condition\": {\n        \"ForAnyValue:StringEquals\": {\n          \"jwt:roles\": [\"RustFS.ConsoleAdmin\"]\n        }\n      }\n    }\n  ]\n}\n```\n\n## Documentation\n\nFor detailed documentation, including configuration options, API references, and advanced usage, please visit our [Documentation](https://docs.rustfs.com).\n\n## Getting Help\n\nIf you have any questions or need assistance:\n\n- Check the [FAQ](https://github.com/rustfs/rustfs/discussions/categories/q-a) for common issues and solutions.\n- Join our [GitHub Discussions](https://github.com/rustfs/rustfs/discussions) to ask questions and share your experiences.\n- Open an issue on our [GitHub Issues](https://github.com/rustfs/rustfs/issues) page for bug reports or feature requests.\n\n## Links\n\n- [Documentation](https://docs.rustfs.com) - The manual you should read\n- [Changelog](https://github.com/rustfs/rustfs/releases) - What we broke and fixed\n- [GitHub Discussions](https://github.com/rustfs/rustfs/discussions) - Where the community lives\n\n## Contact\n\n- **Bugs**: [GitHub Issues](https://github.com/rustfs/rustfs/issues)\n- **Business**: [hello@rustfs.com](mailto:hello@rustfs.com)\n- **Jobs**: [jobs@rustfs.com](mailto:jobs@rustfs.com)\n- **General Discussion**: [GitHub Discussions](https://github.com/rustfs/rustfs/discussions)\n- **Contributing**: [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## Contributors\n\nRustFS is a community-driven project, and we appreciate all contributions. Check out the [Contributors](https://github.com/rustfs/rustfs/graphs/contributors) page to see the amazing people who have helped make RustFS better.\n\n\u003ca href=\"https://github.com/rustfs/rustfs/graphs/contributors\"\u003e\n\u003cimg src=\"https://opencollective.com/rustfs/contributors.svg?width=890\u0026limit=500\u0026button=false\" alt=\"Contributors\" /\u003e\n\u003c/a\u003e\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=rustfs/rustfs\u0026type=date\u0026legend=top-left)](https://www.star-history.com/#rustfs/rustfs\u0026type=date\u0026legend=top-left)\n\n## License\n\n[Apache 2.0](https://opensource.org/licenses/Apache-2.0)\n\n**RustFS** is a trademark of RustFS, Inc. All other trademarks are the property of their respective owners.\n","funding_links":[],"categories":["Rust","其他_大数据","Repos","Applications","\u003ca name=\"Rust\"\u003e\u003c/a\u003eRust"],"sub_categories":["资源传输下载","Database"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frustfs%2Frustfs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frustfs%2Frustfs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frustfs%2Frustfs/lists"}