d0whc3r/nfs-server-alpine

nfs-server-alpine

镜像概述

nfs-server-alpine是一个轻量级NFS服务器镜像，基于Alpine Linux构建，仅支持NFS v4协议，通过TCP 2049端口提供服务。Alpine Linux是一个面向安全、轻量级的Linux发行版，确保镜像体积小且资源占用低。当前版本包含rpcbind以解决启动缓慢问题（理论上NFS v4无需rpcbind）。

运行容器时，通过环境变量SHARED_DIRECTORY指定的目录将作为NFS v4共享目录对外提供服务。

核心功能与特性

• 轻量级基础：基于Alpine Linux v3.11，镜像体积小，资源占用低
• NFS v4支持：仅支持NFS v4协议，通过TCP 2049端口通信
• 灵活配置：通过环境变量控制共享权限（读写/只读）、同步模式、客户端访问限制
• 简化挂载：无需指定共享目录名即可挂载（因fsid=0参数）
• 多共享支持：可通过配置实现多个子目录共享

使用场景

• 容器化环境中的文件共享服务
• 开发/测试环境的快速NFS服务部署
• Kubernetes、Rancher等容器编排平台中的存储共享
• 需要轻量级NFS服务的边缘计算场景

使用方法与配置说明

基本运行命令

bash
docker run -d --name nfs --privileged -v /some/where/fileshare:/nfsshare -e SHARED_DIRECTORY=/nfsshare docker.xuanyuan.run/d0whc3r/nfs-server-alpine:latest

网络配置

• 若需外部访问，添加--net=host或-p 2049:2049映射端口
• Rancher或容器链接环境中无需额外网络配置

环境变量配置

客户端挂载命令

基本挂载

bash
sudo mount -v 10.11.12.101:/ /some/where/here

显式指定NFS版本

bash
sudo mount -v -o vers=4,loud 10.11.12.101:/ /some/where/here

卸载

bash
sudo umount /some/where/here

特权模式说明

NFS服务需要特定权限，推荐使用--privileged模式运行。若需更精细的权限控制，可尝试：

bash
--cap-add SYS_ADMIN --cap-add SETPCAP --security-opt=no-new-privileges

Kubernetes配置

yaml
spec:
  containers:
  - name: nfs-server
    image: docker.xuanyuan.run/d0whc3r/nfs-server-alpine:latest
    securityContext:
      privileged: true  # 或使用capabilities配置
      # capabilities:
      #   add: ["SYS_ADMIN", "SETPCAP"]

Docker Compose配置

yaml
version: '3'
services:
  nfs:
    image: docker.xuanyuan.run/d0whc3r/nfs-server-alpine:latest
    privileged: true  # 或使用cap_add
    # cap_add:
    #   - SYS_ADMIN
    #   - SETPCAP
    volumes:
      - /some/where/fileshare:/nfsshare
    environment:
      - SHARED_DIRECTORY=/nfsshare

特殊环境配置

RancherOS

需启用内核头文件服务：

bash
sudo ros service enable kernel-headers
sudo ros service up kernel-headers

或在cloud-config.yml中添加：

yaml
#cloud-config
rancher:
  services_include:
    kernel-headers: true

OverlayFS注意事项

OverlayFS不支持NFS导出，需挂载ext4文件系统目录（如RancherOS的/home、/media或/mnt）。

其他操作系统

确保加载NFS内核模块：

bash
modprobe nfs nfsd

多共享目录配置

1. 挂载额外子目录作为共享目录：

bash
docker run -d --name nfs --privileged \
  -v /some/where/fileshare:/nfsshare \
  -v /some/where/else:/nfsshare/another \
  -e SHARED_DIRECTORY=/nfsshare \
  -e SHARED_DIRECTORY_2=/nfsshare/another \
  docker.xuanyuan.run/d0whc3r/nfs-server-alpine:latest

2. 修改nfsd.sh添加额外共享配置（容器内）：

bash
if [ ! -z "${SHARED_DIRECTORY_2}" ]; then
  echo "Writing SHARED_DIRECTORY_2 to /etc/exports file"
  echo "{{SHARED_DIRECTORY_2}} {{PERMITTED}}({{READ_ONLY}},{{SYNC}},no_subtree_check,no_auth_nlm,insecure,no_root_squash)" >> /etc/exports
  /bin/sed -i "s@{{SHARED_DIRECTORY_2}}@${SHARED_DIRECTORY_2}@g" /etc/exports
fi

3. 客户端挂载示例：

bash
sudo mount -v 10.11.12.101:/ /mnt/one        # 根共享
sudo mount -v 10.11.12.101:/another /mnt/two  # 子目录共享

成功启动日志示例

Writing SHARED_DIRECTORY to /etc/exports file
The PERMITTED environment variable is unset or null, defaulting to '*'.
This means any client can mount.
The READ_ONLY environment variable is unset or null, defaulting to 'rw'.
Clients have read/write access.
The SYNC environment variable is unset or null, defaulting to 'async' mode.
Writes will not be immediately written to disk.
Displaying /etc/exports contents:
/nfsshare *(rw,fsid=0,async,no_subtree_check,no_auth_nlm,insecure,no_root_squash)

Starting rpcbind...
Displaying rpcbind status...
   program version netid     address                service    owner
    100000    4    tcp6      ::.0.111               -          superuser
    100000    3    tcp6      ::.0.111               -          superuser
    100000    4    udp6      ::.0.111               -          superuser
    100000    3    udp6      ::.0.111               -          superuser
    100000    4    tcp       0.0.0.0.0.111          -          superuser
    100000    3    tcp       0.0.0.0.0.111          -          superuser
    100000    2    tcp       0.0.0.0.0.111          -          superuser
    100000    4    udp       0.0.0.0.0.111          -          superuser
    100000    3    udp       0.0.0.0.0.111          -          superuser
    100000    2    udp       0.0.0.0.0.111          -          superuser
    100000    4    local     /var/run/rpcbind.sock  -          superuser
    100000    3    local     /var/run/rpcbind.sock  -          superuser
Starting NFS in the background...
rpc.nfsd: knfsd is currently down
rpc.nfsd: Writing version string to kernel: -2 -3 +4
rpc.nfsd: Created AF_INET TCP socket.
rpc.nfsd: Created AF_INET6 TCP socket.
Exporting File System...
exporting *:/nfsshare
/nfsshare     	<world>
Starting Mountd in the background...
Startup successful.

参考链接

• https://github.com/sjiveson/nfs-server-alpine
• https://hub.docker.com/r/itsthenetwork/nfs-server-alpine/