erichough/nfs-server

erichough/nfs-server

一个轻量级、稳健、灵活的容器化NFS服务器。

为什么选择它？

这是唯一提供以下所有特性的容器化NFS服务器：

• 小巧（约15MB）的Alpine Linux镜像
• 同时支持NFS版本3、4或两者
• 终止时干净地停止服务（不在Docker主机上留下残留的nfsd进程）
• 灵活构建/etc/exports
• 通过环境变量进行广泛的服务器配置
• 易读的日志（含实用的调试模式）
• 可选附加功能：
  • Kerberos安全
  • 通过idmapd实现的NFSv4用户ID映射
  • AppArmor兼容性

目录

• 要求
• 使用方法
  • 启动服务器
  • 从客户端挂载文件系统
• 可选功能
  • 调试日志
  • Kerberos安全
  • NFSv4用户ID映射
  • AppArmor集成
• 高级配置
  • 自动加载所需内核模块
  • 自定义服务器端口
  • 自定义提供的NFS版本
  • 性能调优
• 帮助！
• 待办任务
• 致谢

要求

1. Docker主机内核需要以下内核模块：
   • nfs
   • nfsd
   • rpcsec_gss_krb5（仅当使用Kerberos时）
   可手动在Docker主机上启用这些模块：

   bash
   modprobe {nfs,nfsd,rpcsec_gss_krb5}
   

   或允许容器自动加载。
2. 容器需要以CAP_SYS_ADMIN（或--privileged）运行，因为服务器需要在容器内挂载多个文件系统以支持操作，无此权限则无法完成挂载。
3. 容器需要本地访问要通过NFS共享的文件，可通过Docker卷、绑定挂载、自定义镜像内置文件等方式提供。

使用方法

启动服务器

启动erichough/nfs-server镜像将启动NFS服务器。容器启动时需提供一些信息，以下是docker run命令示例：

bash
docker run                                            \
  -v /主机路径/共享文件:/容器内路径                  \
  -v /主机路径/exports.txt:/etc/exports:ro        \
  --cap-add SYS_ADMIN                                 \
  -p 2049:2049                                        \
  erichough/nfs-server

分解命令各部分：

1. 提供要共享的文件：通过绑定挂载（-v /主机路径:/容器路径）、卷（-v 卷名:/容器路径）或自定义镜像内置文件等方式。
2. 提供NFS exports配置：有三种方式：
   • 绑定挂载/etc/exports到容器：-v /主机路径/exports.txt:/etc/exports:ro
   • 通过环境变量提供（以NFS_EXPORT_开头加数字后缀）：

     bash
     docker run                                                                       \
       -e NFS_EXPORT_0='/容器路径/foo                  *(ro,no_subtree_check)'  \
       -e NFS_EXPORT_1='/容器路径/bar 123.123.123.123/32(rw,no_subtree_check)'  \
       ...                                                                            \
       erichough/nfs-server
     

   • 内置到自定义镜像：在Dockerfile中添加ADD /主机路径/exports.txt /etc/exports。
3. 添加权限：使用--cap-add SYS_ADMIN或--privileged。
4. 暴露端口：
   • 仅NFSv4：暴露TCP端口2049：-p 2049:2049
   • 支持NFSv3：暴露更多端口：

     bash
     docker run                          \
       -p 2049:2049   -p 2049:2049/udp   \
       -p 111:111     -p 111:111/udp     \
       -p 32765:32765 -p 32765:32765/udp \
       -p 32767:32767 -p 32767:32767/udp \
       ...                               \
       erichough/nfs-server
     

从客户端挂载文件系统

bash
# mount <容器IP>:/导出路径 /本地路径

可选功能

• 调试日志
• Kerberos安全
• NFSv4用户ID映射
• AppArmor集成

高级配置

• 自动加载所需内核模块
• 自定义端口
• 自定义NFS版本
• 性能调优

帮助

如有问题、建议或无法正常使用，请https://github.com/ehough/docker-nfs-server/issues%E3%80%82

待办任务

• 解决rpc.nfsd在rpcbind未运行时启动/超时需5分钟的问题
• 添加更多示例，包括Docker Compose

致谢

本项目基于以下先前项目：

• https://github.com/f-u-z-z-l-e/docker-nfs-server
• https://github.com/sjiveson/nfs-server-alpine