脚本如何检测NFS共享是否正常

wen 实用脚本 2026-07-06 6

脚本如何检测NFS共享是否正常：实现高可用存储监控的完整指南

目录导读

NFS共享检测的核心挑战：为何“挂载成功”不等于“共享可用”？
基础检测方法：mount命令与文件访问测试
高级检测脚本实战：从连通性到性能的全面监控
常见问题与Q&A：故障排查与脚本优化
最佳实践与SEO友好提示

NFS共享检测的核心挑战

运维工程师经常遇到这样的困境：明明NFS共享已挂载，但应用写入文件时却超时或报错，这是因为 “挂载成功”仅代表客户端与服务器建立了连接，而真正的可用性需要验证以下层面：

脚本如何检测NFS共享是否正常

网络层：端口可达性（TCP 2049）
协议层：rpcbind服务是否正常
文件系统层：读写权限、磁盘空间、inode耗尽
性能层：延迟过高或I/O抖动

问题：为什么不能仅仅用df -h检测NFS共享？
回答：df -h只会检查挂载点是否存在，但无法检测NFS服务器宕机后客户端进入“软挂起”（soft hang）状态的情况，此时df可能无限等待，而脚本却无法识别异常。

基础检测方法

1 使用`mountpoint`命令

if mountpoint -q /mnt/nfs_share; then
    echo "挂载点存在"
else
    echo "挂载点丢失"
fi

局限：无法检测NFS服务本身的健康状态。

2 快速读写测试（推荐）

timeout 3 touch /mnt/nfs_share/testfile 2>/dev/null && echo "可写入"
timeout 3 ls -la /mnt/nfs_share/ >/dev/null 2>&1 && echo "可读取"

关键参数：timeout防止因NFS挂起导致脚本阻塞。

3 结合`showmount`检查服务器端导出

showmount -e nfs-server-ip 2>/dev/null | grep -q "你要的共享路径"

高级检测脚本实战（完整版）

以下脚本综合了网络、协议、文件系统三层检测，可直接用于生产环境：

#!/bin/bash
# NFS健康检查脚本 - version 2.1
# 作者：运维团队
# 用途：返回0为正常，非0为异常
NFS_SERVER="192.168.1.100"
SHARE_PATH="/data/nfs"
MOUNT_POINT="/mnt/nfs_backup"
TIMEOUT_SEC=5
LOG_FILE="/var/log/nfs_health.log"
# 1. 网络连通性测试
ping -c 2 -W 2 $NFS_SERVER >/dev/null 2>&1
if [ $? -ne 0 ]; then
    echo "$(date) ERROR: NFS服务器 $NFS_SERVER 不可达" >> $LOG_FILE
    exit 1
fi
# 2. NFS端口可达性（使用nc或telnet）
nc -zv -w $TIMEOUT_SEC $NFS_SERVER 2049 >/dev/null 2>&1
if [ $? -ne 0 ]; then
    echo "$(date) ERROR: NFS端口2049不可达" >> $LOG_FILE
    exit 2
fi
# 3. 挂载点有效性检测
mountpoint -q $MOUNT_POINT
if [ $? -ne 0 ]; then
    echo "$(date) ERROR: 挂载点 $MOUNT_POINT 未挂载" >> $LOG_FILE
    exit 3
fi
# 4. 模拟写入与读取（核心检测）
TEST_FILE="$MOUNT_POINT/healthcheck_$(date +%s).tmp"
timeout $TIMEOUT_SEC touch $TEST_FILE 2>/dev/null
if [ $? -ne 0 ]; then
    echo "$(date) ERROR: 文件写入失败 - 可能是NFS挂起或磁盘满" >> $LOG_FILE
    # 尝试强制重新挂载
    umount -lf $MOUNT_POINT 2>/dev/null && mount $MOUNT_POINT
    exit 4
fi
timeout $TIMEOUT_SEC ls -l $TEST_FILE >/dev/null 2>&1
if [ $? -ne 0 ]; then
    echo "$(date) ERROR: 文件读取失败" >> $LOG_FILE
    rm -f $TEST_FILE 2>/dev/null
    exit 5
fi
# 清理测试文件，检查删除操作是否正常
timeout $TIMEOUT_SEC rm -f $TEST_FILE 2>/dev/null
if [ $? -ne 0 ]; then
    echo "$(date) WARNING: 删除测试文件失败，但不阻断检测" >> $LOG_FILE
fi
echo "$(date) SUCCESS: NFS共享 $SHARE_PATH 完全正常" >> $LOG_FILE
exit 0

脚本执行建议：

放入crontab每1-5分钟执行一次
结合监控告警（如Zabbix、Prometheus）触发故障自愈
如果使用域名（如nfs.example.com），请替换脚本中的IP为域名

常见问题与Q&A

Q1: 脚本检测正常，但应用依然报错“Stale file handle”？

答案：这是NFS句柄过期问题，常见于服务器端重启后，解决方案是：

umount -l /mnt/nfs_share   # 强制卸载
mount /mnt/nfs_share       # 重新挂载

建议在检测脚本中增加对“stale”关键字的dmesg日志检查。

Q2: 如何检测NFS性能是否达标（延迟、带宽）？

答案：可使用dd测试吞吐量，但要注意避免高负载影响业务：

timeout 10 dd if=/dev/zero of=/mnt/nfs_share/test bs=1M count=100 2>&1 | grep "MB/s"

也可以使用nfsiostat命令实时监控（需要安装nfs-utils）。

Q3: 当NFS服务器有多个共享时，如何批量检测？

答案：将共享列表写入配置文件，循环调用单一检测函数：

for share in $(cat /etc/nfs_share_list); do
    check_nfs_health $share
done

Q4: 脚本返回成功但用户无权限写入？

答案：脚本需以root或具备写入权限的用户执行，建议在检测脚本中模拟无特权用户的写入操作：

sudo -u someuser touch /mnt/nfs_share/testfile

最佳实践与SEO友好提示

行业标准检测层次：

外部探测（External Probe）：从另一台机器挂载并测试
内部探测（Internal Probe）：通过rpc.statd监控
业务探测：模拟实际应用的读写模式

SEO优化关键词：

NFS监控脚本
NFS共享可用性检测
Linux NFS健康检查
存储高可用脚本
网络文件系统故障排查

警告：
如果您的NFS服务器通过域名访问（例如nfs.backup.example.com），请确保DNS解析正常，并在脚本中添加域名解析检测：

host $NFS_SERVER_DOMAIN >/dev/null 2>&1 || echo "DNS解析失败"

总结与下一步

通过上述脚本,您将实现从“挂载检测”到“可写可读性能检测”的全面覆盖，但请注意：

定期更新脚本：NFS版本升级可能带来新特性（如pNFS并行布局）
结合告警联动：当检测失败时，自动执行systemctl restart nfs-client.target
日志分析：定期检查/var/log/nfs_health.log，发现规律性故障

最终检查清单：

[ ] 网络端口2049可达
[ ] 挂载点存在且响应
[ ] 文件创建、读取、删除均正常
[ ] 用户权限模拟通过
[ ] 性能指标在合理阈值内

您的NFS共享监控体系搭建完成后,可将此脚本集成到Zabbix自定义监控项或Prometheus的Blackbox Exporter中，实现可视化告警。

脚本如何检测NFS共享是否正常