klud/nfs-server-alpine

klud/nfs-server-alpine

重要提示

该镜像已被弃用，推荐使用替代镜像：https://hub.docker.com/r/itsthenetwork/nfs-server-alpine/

标签

• latest, amd64 (Dockerfile)
• armhf (Dockerfile)
• aarch64 (Dockerfile)

基于镜像

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

概述

本镜像提供一个便捷的NFS服务器，主要包含：

• Alpine Linux Edge：一个注重安全性的轻量级Linux发行版，基于musl libc (v1.1.15)和BusyBox
• 仅支持NFS v4协议，通过TCP端口2049提供服务

运行容器时，通过环境变量SHARED_DIRECTORY指定的目录将对NFS v4客户端开放共享。

核心功能与特性

• 轻量级：基于Alpine Linux，镜像体积小，资源占用低
• 安全性：Alpine Linux的安全导向设计
• 协议支持：仅NFS v4，通过TCP端口2049通信
• 灵活配置：通过环境变量指定共享目录
• 简化挂载：无需指定共享文件夹名称即可挂载（因fsid=0配置）

使用场景

• 容器间文件共享
• 轻量级NFS服务需求场景
• 开发测试环境中的文件共享
• Rancher或容器链接环境中的存储共享

使用方法与配置

基本运行命令

sh
docker run -d \
--name nfs \
--privileged \
-v /some/where/fileshare:/nfsshare \
-e SHARED_DIRECTORY=/nfsshare \
klud/nfs-server-alpine:latest

网络配置

如需通过主机网络栈对外提供服务，添加--net=host或-p 2049:2049参数。在Rancher环境或通过其他方式链接容器时无需此配置。

客户端挂载

由于/etc/exports中设置了fsid=0参数，客户端挂载时无需指定文件夹名称：

sh
sudo mount -v <NFS服务器IP>:/ /some/where/here

显式指定NFS版本：

sh
sudo mount -v -o vers=4,loud <NFS服务器IP>:/ /some/where/here

卸载挂载点：

sh
sudo umount /some/where/here

导出配置参数

/etc/exports文件包含以下参数：

sh
*(rw,fsid=0,async,no_subtree_check,no_auth_nlm,insecure,no_root_squash)

注意：由于未运行rpcbind，showmount命令无法用于此服务器。

特殊环境配置

RancherOS

需执行以下命令确保功能正常：

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

RancherOS使用overlayfs作为Docker存储驱动，需参考下一节内容。

OverlayFS

OverlayFS不支持NFS导出，需将卷挂载到NFS容器的其他文件系统（如ext4）。在RancherOS上，/home、/media和/mnt是推荐的挂载点。

其他操作系统

可能需要加载nfs和nfsd内核模块：

sh
modprobe nfs nfsd

容器内挂载

容器需要SYS_ADMIN权限，或使用特权模式运行（安全性较低）。

成功启动日志示例

成功启动服务器时，日志输出应类似以下内容：

sh
Starting Confd population of files...
confd 0.12.0-dev
2017-05-17T09:24:57Z ffcbba1623e6 /usr/bin/confd[13]: INFO Backend set to env
2017-05-17T09:24:57Z ffcbba1623e6 /usr/bin/confd[13]: INFO Starting confd
2017-05-17T09:24:57Z ffcbba1623e6 /usr/bin/confd[13]: INFO Backend nodes set to 
2017-05-17T09:24:57Z ffcbba1623e6 /usr/bin/confd[13]: INFO /etc/exports has md5sum 4f1bb7b2412ce5952ecb5ec22d8ed99d should be 92cc8fa446eef0e***be03aba09e5
2017-05-17T09:24:57Z ffcbba1623e6 /usr/bin/confd[13]: INFO Target config /etc/exports out of sync
2017-05-17T09:24:57Z ffcbba1623e6 /usr/bin/confd[13]: INFO Target config /etc/exports has been updated

Displaying /etc/exports contents...
/nfsshare *(rw,fsid=0,async,no_subtree_check,no_auth_nlm,insecure,no_root_squash)

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
Starting Mountd in the background...