80 Star 601 Fork 130

GVPhappyfish100 / FastCFS

Create your Gitee Account
Explore and code with more than 8 million developers,Free private repositories !:)
Sign up
Clone or Download
Sync branch
Notice: Creating folder will generate an empty file .keep, because not support in Git

FastCFS -- a high performance general distributed file system for databases, K8s and KVM etc.

English | Chinese

1. About

FastCFS is a general distributed file system with strong consistency, high performance, high availability and supporting 10 billion massive files. FastCFS can be used as the back-end storage of databases (MySQL, PostgresSQL, Oracle etc.), K8s, KVM, FTP, SMB and NFS.

Main Features

  • High performance on the premise of strong data consistency: performance is more better than ceph
  • Fully compatible with POSIX, supporting file lock and 10 billion massive files
  • High availability: no single point & automatic failover
  • Easy to use:
    • simple and efficient architecture and native implementation
    • independent of third-party components
    • built-in operation and maintenance tools
  • Strong random write performance: FCFS allocates space based on the trunk file, converts random writes from the client to sequential writes

Classical Application Scene

  • Database: supports two storage methods (conventional exclusive data and high-level shared data) and database cloudification
  • File Storage: documents, pictures, videos, etc., FastCFS is easier to integrate with general software than the object storage
  • Unified Storage: database and file storage share a storage cluster, which significantly improves the utilization of storage resources
  • High Performance Computing: FastCFS with high reliability and high performance is naturally suitable for the HPC scene
  • Video monitoring: smooth writing for multi-channel videos with HDD such as SATA because FastCFS uses sequential writing approach

2. Current Version: V4.3

3. Supported Platforms

  • Linux: Kernel version >= 3.10 (Full support, >= 4.18 is recommended)
  • MacOS or FreeBSD (Only server side)

4. Dependencies

5. Installation

5.1 DIY installation

you can use Cluster Operation Tool to deploy FastCFS

step by step please see INSTALL

recommend to execute libfuse_setup.sh for compiling and installing libfuse

5.2 easy installation

libfastcommon, libserverframe, fastDIR, faststore and FastCFS can be compiled, installed and auto configurated by fastcfs.sh

fastcfs.sh can automatically pull or update above six projects codes from GitHub, compile and install according to dependency orders, and automatically generate cluster related configuration files according to the config templates.

git clone https://github.com/happyfish100/FastCFS.git; cd FastCFS/

fastcfs.sh usage:

* install: pull/update codes from gitee, then make and install
* config: copy config files and configure them with local ip
* start | stop | restart: for service processes control

one click to build (deploy and run) single node demo environment (MUST run by root):


or execute following commands (MUST run by root):

./fastcfs.sh install
./fastcfs.sh config --force
./fastcfs.sh restart

now you can see the mounted path of FastCFS by the command:

df -h /opt/fastcfs/fuse | grep fuse

6. Benchmark

FastCFS has huge better performance than Ceph: the IOPS ratio of sequential write is 6.x, sequential read is 2.x, random write is about 2.0.

7. K8s CSI Driver


8. Chinese Relative articles

CSDN blog

9. TODO List

  • [fstore] data recovery after single disk fault (done)
  • [fstore] after the machine recovery, the data masters should be rebalanced (done)
  • [fauth & fdir & fstore] leader election uses more than half principle to prevent brain-split (done)
  • [fauth & fdir & fstore] import public vote node under 2 copies scene to prevent brain-split (done)
  • [fdir & fstore] binlog deduplication and historical data deletion (done)
  • [fdir & fstore] data submission by majority confirmation to ensure data consistency (done)
  • [fdir & fstore] for two replicas, the data submission majority mechanism is intelligent (done)
  • [fstore] file read & write performance optimization (done)
  • [fdir & api] POSIX compatibility test and improvement (done)
  • [fstore] slice storage engine plugin to support massive data with limited memory (done)
  • [all] adapt to RDMA network to break through network bottlenecks (doing)
  • [api] provide Java native API (doing)
  • [all] cluster online expansion
  • [fstore] hierarchical storage & slice merging: supporting two-level storage, such as SSD + HDD

10. Business Support

We provide technical support service and customized development. Welcome to use WeChat or email for discuss.

11. Contact us

email: 384681(at)qq(dot)com

WeChat subscription: search "fastdfs" for the related articles (Chinese Only)


FastCFS是一款支持百亿级海量文件的高性能通用分布式文件系统 ,可以作为数据库(MySQL、PostgresSQL、Oracle等)、k8s、KVM和NFS等系统的后端存储。 expand collapse





Load More
can not load any more