slink42/mergerfs

docker-mergerfs

镜像概述

本镜像基于Ubuntu 20.04系统，提供mergerfs和unionfs两种文件系统合并挂载功能，包含实用脚本，支持灵活的配置选项，帮助用户将多个存储目录合并为单一访问点，适用于多设备存储整合场景。

核心功能

• 支持mergerfs和unionfs两种文件系统合并方式
• 可配置用户ID（PUID）、组ID（PGID）及时区（TZ）
• 灵活设置合并分支（MFS_BRANCHES/UFS_BRANCHES）与输出路径（MERGED_DEST）
• 提供默认参数配置，同时支持自定义挂载选项（MFS_USER_OPTS/UFS_USER_OPTS）

使用场景

• 家庭媒体服务器：合并多个硬盘的媒体文件目录
• 数据备份管理：统一访问多个备份存储目录
• 多设备存储整合：将本地/网络存储目录合并为单一逻辑路径

配置说明

部署示例

Docker Compose配置

yaml
version: '3'
services:
  mergerfs:
    container_name: mergerfs
    image: slink42/mergerfs
    restart: always
    network_mode: "bridge"
    volumes:
      - /your/mount/points/parent/folder:/mnt:rshared
    devices:
      - /dev/fuse
    cap_add:
      - SYS_ADMIN
    security_opt:
      - apparmor:unconfined
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=Australia/Sydney
      - MERGED_DEST=/mnt/data
      - MFS_BRANCHES=/mnt/local1=NC:/mnt/local2=NC:/mnt/local3=NC

Docker Run命令

bash
docker run -d \
    --name=mergerfs \
    --cap-add SYS_ADMIN \
    --device /dev/fuse \
    --security-opt apparmor=unconfined \
    -v /your/mount/points/parent/folder:/mnt:shared \
    -e PUID=${PUID} \
    -e PGID=${PGID} \
    -e TZ=Australia/Sydney \
    -e MERGED_DEST=/mnt/data \
    -e MFS_BRANCHES=/mnt/local1=NC:/mnt/local2=NC:/mnt/local3=NC \
    slink42/mergerfs

准备步骤

1. 创建需要合并的目录：

bash
mkdir -p /your/mount/points/parent/folder/local1
mkdir -p /your/mount/points/parent/folder/local2
mkdir -p /your/mount/points/parent/folder/local3

2. 启动容器后查看日志确认配置：

bash
docker logs mergerfs

参考项目

• https://github.com/wiserain/docker-rclone
• https://github.com/madslundt/docker-cloud-media-scripts