vipconsult/moby-nfs-mount

vipconsult/moby-nfs-mount 镜像说明

镜像概述

该镜像旨在自动将远程NFS共享挂载到Docker主机，适用于所有基于Moby Linux的Docker平台，帮助用户快速实现持久化NFS存储的挂载与管理。

核心功能

• 自动进入主机命名空间访问主机环境
• 在主机上安装NFS客户端（默认支持NFS4协议）
• 按配置将远程NFS共享挂载到指定主机目录
• 支持Docker Swarm集群，可在所有节点执行挂载操作
• 监控目录变化并输出日志

使用场景

• Docker主机需要持久化NFS存储的场景
• Swarm集群中所有节点需统一挂载NFS共享的场景
• 跨平台（如Docker for Mac、Docker for AWS）的NFS挂载需求

配置说明

环境变量

• SERVER: 远程NFS服务器地址，格式为NFS_SERVER:/共享路径（默认使用NFS4）
• MOUNT: 主机上用于挂载NFS的本地目录路径

部署示例

单主机部署

bash
docker run -d \
    --privileged --pid=host \
    --restart=unless-stopped \
    -e SERVER=$NFS_SERVER:/ \
    -e MOUNT=/host/mount/folder \
    vipconsult/moby-nfs-mount

容器内使用挂载的NFS

bash
docker run -v /host/mount/folder:/container/folder <目标镜像>

Swarm集群全节点部署

使用swarm-exec工具在所有节点执行（解决docker service create不支持--privileged的问题）：

bash
swarm-exec \
    docker run -d \
    --privileged --pid=host \
    --restart=unless-stopped \
    -e SERVER=$NFS_SERVER:/ \
    -e MOUNT=/host/mount/folder \
    vipconsult/moby-nfs-mount

（swarm-exec工具地址：https://github.com/mavenugo/swarm-exec%EF%BC%89

Swarm服务中使用挂载的NFS

bash
docker service create \
    --mount type=bind,src=/host/mount/folder,dst=/container/folder \
    <服务名称>

工作原理

1. 通过nsenter进入主机命名空间
2. 在主机上安装NFS客户端
3. 根据MOUNT变量挂载远程NFS共享
4. 使用inotifywait监控目录变化并输出日志

注意事项

• 远程NFS服务器需支持NFS4协议
• 该方法未来可能被分布式Docker卷插件替代