Linux服务器配置NFS文件共享,客户端挂载前要检查哪些条件?

发布人:A5数据发布时间:2026-10-19 14:56阅读量:147

要让 Linux 客户端顺利挂载 NFS 共享,挂载前不能只确认服务器目录存在。至少要核对客户端到服务器的路由和 TCP 2049 端口、服务器是否实际导出了该目录、客户端地址是否被允许、NFS 客户端工具是否安装,以及挂载后的用户是否具备对应的 UID/GID 权限。

下面以首次部署 NFSv4 为例,服务器地址为 192.168.10.10,客户端地址为 192.168.10.20,共享目录为服务器上的 /srv/nfs/share。示例同时给出 RHEL/Rocky/AlmaLinux 与 Debian/Ubuntu 的差异,命令输出属于预期结果示例,不代表已经在某台主机上执行。

一、先固定部署范围和访问规则

本次示例采用 NFSv4,客户端通过 192.168.10.10:/ 挂载共享。服务器只允许 192.168.10.0/24 网段访问,不向其他网段开放。

检查项目服务器要求客户端要求
操作系统支持 NFS 服务端组件支持 NFS 客户端组件
网络地址固定或可解析的服务器地址能访问服务器地址
NFS 版本采用 NFSv4 或明确指定其他版本挂载参数与服务器一致
防火墙允许客户端访问 TCP 2049出站访问未被策略拦截
共享路径目录存在,磁盘空间足够本地挂载点存在且未被业务占用
用户权限导出规则和目录权限允许访问本地用户 UID/GID 与服务器权限匹配
安全策略SELinux、AppArmor 等策略允许 nfsd 访问本地安全策略允许挂载 NFS

如果环境中存在多个网段、云安全组、交换机 ACL 或主机防火墙,应把“客户端能否访问服务器 TCP 2049”作为独立检查项,不要只根据 ping 结果判断。ICMP 可达并不代表 NFS 端口可用。

一、先固定部署范围和访问规则配图

NFSv4 与 NFSv3 的网络要求也不同。NFSv4 通常以 TCP 2049 为核心端口;NFSv3 还涉及 rpcbind、mountd 等服务以及额外端口。如果没有兼容性要求,首次部署建议先统一使用 NFSv4,不要在遇到超时后直接改成 NFSv3。

二、客户端挂载前必须完成的检查

1. 确认客户端安装了 NFS 工具

在客户端查看系统版本:

cat /etc/os-release

RHEL、Rocky Linux、AlmaLinux 等系统安装客户端工具:

sudo dnf install -y nfs-utils

Debian、Ubuntu 等系统安装客户端工具:

sudo apt update
sudo apt install -y nfs-common

检查挂载帮助程序是否存在:

command -v mount.nfs

预期可以看到类似结果:

/usr/sbin/mount.nfs

如果没有 mount.nfs,即使服务器配置正确,客户端也可能提示 mount.nfs: command not found 或 bad option。此时先补齐客户端软件包,不要继续修改导出权限。

2. 确认客户端到服务器的路由

在客户端执行:

ip route get 192.168.10.10

预期能看到下一跳、出口网卡和源地址,例如:

192.168.10.10 dev ens160 src 192.168.10.20

如果返回 Network is unreachable,说明路由或网卡配置尚未完成。此时应先处理 VLAN、网关、路由表或云网络安全组,NFS 配置本身无法解决网络不可达问题。

如果使用主机名挂载,还要确认名称解析:

getent hosts nfs-server.example.lan

能够返回 192.168.10.10 才能继续使用主机名。首次部署时也可以直接使用 IP 地址,减少 DNS 故障对判断结果的干扰。

3. 确认 TCP 2049 端口可访问

客户端安装了 nc 时执行:

nc -vz -w 3 192.168.10.10 2049

预期结果类似:

