apnar/nfs-ganesha

NFS Ganesha Docker镜像

镜像概述

NFS Ganesha是一个运行在容器中的用户模式NFS服务器，基于Ganesha实现。该镜像支持NFSv3、NFSv4.0、NFSv4.1、NFSv4.1 pNFS、NFSv4.2协议以及9P协议，并可配置所有NFS-Ganesha支持的FSAL后端。默认配置支持本地路径的NFS共享，也可通过自定义配置文件实现更高级的FSAL配置。

核心功能与特性

• 多协议支持：兼容NFSv3、NFSv4.0/4.1/4.2及9P协议
• FSAL后端灵活配置：支持NFS-Ganesha所有FSAL后端，可通过自定义配置文件扩展
• 环境变量配置：通过环境变量快速配置核心参数，无需手动编写配置文件
• 轻量级部署：容器化部署，简化NFS服务搭建流程

版本信息

• ganesha: 2.4
• glusterfs-common: 3.11

环境变量说明

配置文件中的环境变量替换

环境变量会自动替换到生成的配置文件中，默认配置模板如下：

EXPORT
{
		# 导出ID（必填，每个EXPORT需唯一）
		Export_Id = ${GANESHA_EXPORT_ID};

		# 导出路径（必填）
		Path = ${GANESHA_EXPORT};

		# NFSv4伪路径
		Pseudo = /;

		# 访问控制选项
		Access_Type = RW;
		Squash = No_Root_Squash;
		Root_Access = "${GANESHA_ROOT_ACCESS}";
		Access = "${GANESHA_ACCESS}";

		# NFS协议选项
		Transports = "${GANESHA_TRANSPORTS}";
		Protocols = "${GANESHA_NFS_PROTOCOLS}";

		SecType = "sys";

		# FSAL配置
		FSAL {
			Name = VFS;
		}
}

使用方法

基本部署

通过Docker运行NFS服务，挂载本地路径作为NFS共享目录：

bash
docker run -d \
--name nfs \
-v /local/export/path:/export \
mitcdh/nfs-ganesha

自定义配置

通过GANESHA_CONFIGFILE指定自定义配置文件（需先将配置文件挂载到容器内）：

bash
docker run -d \
--name nfs \
-v /local/export/path:/export \
-v /path/to/custom/ganesha.conf:/etc/ganesha/ganesha.conf \
-e GANESHA_CONFIGFILE=/etc/ganesha/ganesha.conf \
mitcdh/nfs-ganesha

指定访问控制列表

通过环境变量配置访问控制：

bash
docker run -d \
--name nfs \
-v /local/export/path:/export \
-e GANESHA_ACCESS="192.168.1.0/24" \
-e GANESHA_ROOT_ACCESS="192.168.1.100" \
-e GANESHA_NFS_PROTOCOLS="4" \
mitcdh/nfs-ganesha

适用场景

• 开发/测试环境中的临时NFS服务
• 轻量级文件共享服务
• 需要快速部署NFS服务的边缘计算场景
• 容器化环境中的跨容器文件共享

参考来源

• https://github.com/janeczku/docker-nfs-ganesha