+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
#342[Feature] On input/output error try next available mount26 comments · 2016-12-07#862filename / filepath policy branch filters20 comments · 2021-01-07#847writing redundantly20 comments · 2020-12-03#1607NFS xattr regression with mergerfs after upgrade to kernel 6.15.1115 comments · 2026-01-11#1589NFS exporting mergerfs with a mix of RO and RW mounts and func.readdir=cor will randomly list the same file twice15 comments · 2025-11-23#1332fluctuating write performance13 comments · 2024-05-02#1347Mergerfs mount not responsive intermittently9 comments · 2024-07-24#1468Segfault: Race condition in concurrent cache operations with high thread counts8 comments · 2025-05-23
Discussions
#1673Performance / CPU usage issue(?)1 comments · 2026-06-29#1665Exclude specific file or folder from mergerFS pool?1 comments · 2026-05-11#1622Drive not mounting into pool1 comments · 2026-03-09#1615File path selection based on newest inode1 comments · 2026-02-10#1611Is it possible to reserve space on disks?2 comments · 2026-01-21#1608Compatibility with Opencloud - anything in mergerfs options?1 comments · 2026-01-13#1602Container volumes with ID Maps mounted in a merged directory1 comments · 2025-12-13#1599Description of pfrd in the docs1 comments · 2025-12-09
Latest release
mergerfs v2.42.0 2.42.0 2026-05-08mergerfs 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