oniram88/nfs-server-alpine

nfs-server-alpine

镜像概述和主要用途

nfs-server-alpine是一个轻量级NFS服务器镜像，基于Alpine Linux构建，仅支持NFS v4协议，通过TCP端口2049提供文件共享服务。该镜像设计简洁、体积小巧，适用于需要快速部署NFS服务的场景，如容器间文件共享、开发环境资源共享等。

核心功能和特性

• 轻量级基础：基于Alpine Linux v3.8.1，采用musl libc (v1.1.19)和BusyBox，镜像体积小，资源占用低
• NFS v4支持：仅提供NFS v4协议支持，通过TCP端口2049通信
• 灵活配置：通过环境变量控制共享目录、读写权限、同步模式和允许访问的客户端IP范围
• 简化架构：移除Confd依赖，提高设备兼容性，减少镜像体积
• 多平台支持：提供ARM架构版本（标签6-arm基于hypriot/rpi-alpine，标签7及以上基于官方Alpine镜像）

使用场景和适用范围

• 容器化环境中的文件共享服务
• 开发/测试环境的临时资源共享
• Kubernetes集群内的简单存储共享
• 需要轻量级NFS服务的边缘计算场景

使用方法和配置说明

基本运行命令

bash
docker run -d --name nfs --privileged -v /本地目录:/nfsshare -e SHARED_DIRECTORY=/nfsshare itsthenetwork/nfs-server-alpine:latest

网络配置

• 如需外部访问，添加--net=host或-p 2049:2049参数
• Rancher环境或容器链接场景无需额外端口映射

环境变量配置

特权模式说明

NFS服务需要特定的系统权限，推荐使用--privileged模式运行。也可尝试使用以下能力集替代：

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

客户端挂载命令

bash
# 基本挂载
sudo mount -v 服务器IP:/ /本地挂载点

# 显式指定NFS v4
sudo mount -v -o vers=4,loud 服务器IP:/ /本地挂载点

# 卸载
sudo umount /本地挂载点

部署示例

Docker Compose配置

yaml
version: '3'
services:
  nfs-server:
    image: itsthenetwork/nfs-server-alpine:latest
    privileged: true
    volumes:
      - /本地目录:/nfsshare
    environment:
      - SHARED_DIRECTORY=/nfsshare
      - PERMITTED=192.168.1.*
      - SYNC=true
    ports:
      - "2049:2049"

Kubernetes配置

yaml
apiVersion: v1
kind: Pod
metadata:
  name: nfs-server
spec:
  containers:
  - name: nfs-server
    image: itsthenetwork/nfs-server-alpine:latest
    securityContext:
      privileged: true
    volumeMounts:
    - name: nfs-data
      mountPath: /nfsshare
    env:
    - name: SHARED_DIRECTORY
      value: /nfsshare
    - name: PERMITTED
      value: "10.244.0.*"
  volumes:
  - name: nfs-data
    hostPath:
      path: /本地目录

多共享目录配置

通过挂载子目录并设置额外环境变量实现多目录共享：

bash
docker run -d --name nfs --privileged \
  -v /本地目录1:/nfsshare \
  -v /本地目录2:/nfsshare/another \
  -e SHARED_DIRECTORY=/nfsshare \
  -e SHARED_DIRECTORY_2=/nfsshare/another \
  itsthenetwork/nfs-server-alpine:latest

客户端挂载：

bash
sudo mount -v 服务器IP:/ /挂载点1
sudo mount -v 服务器IP:/another /挂载点2

注意事项

Overlay文件系统限制

OverlayFS不支持NFS导出，需将共享目录挂载到其他文件系统（如ext4）。在RancherOS上推荐使用/home、/media或/mnt目录。

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

内核模块要求

部分操作系统需手动加载NFS内核模块：

bash
modprobe nfs nfsd

日志验证

成功启动的日志示例：

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
...
Startup successful.

Dockerfile

dockerfile
FROM alpine:latest
LABEL maintainer "Steven Iveson <***>"
LABEL source "https://github.com/sjiveson/nfs-server-alpine"
LABEL branch "master"
COPY Dockerfile README.md /

RUN apk add --no-cache --update --verbose nfs-utils bash iproute2 && \
    rm -rf /var/cache/apk /tmp /sbin/halt /sbin/poweroff /sbin/reboot && \
    mkdir -p /var/lib/nfs/rpc_pipefs /var/lib/nfs/v4recovery && \
    echo "rpc_pipefs    /var/lib/nfs/rpc_pipefs rpc_pipefs      defaults        0       0" >> /etc/fstab && \
    echo "nfsd  /proc/fs/nfsd   nfsd    defaults        0       0" >> /etc/fstab

COPY exports /etc/
COPY nfsd.sh /usr/bin/nfsd.sh
COPY .bashrc /root/.bashrc

RUN chmod +x /usr/bin/nfsd.sh

ENTRYPOINT ["/usr/bin/nfsd.sh"]