itsthenetwork/nfs-server-alpine

镜像概述和主要用途

该镜像由Steven Iveson开发，是一个便捷的NFS服务器镜像，基于Alpine Linux，仅支持NFS v4协议，通过TCP 2049端口提供服务。它旨在提供轻量级、安全的文件共享解决方案，适用于开发、测试及小型部署环境。

核心组成

• Alpine Linux v3.9.3：轻量级Linux发行版，基于musl libc (v1.1.20)和BusyBox，注重安全性和小巧体积
• NFS v4：仅支持NFS v4协议，通过TCP 2049端口通信
• 无Confd依赖：不再使用Confd，使镜像更简单、体积更小，设备兼容性更广

历史版本说明

• 标签6-arm：基于hypriot/rpi-alpine
• 标签7及以上：基于官方Alpine镜像（标签7使用confd v0.16.0）
• 标签11：Alpine Linux v3.8.1，musl v1.1.19，支持更干净的关闭；ARM版本使用Alpine v3.9.2和musl v1.1.20
• 标签10：Alpine Linux v3.8.1，musl v1.1.19
• 标签7-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，镜像体积仅7Mb
• 安全导向：Alpine Linux的musl libc提供增强的安全性
• NFS v4专一支持：仅支持NFS v4协议，简化配置并提高安全性
• 灵活配置：通过环境变量自定义共享权限、同步模式和客户端访问控制
• 跨架构支持：提供ARM架构版本，适用于树莓派等设备
• 简化部署：无需复杂配置，通过环境变量即可快速设置共享目录

使用场景和适用范围

• 开发环境中的文件共享需求
• 测试环境的NFS服务快速部署
• Kubernetes、Rancher等容器编排平台中的文件共享
• 资源受限环境下的轻量级文件服务
• 需要跨设备、跨系统共享文件的场景

使用方法和配置说明

基本运行命令

bash
docker run -d --name nfs --privileged -v /some/where/fileshare:/nfsshare -e SHARED_DIRECTORY=/nfsshare itsthenetwork/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服务需要特权模式运行，可通过以下方式之一实现：

1. 特权模式（推荐）：

bash
--privileged

2. 能力集替代方案（可能不适用所有环境）：

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

注意：SYS_ADMIN能力与特权模式安全性风险相近

Kubernetes配置

使用特权模式

yaml
spec:
  containers:
  - name: nfs-server
    image: itsthenetwork/nfs-server-alpine:latest
    securityContext:
      privileged: true
    env:
    - name: SHARED_DIRECTORY
      value: /nfsshare
    volumeMounts:
    - name: nfs-data
      mountPath: /nfsshare
  volumes:
  - name: nfs-data
    hostPath:
      path: /some/where/fileshare

使用能力集

yaml
spec:
  containers:
  - name: nfs-server
    image: itsthenetwork/nfs-server-alpine:latest
    securityContext:
      capabilities:
        add: ["SYS_ADMIN", "SETPCAP"]

Docker Compose配置

使用特权模式

yaml
version: '3'
services:
  nfs:
    image: itsthenetwork/nfs-server-alpine:latest
    privileged: true
    environment:
      - SHARED_DIRECTORY=/nfsshare
    volumes:
      - /some/where/fileshare:/nfsshare
    ports:
      - "2049:2049"

使用能力集

yaml
version: '3'
services:
  nfs:
    image: itsthenetwork/nfs-server-alpine:latest
    cap_add:
      - SYS_ADMIN
      - SETPCAP
    environment:
      - SHARED_DIRECTORY=/nfsshare
    volumes:
      - /some/where/fileshare:/nfsshare
    ports:
      - "2049:2049"

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

注意：RancherOS使用overlayfs作为Docker存储，需挂载ext4文件系统（如/home、/media、/mnt）作为共享目录

OverlayFS注意事项

OverlayFS不支持NFS导出，需将共享目录挂载到以下支持的文件系统：

• RancherOS：/home、/media、/mnt（ext4）
• 其他系统：选择非overlayfs的文件系统

其他操作系统

确保加载NFS内核模块：

bash
modprobe nfs nfsd

多共享目录配置

NFSv4要求额外共享目录必须是SHARED_DIRECTORY的子目录。

运行命令示例

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 \
  itsthenetwork/nfs-server-alpine:latest

修改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

挂载多共享目录

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.

Dockerfile

dockerfile
FROM alpine:latest
LABEL maintainer "Steven Iveson <steve@iveson.eu>"
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"]

源代码

该镜像的源代码可在GitHub获取：https://github.com/sjiveson/nfs-server-alpine

致谢

感谢Torsten Bronger (@bronger) 对实现多阶段Docker构建以更好地处理Confd（现已移除）的建议和帮助。