wendaoji/nfs-server-alpine

nfs-server-alpine

镜像概述

nfs-server-alpine是一个轻量级NFS服务器镜像，基于Alpine Linux构建，仅支持NFS v4协议，通过TCP端口2049提供服务。该镜像移除了Confd依赖，进一步减小体积并提升设备兼容性，适用于需要简单高效文件共享的场景。

核心组件

• Alpine Linux v3.8.1：基于musl libc (v1.1.19)和BusyBox的轻量级安全Linux发行版
• NFS v4：仅支持NFS v4协议，通过TCP 2049端口通信
• rpcbind：临时启用以解决启动缓慢问题（理论上非必需）

历史版本说明

• 标签6-arm：基于hypriot/rpi-alpine（ARM架构）
• 标签7及以上：基于官方Alpine镜像（ARM架构）
• 标签7/8/9：Alpine Linux v3.7.0、musl v1.1.18、Confd v0.14.0
• 标签6：Alpine Linux v3.6.0、musl v1.1.15
• 标签5：Confd v0.13.0
• 标签4：Alpine Linux v3.5、Confd v0.12.0-dev

注意：版本3及更早存在严重缺陷，建议使用版本4及以上。

核心功能与特性

• 轻量级：基于Alpine Linux，镜像体积小，资源占用低
• NFS v4支持：仅提供NFS v4协议，简化配置并提高安全性
• 灵活配置：通过环境变量自定义共享目录、访问权限、客户端限制等
• 跨平台：支持x86和ARM架构（特定标签）
• 易于集成：可与Docker Compose、Kubernetes等容器编排工具集成

使用场景

• 本地开发环境中的文件共享
• 容器集群内的跨容器数据共享
• 轻量级服务器环境的简单文件服务
• Kubernetes集群中的静态数据共享

使用方法

基本运行命令

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

网络配置

如需外部访问，添加端口映射或使用主机网络：

bash
# 端口映射
docker run -d --name nfs --privileged -p 2049:2049 \
  -v /本地目录:/nfsshare \
  -e SHARED_DIRECTORY=/nfsshare \
  docker.xuanyuan.run/itsthenetwork/nfs-server-alpine:latest

# 主机网络
docker run -d --name nfs --privileged --net=host \
  -v /本地目录:/nfsshare \
  -e SHARED_DIRECTORY=/nfsshare \
  docker.xuanyuan.run/itsthenetwork/nfs-server-alpine:latest

环境变量配置

示例：只读共享

bash
docker run -d --name nfs --privileged -p 2049:2049 \
  -v /本地目录:/nfsshare \
  -e SHARED_DIRECTORY=/nfsshare \
  -e READ_ONLY=true \
  docker.xuanyuan.run/itsthenetwork/nfs-server-alpine:latest

示例：限制客户端IP

bash
docker run -d --name nfs --privileged -p 2049:2049 \
  -v /本地目录:/nfsshare \
  -e SHARED_DIRECTORY=/nfsshare \
  -e PERMITTED="192.168.1.*" \
  docker.xuanyuan.run/itsthenetwork/nfs-server-alpine:latest

客户端挂载方法

基本挂载

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

显式指定NFS版本

bash
sudo mount -v -o vers=4,loud 服务器IP:/ /本地挂载点

卸载共享

bash
sudo umount /本地挂载点

高级配置

特权模式说明

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

bash
docker run -d --name nfs \
  --cap-add SYS_ADMIN --cap-add SETPCAP --security-opt=no-new-privileges \
  -v /本地目录:/nfsshare \
  -e SHARED_DIRECTORY=/nfsshare \
  docker.xuanyuan.run/itsthenetwork/nfs-server-alpine:latest

Kubernetes配置

使用特权模式

yaml
spec:
  containers:
  - name: nfs-server
    image: docker.xuanyuan.run/itsthenetwork/nfs-server-alpine:latest
    securityContext:
      privileged: true
    volumeMounts:
    - name: nfs-data
      mountPath: /nfsshare
    env:
    - name: SHARED_DIRECTORY
      value: /nfsshare
  volumes:
  - name: nfs-data
    hostPath:
      path: /本地目录

使用能力集

yaml
spec:
  containers:
  - name: nfs-server
    image: docker.xuanyuan.run/itsthenetwork/nfs-server-alpine:latest
    securityContext:
      capabilities:
        add: ["SYS_ADMIN", "SETPCAP"]
    volumeMounts:
    - name: nfs-data
      mountPath: /nfsshare
    env:
    - name: SHARED_DIRECTORY
      value: /nfsshare
  volumes:
  - name: nfs-data
    hostPath:
      path: /本地目录

Docker Compose配置

yaml
version: '3'
services:
  nfs-server:
    image: docker.xuanyuan.run/itsthenetwork/nfs-server-alpine:latest
    privileged: true  # 或使用cap_add
    # cap_add:
    #   - SYS_ADMIN
    #   - SETPCAP
    ports:
      - "2049:2049"
    volumes:
      - /本地目录:/nfsshare
    environment:
      - SHARED_DIRECTORY=/nfsshare
      # - READ_ONLY=true
      # - PERMITTED=192.168.1.*

多共享目录配置

NFSv4要求额外共享目录必须是根共享目录的子目录。配置方法：

1. 挂载多个子目录到容器的根共享目录下
2. 通过环境变量SHARED_DIRECTORY_2、SHARED_DIRECTORY_3等指定额外共享目录

示例

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

客户端挂载多共享

bash
# 挂载根共享
sudo mount -v 服务器IP:/ /挂载点1

# 挂载子共享
sudo mount -v 服务器IP:/another /挂载点2

操作系统注意事项

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导出，建议将卷挂载到以下支持的文件系统目录：

• RancherOS: /home、/media、/mnt（ext4文件系统）

其他操作系统

确保加载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
    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.

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"]