跳到主要内容
Linux脚本库
只读脚本测试版v0.1.1POSIX shMIT更新于

网络连通性与 DNS 诊断

检查网卡、默认路由、DNS 配置与目标可达性,快速区分是 DNS 问题还是网络不通

机器连不上外网时,问题可能出在网卡、路由、DNS 或防火墙。这个脚本按「网卡 → 路由 → DNS → 目标可达性」的顺序逐层检查,帮助快速定位断点在哪一层。

只读脚本,不修改网络配置;需要联网的测试项失败时会给出提示并继续,不会中断。

配置参数并生成脚本

选参数 → 即时生成 → 复制调用命令。绿色组合经过构建期校验,黄色为自定义组合。

常用预设
format

文本适合直接查看,JSON 适合二次处理

target

用于连通性测试的主机名或 IP

已验证
network-diagnose.sh|6.0 KB
#!/bin/sh
# ==============================================================================
# Linux脚本库 · 网络连通性与 DNS 诊断
# ------------------------------------------------------------------------------
# 脚本 ID    : network-diagnose
# 版本       : 0.1.1
# 构建标识   : f4a521a2
# 分类       : troubleshoot / network
# 危险等级   : 只读(不修改系统)
# 幂等       : 是(重复执行无副作用)
# 预演       : 不支持
# 默认参数   : format=text, target=223.5.5.5
# 参数覆盖   : 在命令后加 --<参数名> <值>,例如 --format json;--help 查看全部
# 文档       : https://linuxmirror.cn/script/network-diagnose/
# ------------------------------------------------------------------------------
# 本文件由 Linux脚本库生成器输出,请勿手工修改。
# 执行前请阅读文档,并确认已理解脚本将要做的改动。
# ==============================================================================

set -eu
umask 022

# ---- 脚本元信息 ----
LM_SCRIPT_ID='network-diagnose'
LM_SCRIPT_VERSION='0.1.1'
LM_SCRIPT_BUILD='f4a521a2'
LM_DOC_URL='https://linuxmirror.cn/script/network-diagnose/'

# ---- 公共函数 ----
die() {
  _lm_code=$1
  shift
  printf '[错误] %s\n' "$*" >&2
  exit "$_lm_code"
}

log() {
  printf '[信息] %s\n' "$*"
}

warn() {
  printf '[警告] %s\n' "$*" >&2
}

has_cmd() {
  command -v "$1" >/dev/null 2>&1
}

need_cmd() {
  for _lm_c in "$@"; do
    has_cmd "$_lm_c" || die 3 "缺少依赖命令: $_lm_c"
  done
}

need_root() {
  [ "$(id -u)" -eq 0 ] || die 4 '需要 root 权限,请使用 sudo 执行'
}

need_os_release() {
  [ -r /etc/os-release ] || die 3 '/etc/os-release 不存在,无法识别系统发行版'
}

in_container() {
  [ -f /.dockerenv ] || [ -f /run/.containerenv ]
}

has_systemd() {
  [ -d /run/systemd/system ]
}

# ---- 默认参数(可用命令行覆盖)----
LM_FORMAT='text'
LM_TARGET='223.5.5.5'

# ---- 命令行参数(覆盖上面的默认值)----
lm_usage() {
  cat <<'LM_USAGE'
用法: bash <(curl -sSL "https://linuxmirror.cn/s/network-diagnose.sh") [选项]

选项:
  -format, --format       输出格式(可选: text|json)
  -target, --target       测试目标(默认: 223.5.5.5)
  -h, --help                显示本帮助
  --version                 显示脚本版本
LM_USAGE
}

LM_EXTRA_ARGS=""
while [ $# -gt 0 ]; do
  case "$1" in
    -h|--help)
      lm_usage
      exit 0
      ;;
    --version)
      printf '%s\n' "$LM_SCRIPT_ID v$LM_SCRIPT_VERSION"
      exit 0
      ;;
    --)
      shift
      break
      ;;
    -format|--format)
      [ $# -ge 2 ] || die 2 'format 需要一个值'
      LM_FORMAT=$2
      shift 2
      ;;
    --format=*|-format=*)
      LM_FORMAT=${1#*=}
      shift
      ;;
    -target|--target)
      [ $# -ge 2 ] || die 2 'target 需要一个值'
      LM_TARGET=$2
      shift 2
      ;;
    --target=*|-target=*)
      LM_TARGET=${1#*=}
      shift
      ;;
    *) LM_EXTRA_ARGS="$LM_EXTRA_ARGS $1"; shift ;;
  esac
done

# 未识别的参数留给正文(例如 --dry-run);正文可用 "$@" 读取
if [ -n "$LM_EXTRA_ARGS" ]; then
  # shellcheck disable=SC2086
  set -- $LM_EXTRA_ARGS
fi

# ---- 参数兜底校验 ----
case $LM_FORMAT in
  text|json) ;;
  *) printf '[错误] %s 取值非法: %s\n' '输出格式' "$LM_FORMAT" >&2; exit 2 ;;
esac
case $LM_TARGET in
  ''|*[!A-Za-z0-9.:_-]*) die 2 '测试目标 不是合法主机名' ;;
esac

# ==============================================================================
# 正文
# ==============================================================================
# 网卡与路由
if has_cmd ip; then
  IFACE=$(ip -o -4 addr show 2>/dev/null | awk '$2 != "lo" {print $2" "$4; exit}')
  DEFAULT_ROUTE=$(ip route show default 2>/dev/null | head -1)
else
  IFACE=$(ifconfig 2>/dev/null | awk '/^[a-z]/ {iface=$1} /inet / && $1 != "127.0.0.1" {print iface" "$2; exit}')
  DEFAULT_ROUTE=$(route -n 2>/dev/null | awk '$1 == "0.0.0.0" {print; exit}')
