ananace/nfs-ganesha-ceph

NFS Ganesha

镜像概述和主要用途

NFS Ganesha是一个用户模式的NFS服务器容器实现，支持多种NFS协议版本（v3、4.0、4.1、4.1 pNFS、4.2）及9P协议。该容器已配置nfs-ganesha Ceph FSAL后端，默认可通过环境变量生成配置以共享本地路径，也支持通过绑定挂载自定义配置文件实现更高级的功能。

核心功能和特性

• 支持多种NFS协议版本：v3、4.0、4.1、4.1 pNFS、4.2
• 支持9P协议
• 集成Ceph FSAL后端
• 通过环境变量灵活配置NFS服务参数
• 支持启动时执行自定义shell脚本
• 可使用默认自动生成的配置或绑定挂载自定义配置文件

版本信息

• ganesha: 2.8

环境变量

配置文件中的环境变量占位

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

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

  # NFS v4伪路径
  Pseudo = ${GANESHA_PSEUDO_PATH};

  # 访问控制选项
  Access_Type = RW;
  Squash = No_Root_Squash;

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

  # 导出FSAL
  FSAL {
    Name = VFS;
  }
}

使用场景和适用范围

• 快速搭建NFS服务共享本地存储
• 与Ceph集群集成提供NFS访问
• 开发测试环境中的NFS服务部署
• 需要灵活配置NFS协议和传输方式的场景

使用方法和配置说明

基本使用（共享本地路径）

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

自定义配置文件

如需使用自定义配置文件，可通过GANESHA_CONFIGFILE环境变量指定配置文件路径，并绑定挂载配置文件：

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

指定NFS协议和传输方式

例如仅启用NFSv4和TCP传输：

bash
docker run -d \
--name nfs \
-v /local/export/path:/export \
-e GANESHA_NFS_PROTOCOLS=4 \
-e GANESHA_TRANSPORTS=TCP \
ananace/nfs-ganesha-ceph

credits

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