cubefs /cubefs
cloud-native distributed storage
★ 5,697⑂ 716👁 102⑃ 2,888● 1,109▤ 44
+3
日增长
5,697
stars
716
forks
102
watchers
2,888
prs
1,109
issues
44
releases
README
CubeFS
| Community Meeting|
|------------------|
| The CubeFS Project holds bi-weekly community online meeting. To join or watch previous meeting notes and recordings, please see meeting schedule and meeting minutes. |
Overview
CubeFS ("储宝" in Chinese) is an open-source cloud-native distributed file & object storage system, hosted by the Cloud Native Computing Foundation (CNCF) as a graduated project.
What can you build with CubeFS
As an open-source distributed storage, CubeFS can serve as your datacenter filesystem, data lake storage infra, and private or hybrid cloud storage.
Moreover, it can be run in public cloud services, providing cache acceleration and file system semantics on top of public cloud storage such as S3.
In particular, CubeFS enables the separation of storage/compute architecture for databases, search systems, and AI/ML applications.
Some key features of CubeFS include:
- Multiple access protocols such as POSIX, HDFS, S3, and its own REST API
- Highly scalable metadata service with strong consistency
- Performance optimization of large/small files and sequential/random writes
- Multi-tenancy support with better resource utilization and tenant isolation
- Hybrid cloud I/O acceleration through multi-level caching
- Flexible storage policies, high-performance replication or low-cost erasure coding
Documents
- English version: https://cubefs.io/docs/master/overview/introduction.html
- Chinese version: https://cubefs.io/zh/docs/master/overview/introduction.html
Community
- Homepage: cubefs.io
- Mailing list: [email protected].
- Please subscribe on the page https://groups.io/g/cubefs-users/ or send your email to [email protected] to apply.
- Slack: cubefs.slack.com
- WeChat: detail see here
- Twitter: cubefs_storage
Governance
Governance documentation plays a crucial role in establishing clear guidelines, procedures, and structures within an organization or project
Contribute
Contributing to CubeFS
There is a clear definition of roles and their promotion paths.
- Becoming a Maintainer
- Becoming a committer
- Becoming a TSC Member
Partners and Users
There is the list of users and success stories ADOPTERS.md.
Reference
Haifeng Liu, et al., CFS: A Distributed File System for Large Scale Container Platforms. SIGMOD‘19, June 30-July 5, 2019, Amsterdam, Netherlands.
For more information, please refer to https://dl.acm.org/citation.cfm?doid=3299869.3314046 and https://arxiv.org/abs/1911.03001
License
CubeFS is licensed under the Apache License, Version 2.0.
For detail see LICENSE and NOTICE.
Note
The master branch may be in an unstable or even broken state during development. Please use releases instead of the master branch in order to get a stable set of binaries.
Star HistoryTop issues
#1920[Developer Activities]: 2023 The inaugural Developer Activities44 comments · 2023-04-18#3650[Bug]: performance tuning help need17 comments · 2025-01-19#3173[Bug]: the datanodes is not WRITABLE11 comments · 2024-03-05#1580[Bug Report] need add lock for snapshot newMetaItemIterator10 comments · 2022-10-27#3922[Enhancement]: Blobstore: add op stage latency timeout log for access/sdk/stream and blobnode8 comments · 2025-08-29#3810[Bug]: BlobStore: Read performance drops sharply from 18000 iops to 6000 iops8 comments · 2025-05-20#3623[Bug]: There is a high probability of bad file descriptor appearing in business reading.8 comments · 2025-01-06#3064[Feature]: 2024 plan8 comments · 2024-02-01
Discussions
#4118how does the datanode handle the slow io and slow disk?1 comments · 2026-11-04#4113How can I change the install machine for master node?1 comments · 2026-10-16#4110where can I get the images source which can download by docker pull ?1 comments · 2026-10-12#4097rdma功能有排期计划吗?0 comments · 2026-09-08#4096how can I use one k8s node to deploy the cubefs ?1 comments · 2026-09-01#4092Title: [Bug/Question] software caused connection abort during large PVC restore with custom Go backup tool0 comments · 2026-08-24#4088how can I use the snapshot of the cubefs?1 comments · 2026-08-19#4087how can I do the stability test and durability test for cubefs?0 comments · 2026-08-14
Latest release
Release v3.6.0 - 2026/08/14 v3.6.0 2026-08-12UPGRAGDE NOTICE If you are using a CubeFS version earlier than v3.5.0, please refer to the UPGRADE NOTICE in version v3.5.0 for detailed upgrade steps and upgrade to v3.5.0 first. Upgrade nodes in this order: master → metanode → datanode → flashnode → objectnode → lcnode → cli → client. _Upgrade lcnode and flashnode when needed._ Before enabling MetaPartition learner-based decommissioning (enableMpDecommissionByLearner), upgrade all MetaNodes first. Clients should use versions later than 3.2.0. Older versions need to be upgraded promptly; otherwise, there will be a risk of comprom