zimme/rar2fs

zimme/rar2fs

镜像概述和主要用途

基于Alpine Linux的rar2fs最小镜像，rar2fs是一款通过FUSE（用户空间文件系统）将RAR归档文件挂载为只读文件系统的工具。该镜像旨在提供轻量级解决方案，使用户能够直接访问RAR文件内容而无需解压，默认运行参数包含-o allow_other -o auto_unmount --seek-length=1。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 默认配置优化：默认启用allow_other（允许其他用户访问）、auto_unmount（自动卸载）和--seek-length=1（设置查找长度）
• FUSE支持：依赖FUSE机制，需容器具备相应权限和设备访问
• 灵活配置：支持自定义rar2fs和FUSE参数，适配不同使用场景
• 安全建议：默认以root用户运行，推荐通过-u和--group-add指定非root用户运行

使用场景和适用范围

• 媒体服务器（如Plex、Emby）访问RAR压缩的媒体文件
• 需直接读取RAR文件内容而避免解压占用磁盘空间的场景
• 轻量级服务器环境中挂载RAR归档，简化文件访问流程

使用方法和配置说明

基本运行命令

sh
docker run \
  -d \
  --init \  # 推荐使用，确保进程信号正确处理
  --name rar2fs \
  --cap-add MKNOD \  # 必需，提供创建特殊文件权限
  --cap-add SYS_ADMIN \  # 必需，提供挂载文件系统权限
  --device /dev/fuse \  # 必需，提供FUSE设备访问
  --network none \  # 无需网络，可禁用以增强安全性
  -v <本地RAR文件路径>:/source \  # 绑定RAR文件所在目录到容器内/source
  -v <本地空文件夹路径>:/destination:rshared \  # 绑定挂载目标目录，需设置rshared传播模式
  zimme/rar2fs

参数说明

• --init：推荐添加，确保容器内进程正确处理信号
• --cap-add MKNOD 和 --cap-add SYS_ADMIN：必需权限，用于FUSE文件系统挂载
• --device /dev/fuse：容器需访问宿主机的FUSE设备
• -v <path>:/source：本地RAR文件所在目录的绑定挂载点
• -v <path>:/destination:rshared：挂载目标目录，rshared传播模式确保挂载在宿主机可见
• 若Docker主机使用apparmor，可能需添加--security-opt apparmor:unconfined以获取FUSE使用权限

自定义配置

查看所有配置选项

运行以下命令获取rar2fs完整参数列表：

sh
docker run --rm zimme/rar2fs --help

使用自定义参数运行

如需覆盖默认配置，可在镜像名称后追加自定义参数：

sh
docker run \
  -d \
  --init \
  --name rar2fs \
  --cap-add MKNOD \
  --cap-add SYS_ADMIN \
  --device /dev/fuse \
  --network none \
  -v <本地RAR文件路径>:/source \
  -v <本地空文件夹路径>:/destination:rshared \
  zimme/rar2fs \
  <自定义rar2fs选项> \  # 例如：--seek-length=2
  -o <自定义FUSE选项> \  # 例如：-o ro（只读）
  /source \  # 源RAR文件目录（固定为/source）
  /destination  # 挂载目标目录（固定为/destination）

Docker Compose 配置

可参考https://github.com/zimme/docker-rar2fs/blob/master/docker-compose.example.yml进行部署，配置包含必要的权限、设备和挂载设置。