封装网络连通性检测函数，核心是解耦“测什么”与“怎么反馈”：用参数控制目标、超时、重试等行为，返回明确状态码（0=通，非0=不通），支持ping（三层）、nc（四层）、curl（应用层）三级探测，便于组合调用与精准故障定位。
封装检查网络连通性的通用函数，核心是把“测什么”和“怎么反馈”解耦：用参数控制目标（IP/域名/端口）、超时、重试等行为，返回明确的状态码（0=通，非0=不通），便于在脚本中直接判断或组合调用。
基础 IP/域名连通性检测函数
用 ping 验证三层可达性，适配 IPv4/IPv6，自动跳过 DNS 解析失败场景：
- 对 IP 地址：直接
ping -c 2 -W 3 $target，超时或丢包全为失败 - 对域名：先尝试
getent ahosts $target | head -1检查能否解析；解析失败直接返回 1，不依赖 ping 的“unknown host”模糊提示 - 统一用
$?判断退出码，函数末尾return $status，不 echo 任何内容——输出由调用方决定
端口级服务可用性检测函数
用 nc（netcat）验证四层 TCP 连通，比 telnet 更轻量、更易脚本化：
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 命令格式：
timeout 3 nc -z "$host" "$port" 2>/dev/null，-z 表示只探测不传数据，避免干扰服务 - 支持传入变量：
check_port "8.8.8.8" 53或check_port "api.example.com" 443 - 若目标是本地服务（如
127.0.0.1:8080），该函数同样适用，能快速区分是网络问题还是本机服务未启
HTTP 接口可达性检测函数
绕过 ICMP 屏蔽或防火墙限制，用 curl 测试应用层响应：
- 命令：
curl -I --connect-timeout 5 -s -o /dev/null -w "%{http_code}" "$url" - 只关心连接是否建立（不下载正文）、是否返回 2xx/3xx 状态码；返回 000 表示连接失败，404/502 等属于业务层问题，仍算“通”
- 适合检测 Web 服务、API 网关、健康检查端点（如
http://localhost/health）
组合调用与错误归因建议
单个函数只做一件事，多个函数串联才能准确定位故障层级：
- 先调
check_host gateway_ip→ 不通：查路由、网卡、物理链路 - 再调
check_host dns_server和check_host "www.baidu.com"→ 前者通后者不通：DNS 异常 - 接着调
check_port "www.baidu.com" 443→ 通但check_http "https://www.baidu.com"失败：SSL 或服务响应异常 - 每个函数失败时，可附加一行日志：
echo "$(date +%T) [ERROR] check_host $1 failed" >> netdiag.log