Connection to 192.168.10.10 2049 port [tcp/*] succeeded!

如果出现 Connection refused,通常表示服务器 NFS 服务未启动或端口未监听;如果出现 timed out,则更可能是主机防火墙、云安全组、网络 ACL 或路由策略丢弃了流量。

没有 nc 时,可以在服务器检查监听状态:

sudo ss -lntp | grep ':2049'

预期能看到 TCP 2049 监听。仅看到服务器网卡地址并不能证明客户端可以访问,还需要结合客户端端口测试判断。

4. 确认本地挂载点不会覆盖已有数据

客户端创建挂载点前,先检查目录是否已经存在内容:

sudo mkdir -p /mnt/nfs-share
sudo find /mnt/nfs-share -mindepth 1 -maxdepth 1 -print

如果命令返回了文件或子目录,不要直接挂载。挂载后,本地原有内容会被挂载的 NFS 文件系统遮住,卸载后才会重新出现。需要先确认这些内容是否属于其他业务,必要时完成备份或更换空目录。

5. 确认 UID/GID 与目录权限

NFS 使用 sec=sys 时,服务器通常依据客户端传来的数字 UID/GID 进行权限判断。用户名相同但数字 ID 不同,仍然可能出现权限不一致。

二、客户端挂载前必须完成的检查配图

在客户端查看当前用户:

id

在服务器查看共享目录及其数字属主:

ls -ldn /srv/nfs/share

例如服务器目录显示:

drwxrws--- 2 0 2000 4096 ... /srv/nfs/share

这里的 2000 是目录组 GID。客户端上用于访问共享的用户必须属于 GID 为 2000 的组,或者使用集中式身份服务统一 UID/GID。

生产环境不建议为了快速挂载而使用 chmod 777,也不建议未经确认对已有目录执行递归 chown 或 chmod。这些操作可能改变应用文件、日志目录或其他用户的数据访问边界。

三、安装服务端并准备共享目录

1. 安装服务器端组件

在 NFS 服务器执行。

RHEL 系统:

sudo dnf install -y nfs-utils

Debian、Ubuntu 系统:

sudo apt update
sudo apt install -y nfs-kernel-server

确认服务名称:

systemctl list-unit-files | grep -E 'nfs-server|nfs-kernel-server'

RHEL 系统一般使用 nfs-server,Debian/Ubuntu 一般使用 nfs-kernel-server。

2. 创建专用目录和访问组

下面使用 GID 2000 作为示例。执行前先确认该 GID 没有被其他业务占用:

getent group 2000

如果没有返回结果,可以创建示例组:

if ! getent group nfs-share >/dev/null; then
    sudo groupadd --gid 2000 nfs-share
fi

sudo install -d -m 2770 -o root -g nfs-share /srv/nfs/share

检查结果:

ls -ldn /srv/nfs/share

预期类似:

drwxrws--- 2 0 2000 4096 ... /srv/nfs/share

目录的 2770 表示属主和组拥有读、写、进入权限,并通过 SGID 位让新建文件继承目录组。这里的权限只适合明确需要组内读写的示例场景。如果共享目录中已有数据,应先确认属主、ACL 和应用访问要求,再决定是否调整权限。

在客户端,如果本地用户需要直接读写该目录,也要让该用户属于对应 GID 的组。例如客户端已经存在 nfs-share 且 GID 为 2000 时:

id
sudo usermod -aG nfs-share "$USER"

重新登录会话后再检查:

id

如果生产环境使用 LDAP、AD 或其他集中式身份服务,应优先统一身份源,不要在两台机器上随意创建同名但不同数字 ID 的用户。

四、配置 NFS 导出规则

1. 备份并编辑 /etc/exports

服务器上先保存现有配置。若服务器已经为其他业务提供 NFS,不要覆盖原文件:

if [ -e /etc/exports ]; then
    sudo cp -a /etc/exports /etc/exports.before-nfs
else
    sudo touch /etc/exports
fi

编辑配置文件:

sudo vi /etc/exports

加入以下一行:

/srv/nfs/share 192.168.10.0/24(rw,sync,root_squash,no_subtree_check,sec=sys,fsid=0)

参数含义如下:

  • rw:允许读写,若业务只读,应改为 ro。
  • sync:服务器在确认写入请求前同步处理,数据一致性优先于写入延迟。
  • root_squash:把客户端 root 映射为匿名用户,避免客户端 root 直接获得服务器 root 权限。
  • no_subtree_check:避免子目录检查带来的路径变化问题,适合固定导出目录。
  • sec=sys:使用 UID/GID 进行权限判断。
  • fsid=0:把该目录作为本示例 NFSv4 的伪根,因此客户端挂载路径使用 服务器:/。

如果只允许单个客户端访问,可以把网段改成单个 IP:

/srv/nfs/share 192.168.10.20(rw,sync,root_squash,no_subtree_check,sec=sys,fsid=0)

不要在没有访问边界要求时使用 *,否则可能让其他网络中的主机尝试访问共享。

2. 重新加载并检查导出结果

执行:

sudo exportfs -rav

预期输出类似:

exporting 192.168.10.0/24:/srv/nfs/share

继续查看当前导出配置:

sudo exportfs -v

确认输出中包含正确的目录、允许网段和 root_squash。如果配置文件存在语法问题,exportfs 通常会给出错误行号,应先修正后再进行客户端挂载。

showmount -e 192.168.10.10 可以作为辅助检查,但它依赖 mountd,不能作为 NFSv4 是否可挂载的唯一依据。对于本示例,exportfs -v、TCP 2049 监听和实际挂载结果更有参考价值。

五、启动服务并放行必要端口

1. 启动 NFS 服务

RHEL、Rocky Linux、AlmaLinux:

sudo systemctl enable --now nfs-server
sudo systemctl is-active nfs-server

Debian、Ubuntu:

sudo systemctl enable --now nfs-kernel-server
sudo systemctl is-active nfs-kernel-server

预期结果:

active

如果服务启动失败,先查看日志:

sudo journalctl -u nfs-server -b --no-pager

或:

sudo journalctl -u nfs-kernel-server -b --no-pager

2. 配置服务器防火墙

本示例使用 NFSv4,至少要允许客户端网段访问 TCP 2049。防火墙调整会影响服务器网络访问,执行前应确认当前防火墙管理工具和区域配置,并保留撤销命令。

RHEL 系统使用 firewalld 时,可以添加只允许指定网段访问的规则:

sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="192.168.10.0/24" port port="2049" protocol="tcp" accept'
sudo firewall-cmd --reload
sudo firewall-cmd --list-rich-rules

如果环境统一使用 firewalld 的 NFS 服务定义,也可以由网络管理员按现有区域策略放行 nfs 服务,但应避免无条件向所有来源开放。

Ubuntu 使用 UFW 时:

sudo ufw allow from 192.168.10.0/24 to any port 2049 proto tcp
sudo ufw status

云服务器还要同时检查云安全组或网络 ACL。主机防火墙显示允许,不代表云侧一定允许。

3. 检查 SELinux 或其他安全策略

服务器启用了 SELinux 时,先查看状态:

getenforce
ls -Zd /srv/nfs/share

如果是 Enforcing,并且客户端挂载后读写失败,可以查看最近的拒绝记录:

sudo ausearch -m AVC -ts recent

确认确实是共享目录标签导致后,再按发行版策略为目录设置合适标签。例如:

sudo semanage fcontext -a -t public_content_rw_t '/srv/nfs/share(/.*)?'
sudo restorecon -Rv /srv/nfs/share

如果安全策略仍要求启用 NFS 写入布尔值,需经过安全评估后再执行:

sudo setsebool -P nfs_export_all_rw 1

该布尔值可能扩大服务器上多个 NFS 导出的写入权限,不应作为排障时的盲目“放开权限”命令。不要直接关闭 SELinux 来验证 NFS 是否可用。

六、客户端执行首次挂载

1. 创建挂载点并确认目录为空

sudo install -d -m 0755 /mnt/nfs-share
sudo find /mnt/nfs-share -mindepth 1 -maxdepth 1 -print

确认没有需要保留的本地文件后,执行 NFSv4 挂载:

sudo mount -t nfs4 -o vers=4.1,proto=tcp 192.168.10.10:/ /mnt/nfs-share

由于服务端配置了 fsid=0,客户端这里使用 192.168.10.10:/,而不是 /srv/nfs/share。

检查是否成功:

findmnt -T /mnt/nfs-share -o SOURCE,FSTYPE,OPTIONS,TARGET

预期形态:

SOURCE          FSTYPE OPTIONS                    TARGET
192.168.10.10:/ nfs4   rw,vers=4.1,proto=tcp     /mnt/nfs-share

也可以查看文件系统类型和容量:

df -hT /mnt/nfs-share

df 中的容量是服务器导出文件系统的容量,不一定等于客户端本地磁盘容量。

2. 使用实际业务用户验证读写

不要只用 root 验证。由于服务端启用了 root_squash,客户端 root 的权限可能被映射为匿名用户,root 测试结果不能代表普通业务用户。

以已经加入 nfs-share 组的业务用户执行:

test_file="/mnt/nfs-share/.nfs-mount-test-$(hostname -s)"
printf 'nfs-test\n' > "$test_file"
cat "$test_file"
rm -f "$test_file"

预期 cat 输出:

nfs-test

如果创建文件时报 Permission denied,先检查:

id
ls -ldn /mnt/nfs-share

重点确认客户端用户的数字 GID 是否包含服务器目录的组 GID。不要首先通过关闭 root_squash 或设置 777 来规避问题。

七、确认开机自动挂载

首次手动挂载和读写测试通过后,再写入客户端 /etc/fstab。修改前先备份:

sudo cp -a /etc/fstab /etc/fstab.before-nfs

加入:

192.168.10.10:/ /mnt/nfs-share nfs4 _netdev,vers=4.1,proto=tcp,nofail 0 0

参数说明:

  • _netdev:告知系统这是网络文件系统,避免在网络未就绪时按本地磁盘处理。
  • vers=4.1:固定协议版本,便于排查版本差异。
  • proto=tcp:明确使用 TCP。
  • nofail:挂载失败时不阻塞系统启动,但也可能让业务在开机后暂时看不到共享。

如果该共享是应用启动不可缺少的关键目录,不应不加判断地使用 nofail,需要结合 systemd 单元依赖和业务启动顺序设计。

验证 fstab 中的这条记录:

sudo umount /mnt/nfs-share
sudo mount /mnt/nfs-share
findmnt -T /mnt/nfs-share

如果执行 mount /mnt/nfs-share 成功,说明挂载点、源路径和 fstab 格式基本正确。不要在有大量其他挂载项的生产主机上直接使用 mount -a 作为唯一验证方式,因为它可能同时触发其他未验证的挂载配置。

八、常见异常与处理顺序

现象优先检查项目处理方向
No route to host路由、网关、云网络先修复网络,不修改 exports
Connection timed out防火墙、安全组、TCP 2049检查服务器监听和放行范围
Connection refusedNFS 服务状态、端口监听启动正确的 NFS 服务并查看日志
access denied by server/etc/exports 客户端地址修正允许网段并执行 exportfs -rav
挂载成功但无法写入UID/GID、目录权限、root_squash用实际业务用户检查 id 和 ls -ln
mount.nfs 不存在客户端软件包安装 nfs-utils 或 nfs-common
NFSv4 路径错误fsid=0 与客户端源路径本示例使用 服务器:/,不要直接拼服务器本地路径
SELinux AVC 拒绝标签和布尔值查看 AVC,按策略修正,不要关闭 SELinux
showmount 报 RPC 错误但 2049 可达NFSv4 与 mountd 差异以实际 NFSv4 挂载和 findmnt 结果为准

处理异常时建议保持顺序:先查客户端路由,再查 TCP 2049,再查服务端导出,再查目录权限,最后检查 SELinux。这样可以避免在网络尚未打通时反复修改权限。

八、常见异常与处理顺序配图

九、验收与回滚检查项

验收清单

  • 服务器 nfs-server 或 nfs-kernel-server 状态为 active。
  • 服务器 ss -lntp 能看到 TCP 2049 监听。
  • exportfs -v 显示正确的共享目录和客户端网段。
  • 客户端 ip route get 192.168.10.10 返回正确出口。
  • 客户端能够连接服务器 TCP 2049。
  • findmnt -T /mnt/nfs-share 显示 nfs4,源为 192.168.10.10:/。
  • 使用实际业务用户完成一次创建、读取和删除测试文件。
  • 客户端 /etc/fstab 经过卸载后重新挂载验证。
  • 共享目录未因误用 chmod 777 或关闭安全策略而扩大访问范围。

回滚清单

先在客户端卸载共享:

sudo umount /mnt/nfs-share

如果提示目录忙,先查找占用进程:

sudo fuser -vm /mnt/nfs-share

确认业务进程已停止后再卸载,不建议把 umount -l 作为常规回滚手段。

删除或注释客户端 /etc/fstab 中新增的 NFS 行,并按需恢复备份:

sudo cp -a /etc/fstab.before-nfs /etc/fstab

恢复前必须确认备份文件确实是在本次修改前生成的,否则可能覆盖之后由其他任务加入的配置。

服务器端删除本次新增的 /etc/exports 行后重新加载:

sudo exportfs -ra

如果配置文件原本为空且本次部署没有其他 NFS 业务,可以停止服务;如果服务器还承载其他导出,不要直接停用全局 NFS 服务:

sudo systemctl disable --now nfs-server

防火墙回滚应使用与添加时完全对应的规则。例如 firewalld:

sudo firewall-cmd --permanent --remove-rich-rule='rule family="ipv4" source address="192.168.10.0/24" port port="2049" protocol="tcp" accept'
sudo firewall-cmd --reload

如果共享目录是本次新建且确认为空,只删除目录本身,不要使用未经核对路径的递归删除命令:

sudo find /srv/nfs/share -mindepth 1 -maxdepth 1 -print
sudo rmdir /srv/nfs/share

若目录中已有业务数据,应保留目录和数据,只回滚导出规则、服务配置与防火墙策略。这样既能撤销 NFS 访问,也不会把服务器原有文件误删。

NFS 文件共享可用于连接业务主机与集中存储资源。A5数据提供香港、美国、日本等地区的物理服务器,产品覆盖常规计算与存储需求,配有 NVMe、SSD 或大容量 HDD 等不同存储配置,可作为部署 NFS 服务、承载业务文件及归档数据的硬件基础;多地区资源也便于结合业务部署位置规划服务器布局。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4647.html

相关推荐