trapexit /mergerfs

a featureful union filesystem

★ 5,957⑂ 227👁 73⑃ 819● 681▤ 92
C++NOASSERTIONCreated 2014-03-24trapexit.github.io/mergerfs/
下载:mergerfs v2.42.0mergerfs-2.42.0 ↓2.42.02026-05-08
+3
日增长
5,957
stars
227
forks
73
watchers
819
prs
681
issues
92
releases

README

mergerfs - a featureful union filesystem

mergerfs is a
FUSE based
union filesystem geared
towards simplifying storage and management of files across numerous
commodity storage devices. It is similar to mhddfs, unionfs,
aufs, DrivePool,
etc.


 Features

 Logically combine numerous filesystems/paths into a single
  mount point (JBOFS: Just a Bunch of FileSystems)
 Combine paths of the same or different filesystems
 Ability to add or remove filesystems/paths without impacting the
  rest of the data
 Unaffected by individual filesystem failure
 Configurable file selection and creation placement
 File IO
  passthrough
  for near native IO performance (where supported)
 Works with filesystems of any size
 Works with filesystems of almost any
  type
 Ignore read-only filesystems when creating files
 Hard links
 Hard link copy-on-write /
  CoW
 Runtime configurable
 Support for extended attributes (xattrs)
 Support for file attributes (chattr)
 Support for POSIX ACLs


 Non-features

 Read/write overlay on top of read-only filesystem like OverlayFS
 File whiteout
 RAID like parity calculation (see SnapRAID)
 Redundancy
 Splitting of files across branches


 How it works

mergerfs logically merges multiple filesystem paths together. Not
block devices, not filesystem mounts, just paths. It acts as a proxy
to the underlying filesystem paths. Combining the behaviors of some
functions and being a selector for others.

When the contents of a directory are requested mergerfs combines the
list of files from each directory, deduplicating entries, and returns
that list.

When a file or directory is created a policy is first run to determine
which branch will be selected for the creation.

For functions which change attributes or remove the file the behavior
may be applied to all instances found.

The way in which mergerfs behaves is controlled by the
config/options/settings. More
specifically by
policies.


 Visualization


A         +      B        =       C
/disk1           /disk2           /merged
|                |                |
+-- /dir1        +-- /dir1        +-- /dir1
|   |            |   |            |   |
|   +-- file1    |   |            |   +-- file1
|                |   +-- file2    |   +-- file2
|                |   +-- file3    |   +-- file3
|                |                |
+-- /dir2        |                +-- /dir2
|   |            |                |   |
|   +-- file4    |                |   +-- file4
|                |                |
|                +-- /dir3        +-- /dir3
|                |   |            |   |
|                |   +-- file5    |   +-- file5
|                |                |
+-- file6        |                +-- file6
+-- file7        +-- file7        +-- file7



 QuickStart

https://trapexit.github.io/mergerfs/latest/quickstart/


 Documentation

https://trapexit.github.io/mergerfs


 Support

https://trapexit.github.io/mergerfs/latest/support/


 Sponsorship and Donations

https://github.com/trapexit/support

Top issues

Discussions

Latest release

mergerfs v2.42.0 2.42.0 2026-05-08
mergerfs v2.42.0

 Donations / Sponsorship

If you find mergerfs useful please consider supporting its ongoing development.

https://github.com/trapexit/support

 New features

 lup (least used percentage) policy: selects the branch with the lowest used space percentage.
 mount.mergerfs now includes the -n flag to support mounting without updating /etc/mtab.

 Improvements

 Better lock management and behavior with open files. Reduction of contention.
 Custom filename dedup strategy improving directory reading performance
 Pre-calculate part of the file inode within readdir si

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