mergerfs 项目使用教程

mergerfs 项目使用教程

mergerfs a featureful union filesystem 项目地址: https://gitcode.com/gh_mirrors/me/mergerfs

1. 项目目录结构及介绍

mergerfs 项目的目录结构如下：

mergerfs/
├── buildtools/
├── debian/
├── libfuse/
├── man/
├── src/
├── tests/
├── tools/
├── cirrus.yml
├── .gitignore
├── DEPENDENCIES
├── LICENSE
├── Makefile
├── README.md
└── mergerfs.spec

目录介绍：

• buildtools/: 包含构建工具相关的文件。
• debian/: 包含用于 Debian 系统的打包文件。
• libfuse/: 包含 FUSE（用户空间文件系统）库的相关文件。
• man/: 包含项目的 man 手册页。
• src/: 包含 mergerfs 的核心源代码。
• tests/: 包含项目的测试代码。
• tools/: 包含一些辅助工具。
• cirrus.yml: CI/CD 配置文件。
• .gitignore: Git 忽略文件配置。
• DEPENDENCIES: 项目依赖列表。
• LICENSE: 项目许可证文件。
• Makefile: 项目的 Makefile，用于构建项目。
• README.md: 项目的 README 文件，包含项目的基本介绍和使用说明。
• mergerfs.spec: 项目的 RPM 打包规范文件。

2. 项目启动文件介绍

mergerfs 项目的启动文件主要是通过命令行工具 mergerfs 来启动。启动命令的基本格式如下：

mergerfs -o<options> <branches> <mountpoint>

参数说明：

• -o : 指定 mergerfs 的选项，例如文件缓存、创建策略等。
• : 指定要合并的文件系统路径，多个路径用冒号 : 分隔。
• : 指定合并后的文件系统挂载点。

示例：

mergerfs -o cache.files=partial,dropcacheonclose=true,category.create=mfs /mnt/hdd0:/mnt/hdd1 /media

3. 项目配置文件介绍

mergerfs 的配置可以通过命令行选项、/etc/fstab 文件或 systemd 服务文件进行配置。

通过 /etc/fstab 配置：

在 /etc/fstab 文件中添加如下配置：

/mnt/hdd0:/mnt/hdd1 /media mergerfs cache.files=partial,dropcacheonclose=true,category.create=mfs 0 0

通过 systemd 服务配置：

创建一个 systemd 服务文件，例如 /etc/systemd/system/mergerfs.service，内容如下：

[Unit]
Description=mergerfs service

[Service]
Type=simple
KillMode=none
ExecStart=/usr/bin/mergerfs \
  -f \
  -o cache.files=partial \
  -o dropcacheonclose=true \
  -o category.create=mfs \
  /mnt/hdd0:/mnt/hdd1 \
  /media
ExecStop=/bin/fusermount -uz /media
Restart=on-failure

[Install]
WantedBy=default.target

配置选项说明：

• cache.files: 文件缓存策略，例如 partial 表示部分缓存。
• dropcacheonclose: 文件关闭时是否清除缓存。
• category.create: 创建文件时的策略，例如 mfs 表示最小可用空间优先。

通过以上配置，可以灵活地控制 mergerfs 的行为，满足不同的使用需求。

mergerfs a featureful union filesystem 项目地址: https://gitcode.com/gh_mirrors/me/mergerfs