hvalev/mergerfs

mergerfs-docker

https://github.com/hvalev/mergerfs-docker/actions/workflows/build.yml/badge.svg](https://github.com/hvalev/mergerfs-docker/actions/workflows/build.yml) !Shiny%20version !Docker Pulls !Docker Image Size (latest by date)

所有功劳归于https://github.com/trapexit/mergerfs%E3%80%82

概述

本容器旨在提供一个简单的解决方案，通过mergerfs和Docker将多个硬盘的内容合并到单一挂载点。现有多个mergerfs容器化方案，但大多缺乏定期更新、未开源Dockerfile（可能包含加密矿工）且使用复杂。本仓库致力于解决这些问题：将硬盘作为卷挂载到/disks，mergerfs会将其合并到/merged；通过:shared绑定可将/merged与主机共享，仅需修改主机卷路径即可完成配置。

核心功能与特性

• 多架构支持：兼容amd/arm架构
• 简单合并：挂载硬盘至/disks即可自动合并到/merged
• 主机共享：使用:shared绑定将/merged与主机共享
• 安全可靠：开源Dockerfile，无加密矿工，定期更新
• 灵活配置：支持自定义mergerfs参数及配置文件

使用场景

适用于需要将多个物理硬盘或分区的存储空间合并为一个逻辑空间的场景，如家庭媒体服务器、文件共享服务器等，方便统一管理和访问多个存储设备的内容。

使用方法

Docker run

bash
docker run -v /mnt/nd1:/disks/nd1 -v /mnt/nd2:/disks/nd2 -v /mnt/nd3:/disks/nd3 -v /mnt/merged:/merged:shared --device /dev/fuse --cap-add SYS_ADMIN -d hvalev/mergerfs

docker-compose

yaml
services:
  mergerfs:
    image: hvalev/mergerfs:latest
    container_name: mergerfs
    cap_add:
      - SYS_ADMIN
    devices:
      - /dev/fuse:/dev/fuse
    volumes:
       - /mnt/nd1:/disks/nd1
       - /mnt/nd2:/disks/nd2
       - /mnt/nd3:/disks/nd3
       - /mnt/merged:/merged:shared
    restart: always

自定义配置

自定义参数文件

如需使用额外选项自定义mergerfs命令，可通过卷挂载将自定义的parameters.conf映射到容器内/config目录，可使用仓库中的配置文件作为模板。

环境变量自定义

通过MERGERFS_PARAMS环境变量覆盖默认mergerfs参数，示例：

yaml
services:
  mergerfs:
    image: hvalev/mergerfs:latest
    container_name: mergerfs
    environment:
      MERGERFS_PARAMS: 'moveonenospc=true,dropcacheonclose=true,category.create=mfs,cache.files=partial'
    cap_add:
      - SYS_ADMIN
    devices:
      - /dev/fuse:/dev/fuse
    volumes:
       - /mnt/nd1:/disks/nd1
       - /mnt/nd2:/disks/nd2
       - /mnt/nd3:/disks/nd3
       - /mnt/merged:/merged:shared
    restart: always

与Samba结合实现网络共享

可与Samba容器配合，将合并后的存储通过网络共享，示例配置：

yaml
services:
  mergerfs:
    image: hvalev/mergerfs:latest
    container_name: mergerfs
    environment:
      MERGERFS_PARAMS: 'moveonenospc=true,dropcacheonclose=true,category.create=mfs,cache.files=partial'
    cap_add:
      - SYS_ADMIN
    devices:
      - /dev/fuse:/dev/fuse
    volumes:
      - /mnt/hd1:/disks/hd1
      - /mnt/hd2:/disks/hd2
      - /mnt/hd3:/disks/hd3
      - /mnt/hd:/merged:shared
    restart: always

  samba:
    image: elswork/samba:3.2.8
    container_name: samba
    environment:
      TZ: 'Europe/Amsterdam'
    ports:
      - 139:139
      - 445:445
    volumes:
      - /mnt/hd:/mnt/hd
    command: '-u "1000:1000:user:user:user_password" 
              -u "1000:1000:guest:guest:guest_password"
              -s "hd:/mnt/hd:rw:user"
              -s "media:/mnt/hd:ro:guest"'
    restart: unless-stopped
    depends_on:
      - mergerfs

致谢

以下资源提供了极大帮助：

• https://hub.docker.com/r/ojford/mergerfs
• [***]
• https://github.com/homespirit/mergerfs-docker

许可证

mergerfs本身使用以下许可证：

/*
  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