forumi0721/alpine-unfs3

alpine-unfs3 Docker镜像文档

镜像概述

alpine-unfs3 是一个基于 Alpine Linux 的轻量级 Docker 镜像，集成了 UNFS3 服务。UNFS3 是 NFSv3 服务器规范的用户空间实现，支持在容器环境中快速部署 NFSv3 共享服务。该镜像提供 x64 和 aarch64 两种架构支持，适用于需要轻量级 NFS 服务的场景。

核心功能与特性

• 轻量级基础：基于 Alpine Linux，镜像体积小，资源占用低
• 多架构支持：提供 x64 和 aarch64 架构镜像，适配不同硬件平台
• NFSv3 兼容：集成 UNFS3，完整支持 NFSv3 协议规范
• 配置灵活：通过环境变量自定义共享目录和挂载选项
• 快速部署：简化部署流程，无需复杂的系统级配置

使用场景

• 开发/测试环境：快速搭建本地 NFS 共享，用于应用数据共享测试
• 小型网络存储：在资源受限环境中提供轻量级文件共享服务
• 容器化存储：与其他容器协同工作，提供跨容器数据共享能力

使用方法

快速启动

通过以下命令快速启动 NFS 服务容器（需替换 [ARCH_TAG] 为 x64 或 aarch64）：

bash
docker run -d \
  -p 111:111/tcp \
  -p 111:111/udp \
  -p 2049:2049/tcp \
  -p 2049:2049/udp \
  -v /本地数据目录:/data \
  -e NFS_SHARE="/data" \
  -e NFS_OPTION="rw,no_root_squash" \
  forumi0721/alpine-unfs3:[ARCH_TAG]

参数说明：

• -p：端口映射，NFS 服务依赖 Portmap（111 端口）和 NFS 核心服务（2049 端口），需同时映射 TCP 和 UDP
• -v：数据卷挂载，将本地目录挂载到容器内 /data（或自定义共享目录）
• -e：环境变量，用于配置共享路径和选项

客户端挂载方法

Linux 系统

bash
# 将 NFS 共享挂载到本地 /mnt/data 目录
mount -t nfs 服务器IP:/共享目录 /mnt/data

macOS 系统

bash
# 将 NFS 共享挂载到本地 /Volumes/data 目录（需添加 resvport 选项）
mount -t nfs -o resvport,rw 服务器IP:/共享目录 /Volumes/data

配置参数详解

端口映射

容器需暴露以下端口以提供 NFS 服务：

数据卷

环境变量

通过环境变量自定义 NFS 服务配置：

示例：配置多个共享目录

bash
-e NFS_SHARE="/data/share1,/data/share2" \
-e NFS_OPTION="rw,sync,no_subtree_check"

部署示例

docker-compose 配置

创建 docker-compose.yml 文件，快速部署 NFS 服务：

yaml
version: '3'
services:
  nfs-server:
    image: forumi0721/alpine-unfs3:x64  # 或 aarch64
    ports:
      - "111:111/tcp"
      - "111:111/udp"
      - "2049:2049/tcp"
      - "2049:2049/udp"
    volumes:
      - /local/nfs/data:/data  # 本地数据目录挂载
    environment:
      - NFS_SHARE="/data"
      - NFS_OPTION="rw,no_root_squash,sync"
    restart: unless-stopped

启动服务：

bash
docker-compose up -d