tobyfoo/nfs-server-alpine

nfs-server-alpine

镜像概述和主要用途

nfs-server-alpine是一个便捷的NFS服务器镜像，基于Alpine Linux v3.5.0构建，仅支持NFS v4协议，通过TCP 2049端口提供服务。该镜像旨在提供轻量级、易配置的NFS服务，允许将指定目录通过NFS v4协议共享给客户端。

核心组件

• Alpine Linux v3.5.0：轻量级、安全导向的Linux发行版，基于musl libc (v1.1.15) 和BusyBox。
• NFS v4：仅支持NFS v4协议，通过TCP 2049端口通信。

核心功能和特性

• 轻量级：基于Alpine Linux，镜像体积小，资源占用低。
• NFS v4专一支持：仅启用NFS v4协议，简化配置并提高安全性。
• 环境变量配置：通过SHARED_DIRECTORY环境变量指定共享目录，无需手动修改配置文件。
• 权限控制：支持读写（默认）或只读模式，通过READ_ONLY环境变量切换。
• 简化挂载：由于fsid=0参数，客户端挂载时无需指定共享目录名称。

使用场景和适用范围

• 容器间文件共享：在Docker环境中实现多个容器间的文件共享。
• 开发/测试环境：快速搭建NFS服务，用于开发或测试环境的资源共享。
• 轻量级NFS服务部署：需要简单、低资源占用的NFS服务场景。

使用方法和配置说明

基本运行命令

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

网络配置

若需通过主机网络栈对外提供服务，添加--net=host或-p 2049:2049参数：

bash
# 使用host网络
docker run -d --name nfs --privileged --net=host -v /some/where/fileshare:/nfsshare -e SHARED_DIRECTORY=/nfsshare docker.xuanyuan.run/itsthenetwork/nfs-server-alpine:latest

# 端口映射
docker run -d --name nfs --privileged -p 2049:2049 -v /some/where/fileshare:/nfsshare -e SHARED_DIRECTORY=/nfsshare docker.xuanyuan.run/itsthenetwork/nfs-server-alpine:latest

注意：使用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

配置参数

环境变量

• SHARED_DIRECTORY：必填，指定要共享的目录路径（需与容器内挂载路径一致）。
• READ_ONLY：可选，设置为true时共享目录仅允许读访问（默认rw）。

exports文件参数

默认exports配置：

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

启用READ_ONLY=true后，配置变为：

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

特殊环境注意事项

RancherOS

需启用并启动kernel-headers服务：

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

RancherOS使用overlayfs作为Docker存储驱动，需将共享目录挂载到ext4文件系统（如/home、/media、/mnt）。

OverlayFS

OverlayFS不支持NFS导出，需将共享目录挂载到其他文件系统（如ext4）。

其他操作系统

需确保加载nfs和nfsd内核模块：

bash
modprobe nfs nfsd

容器内挂载权限

容器需要SYS_ADMIN权限或运行在特权模式（--privileged）。

成功启动日志示例

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 92cc8fa446eef0e167648be03aba09e5
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...

Dockerfile位置

构建镜像的Dockerfile位于容器文件系统的根目录。

注意事项

• showmount命令不可用，因为未运行rpcbind服务。
• 共享目录需确保容器内路径与SHARED_DIRECTORY一致。