happyfish100 /fastdfs

FastDFS is a high performance distributed file system (DFS). It's major functions include: file storing, file syncing and file accessing, and design for high capacity and load balance. Wechat/Weixin public account (Chinese Language): fastdfs

★ 9,263⑂ 1,982👁 492⑃ 147● 747▤ 5
CGPL-3.0Created 2013-07-04
Download: FastDFS 6.18.1 releasedFastDFS-6.18.1 ↓6.18.12026-09-15
+0
Daily
9,263
stars
1,982
forks
492
watchers
147
prs
747
issues
5
releases

README

FastDFS is an open source high performance distributed file system. Its major
functions include: file storing, file syncing and file accessing (file uploading
and file downloading), and it can resolve the high capacity and load balancing
problem. FastDFS should meet the requirement of the website whose service based
on files such as photo sharing site and video sharing site.

 FastDFS Features

 grouped storage servers, simple and flexible
 peer-to-peer structure, no single point of failure
 The file ID is generated by FastDFS and serves as a credential for file access
  FastDFS does not require the traditional name server or meta server
 support large, medium, and small files well; supports the merged storage for small files
  and can store a massive number of small files
 the storage server supports multiple disks and supports data recovery for the single disk
 provide a nginx extension module that can seamlessly integrate with nginx
 support IPv6, NAT network and cross data center or hybrid cloud deployment
 support read-write separation and cross data center disaster backup
 provide truncate, append and modify APIs for appender files
 supports multi-threaded file upload and download, support resume from a broken point

 Architecture Interpretation

FastDFS has two roles: tracker and storage. The tracker takes charge of
scheduling and load balancing for file access. The storage store files and it's
function is file management including: file storing, file syncing, providing file
access interface. It also manage the meta data which are attributes representing
as key value pair of the file. For example: width=1024, the key is "width" and
the value is "1024".

The tracker and storage contain one or more servers. The servers in the tracker
or storage cluster can be added to or removed from the cluster by any time without
affecting the online services. The servers in the tracker cluster are peer to peer.

The storage servers organizing by the file group to obtain high capacity.
The storage system contains one or more groups whose files are independent among
these groups. The capacity of the whole storage system equals to the sum of all
groups' capacity. A file group contains one or more storage servers whose files
are same among these servers. The servers in a file group backup each other,
and all these servers are load balancing. When adding a storage server to a
group, files already existing in this group are replicated to this new server
automatically, and when this replication done, system will switch this server
online to providing storage services.

When the whole storage capacity is insufficient, you can add one or more
groups to expand the storage capacity. To do this, you need to add one or
more storage servers.

The identification of a file is composed of two parts: the group name and
the file name.

Client test code use client library please refer to the directory: client/test.

 Client SDK

 C Language: client/ subdir under FastDFS sour

Top issues

Latest release

FastDFS 6.18.1 released V6.18.1 2026-09-15
FastDFS v6.18.0 and v6.18.1 have been released, mainly featuring minor improvements and fixes for potential security vulnerabilities.

tracker.conf supports configuring the tracker server list. It is necessary to set static_tracker_servers to true. It is recommended to include the tracker server list file through the include directive. Both storage.conf and client.conf include this list file through the include directive, for example:
include tracker_servers.conf

The configuration items storage_sync_file_max_delay and storage_sync_file_max_time in tracker.conf support specifying time uni

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON