ojford/mergerfs

mergerfs Docker镜像

镜像概述

本镜像封装了trapexit/mergerfs工具，mergerfs是一款用户空间文件系统（FUSE），可将多个独立目录合并为一个虚拟挂载点，方便用户统一管理分散的存储资源，同时保留原有目录结构的灵活性。

核心功能

1. 目录合并：将多个物理目录整合为单一虚拟挂载点，支持多种文件分配策略（如轮询、最小空间优先等）。
2. 灵活配置：允许通过自定义命令或runtime config调整挂载参数，满足不同场景需求。
3. 权限兼容：保持原有文件的权限与属性，确保数据访问的一致性。

使用场景

• 家庭NAS存储整合：将多个硬盘分区或目录合并为统一的存储池，简化文件管理。
• 服务器多磁盘管理：整合分散的磁盘空间，提升存储利用率。
• 开发环境资源集中：将多个项目目录合并为单一访问入口，方便开发与测试。

配置说明

1. 目录挂载要求：需将待合并的目录挂载到容器内的/mnt/bricksets/下的子目录（如/mnt/bricksets/dir1、/mnt/bricksets/dir2）。
2. 合并结果：容器会自动在/mnt/pools/下创建同名的合并挂载点（如/mnt/pools/dir1对应/mnt/bricksets/dir1的合并结果）。
3. 参数调整：若需修改默认设置，可通过自定义命令或参考https://github.com/trapexit/mergerfs#runtime-config%E8%BF%9B%E8%A1%8C%E9%85%8D%E7%BD%AE%E3%80%82
4. 注意事项：容器不会自动执行fusermount -u卸载操作，需手动处理。

部署示例

Docker Run命令

bash
docker run -d \
  --privileged \
  -v /host/path/dir1:/mnt/bricksets/dir1 \
  -v /host/path/dir2:/mnt/bricksets/dir2 \
  -v /host/path/mounted_pool:/mnt/pools/dir1 \ # 可选：将合并后的目录挂载到主机
  ojford/mergerfs

Docker Compose配置

yaml
version: '3'
services:
  mergerfs:
    image: ojford/mergerfs
    privileged: true
    volumes:
      - /host/path/dir1:/mnt/bricksets/dir1
      - /host/path/dir2:/mnt/bricksets/dir2
      - /host/path/mounted_pool:/mnt/pools/dir1
    restart: unless-stopped

许可证

mergerfs工具本身采用ISC许可证，内容如下：

ISC License

Copyright (c) 2016, Antonio SJ Musumeci <trapexit@spawn.link>

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

详情见https://github.com/trapexit/mergerfs/blob/master/LICENSE%E3%80%82