fi
[ -n "$IFACE" ] || IFACE='未获取到'
[ -n "$DEFAULT_ROUTE" ] || DEFAULT_ROUTE='未获取到'

# DNS
DNS_SERVERS=$(awk '/^nameserver/ {printf "%s ", $2}' /etc/resolv.conf 2>/dev/null)
[ -n "$DNS_SERVERS" ] || DNS_SERVERS='未配置'

# 解析测试
RESOLVE_OK=0
RESOLVE_RESULT='未测试'
if has_cmd getent; then
  if getent hosts "$LM_TARGET" >/dev/null 2>&1; then RESOLVE_OK=1; RESOLVE_RESULT='ok'; else RESOLVE_RESULT='failed'; fi
elif has_cmd nslookup; then
  if nslookup "$LM_TARGET" >/dev/null 2>&1; then RESOLVE_OK=1; RESOLVE_RESULT='ok'; else RESOLVE_RESULT='failed'; fi
fi

# 连通性
PING_OK=0
if has_cmd ping; then
  if ping -c 2 -W 2 "$LM_TARGET" >/dev/null 2>&1; then PING_OK=1; fi
fi
TCP_OK=0
TCP_RESULT='未测试'
if has_cmd curl; then
  code=$(curl -sS -o /dev/null -m 5 -w '%{http_code}' "https://$LM_TARGET/" 2>/dev/null || true)
  if [ -n "$code" ]; then TCP_OK=1; TCP_RESULT="$code"; else TCP_RESULT='连接失败'; fi
fi

if [ "$LM_FORMAT" = 'json' ]; then
  printf '{"interface":"%s","default_route":"%s","dns":"%s","target":"%s","resolve":%s,"ping":%s,"tcp_ok":%s,"http_code":"%s"}\n' \
    "$(printf '%s' "$IFACE" | sed 's/"/\\"/g')" "$(printf '%s' "$DEFAULT_ROUTE" | sed 's/"/\\"/g')" "$(printf '%s' "$DNS_SERVERS" | sed 's/ /,/g; s/,$//')" "$LM_TARGET" "$RESOLVE_OK" "$PING_OK" "$TCP_OK" "$TCP_RESULT"
  exit 0
fi

log '================ 网络诊断 ================'
log "网卡地址   : $IFACE"
log "默认路由   : $DEFAULT_ROUTE"
log "DNS        : $DNS_SERVERS"
log "测试目标   : $LM_TARGET"
log "域名解析   : $RESOLVE_RESULT"
if [ "$PING_OK" = '1' ]; then log 'ICMP 连通   : ok'; else log 'ICMP 连通   : 失败(可能被防火墙拦截,不一定代表网络不通)'; fi
log "HTTPS 访问 : $TCP_RESULT"
log ''
if [ "$RESOLVE_OK" = '0' ] && [ "$PING_OK" = '1' ]; then
  warn '疑似 DNS 问题:网络可达但域名解析失败,检查 /etc/resolv.conf 或 DNS 服务'
elif [ "$PING_OK" = '0' ] && [ "$TCP_OK" = '0' ]; then
  warn '疑似网络不通:检查网卡状态、默认路由、安全组与防火墙'
else
  log '未发现明显的解析或连通性断点'
fi
sha256:424225bc110f317bab9fc5529b6893bc5818dd15fa1bb755fc589f0ad8e1a571
固定 URL 与执行方式
# 唯一支持的调用方式:固定 URL 是静态脚本,参数在命令后覆盖
bash <(curl -sSL "https://linuxmirror.cn/s/network-diagnose.sh")

# 查看全部参数
bash <(curl -sSL "https://linuxmirror.cn/s/network-diagnose.sh") --help
固定 URLhttps://linuxmirror.cn/s/network-diagnose.sh

URL 永远不变(版本升级也继续可用);只允许 curl 调用,浏览器与 wget 会被拒绝。

兼容矩阵

共支持 8 个发行版,均为理论支持。 系统识别统一读取 /etc/os-release, 不依赖 /etc/redhat-release。

发行版最低版本最高版本实测
Debian1113未实测
Ubuntu20.0426.04未实测
CentOS79未实测
Rocky Linux810未实测
AlmaLinux810未实测
openEuler20.03—未实测
Alpine3—未实测
Arch Linux——未实测

支持架构:x86_64 · ARM64 (aarch64)

运行要求与影响范围

运行权限
普通用户即可
网络依赖
需要访问外网 / 镜像站
幂等性
幂等,重复执行无副作用
预演支持
不支持预演

常见问题

没有外网还能用吗?

可以。网卡、路由、DNS 配置与内网探测不依赖外网;外网测试项失败会显示失败但不会中断。

为什么用 HTTPS 而不是 http?

HTTPS 能同时验证 DNS、路由与 TLS 链路;脚本不会关闭证书校验(不使用 -k)。

免责声明:本脚本按"原样"提供,作者与本站不对因使用脚本造成的任何直接或间接损失负责。 请在测试环境验证后再用于生产,并自行承担执行风险。脚本由服务端按参数实时渲染, 可在页面生成器里核对完整内容后,再通过固定 URL 执行。 如发现安全问题请通过 dakerteam@163.com 联系。

固定地址(版本升级不变,参数用 query):https://linuxmirror.cn/s/network-diagnose.sh· sha256 端点:https://linuxmirror.cn/s/network-diagnose.sha256

审计用不可变地址(内容变更即换地址,适合复现与比对):https://linuxmirror.cn/s/network-diagnose/0.1.1/

输入关键词开始搜索。脚本名、发行版、分类、文档标题都会被索引。

↑↓ 选择 · Enter 打开浏览全部脚本