walkerk1980/rancher-nfs-client

Rancher NFS客户端镜像概述

这是一个轻量级（约10MB）的Docker NFS客户端镜像，基于Alpine构建，默认使用NFS3（可通过环境变量切换至NFS4），兼容数据库（如MariaDB、MySQL）场景，支持在Rancher OS环境下灵活挂载NFS共享路径。

核心功能

1. 支持手动在主机上挂载NFS共享路径
2. 可将NFS共享直接挂载到容器内部
3. 允许Rancher OS启动时自动运行该客户端
4. 支持与其他容器共享NFS卷资源
5. 可通过环境变量自定义NFS版本、挂载选项等参数

使用场景

• Rancher OS环境下快速挂载NFS存储
• 数据库服务的NFS存储共享需求
• 多容器间共享NFS资源的场景
• 需要在主机网络中提供NFS客户端能力的轻量操作系统

配置说明

环境变量

• SERVER：NFS服务器的主机名或IP地址
• SHARE：需要挂载的NFS共享路径
• MOUNT_OPTIONS：挂载NFS共享时的选项
• FSTYPE：文件系统类型，可选nfs4（默认nfs3）
• MOUNTPOINT：容器内NFS共享的挂载点（默认/mnt/nfs-1）

部署示例

1. 手动在主机挂载NFS

运行容器：

bash
docker run -itd --privileged=true --net=host docker.xuanyuan.run/walkerk1980/rancher-nfs-client

在主机执行挂载命令：

bash
sudo mount -t nfs SERVER_IP:/shared_path /mount_point

2. 将NFS挂载到容器内部

基础命令：

bash
docker run -itd --privileged=true --net=host -e SERVER=nfs_server_ip -e SHARE=shared_path docker.xuanyuan.run/walkerk1980/rancher-nfs-client

带共享卷的命令（方便与其他容器共享）：

bash
docker run -itd --privileged=true --name nfs --net=host -v /mnt/shared_nfs:/mnt/nfs-1:shared -e SERVER=nfs_server_ip -e SHARE=shared_path docker.xuanyuan.run/walkerk1980/rancher-nfs-client

其他容器可通过--volume-from nfs共享该NFS卷。

3. Rancher OS启动时自动运行

在cloud-config.yml中添加服务配置：

yaml
#cloud-config
mounts:
  - ["SERVER_IP:/shared_path", "/mnt/nfs-1", "nfs", ""]

或参考镜像仓库中的rancheros-cloud-config.yml文件配置启动服务。

许可证

该镜像基于MIT许可证开源，详情见镜像仓库中的LICENSE文件。