AlmaLinux 10 网络排查:nmcli 诊断四件套与 NM 日志
This content is not available in your language yet.
在 almalinux:10 容器(aarch64;10.2,NetworkManager 1.56.0-3.el10_2)中实际执行 13 步采样:安装与版本、nmcli 诊断四件套的空态报错、journalctl 空态、monitor/connection monitor/general --help 用法采样、dbus-daemon 启动总线后的第二种报错形态、手动拉起 NetworkManager 后的真实输出与 nm-online 退出码。原始日志:plans/content-expansion/evidence/logs/alma-nm-diagnostics.log。
本页没有实测:真实网络设备上的激活失败端到端排查、systemd 环境下 journalctl 的 NM 真实日志行、nmcli general logging 运行时开 TRACE 的效果、wifi/WWAN/portal 场景。相关段落标注「文档口径,未实测」。
排查框架:从 NM 层自顶向下
Section titled “排查框架:从 NM 层自顶向下”「网络不通」是个复合症状——可能是 NM 没起、profile 没绑设备、链路断、DNS 坏。nmcli 的价值是把 NM 这一层的问题先摘出来:从客户端到总线、服务、设备、连接、连通性,一层层往下问,每一层都有对应命令。前四问不碰内核配置,纯只读:
| 层 | 问题 | 命令 |
|---|---|---|
| 客户端 | nmcli 本身能用吗 | nmcli --version |
| 总线 | D-Bus system bus 活着吗 | 看 nmcli 报错形态(下节) |
| 服务 | NetworkManager 在跑吗 | systemctl status NetworkManager(口径)或报错形态 |
| 设备 | NM 看到网卡了吗 | nmcli device status |
| 连接 | 设备上有激活的连接吗 | nmcli connection show 的 DEVICE 列 |
| 连通 | NM 自己怎么判 | nmcli networking connectivity |
| 之外 | 链路/IP/DNS | 出了 NM 层:网络排障;DNS 侧见 systemd-resolved |
写脚本时,「网络就绪」不要靠 ping 猜,用 nm-online 规范化等待:
if nm-online -t 15 -x; then echo "network ready"else echo "network not ready after 15s"finm-online 是脚本判就绪的规范化入口:默认等到有激活的连接就返回退出码 0;-s 改为等 NetworkManager startup 完成;-t 指定超时秒数(默认 30);-x 在 NM 未运行或连接中时立即退出——选项语义来自容器 --help 采样(日志 step8)。实测:NM 拉起后 nm-online -t 8 -x 打印 Connecting…[online] 并以退出码 0 结束(日志 step13)。注意它与 connectivity 是两把尺子:一个量「连接层有没有激活」,一个量「网络层通不通」,本次采样里退出码 0 与 limited 并存。
nmcli 诊断四件套(实测,含空态输出)
Section titled “nmcli 诊断四件套(实测,含空态输出)”四件套都是只读查询(connectivity check 会触发一次主动探测,也不改状态),可以放心在任何状态下跑:
| 命令 | 回答的问题 | 健康输出怎么读 |
|---|---|---|
nmcli general status | NM 整体状态与连通性 | STATE 一行说全局;WIFI-HW/WWAN-HW 是硬件能力 |
nmcli device status | NM 看到哪些设备、各自什么状态 | STATE=unmanaged 说明接口不受 NM 管 |
nmcli connection show | 有哪些 profile、绑到了哪块设备 | DEVICE=-- 表示 profile 存在但没绑设备 |
nmcli networking connectivity | NM 对「通不通」的判定 | none/portal/limited/full 四档 |
空态实录:默认容器(无 systemd、也无 D-Bus 总线)里,四件套统一输出:
Error: Could not create NMClient object: Could not connect: No such file or directory.装入 dbus-daemon 并以 dbus-daemon --system --fork 启动 system bus 之后(日志 step11-12),同一条 nmcli general status 变成:
Error: NetworkManager is not running.默认容器(无 systemd、也无 D-Bus 总线)里,四件套统一输出 Error: Could not create NMClient object: Could not connect: No such file or directory.——nmcli 已安装且能执行,失败点在总线层。装入 dbus-daemon 并以 dbus-daemon --system --fork 启动 system bus 之后,同一条 nmcli general status 变成 Error: NetworkManager is not running.——故障点推进到 NM 服务。三种状态对应三个排查方向:报错 A(NMClient 连不上)去查 bus,报错 B(NetworkManager is not running)去查 NM 服务,能出四张表说明 NM 在跑。nm-online --help、nmcli general --help、nmcli connection monitor --help 在无总线时仍能打印用法,需要总线的只是真正取数据的子命令。日志 step2-5、step11-12。
再手动拉起 NM(NetworkManager --no-daemon,日志 step13),四件套给出真实输出(UUID 完整值见日志):
$ nmcli general statusSTATE CONNECTIVITY WIFI-HW WIFI WWAN-HW WWAN METEREDconnected (local only) limited missing enabled missing enabled unknown
$ nmcli device statusDEVICE TYPE STATE CONNECTIONlo loopback connected (externally) loeth0 ethernet connected (externally) eth0
$ nmcli connection showNAME UUID TYPE DEVICElo 2e6aa790-b2e7-4322-a08e-706423d89ef2 loopback loeth0 488a781d-fc53-4ca8-9d7d-553b29056983 ethernet eth0Wired connection 1 f633a822-c948-31fd-a14a-74038204fa1e ethernet --
$ nmcli networking connectivitylimited这就是 NM 真正运行时四件套的输出形态:nmcli general status 给出 connected (local only) 与 CONNECTIVITY limited,WIFI-HW missing 只是没有无线硬件,属正常;nmcli device status 列出 lo 与 eth0,STATE 均为 connected (externally)——接口由 NM 之外的东西(容器里是宿主 veth)配好,NM 只是看见它,真实服务器上这条状态常出现在接口被其他进程或旧配置接管时,是 unmanaged 问题的前奏;nmcli connection show 里自动生成的 Wired connection 1 的 DEVICE 为 --,profile 存在但没绑设备,正是「有配置、没生效」的经典形态;nmcli networking connectivity 返回 limited。完整输出见日志 step13。
journalctl 与 NM 日志(未实测口径)
Section titled “journalctl 与 NM 日志(未实测口径)”容器实测:journalctl 二进制随依赖带入(/usr/bin/journalctl 存在),但容器没有 systemd journal,journalctl -u NetworkManager --no-pager 只返回:
No journal files were found.-- No entries --真实系统上的标准入口(文档口径,未实测):
journalctl -u NetworkManager --no-pager -b # 本次启动以来的 NM 日志journalctl -u NetworkManager --no-pager --since "10 min ago"激活失败时重点找 warn/error 级别的行(activation failed、carrier、dhclient 相关),并把时间戳与下节的 monitor 事件对齐。
容器实测:journalctl 二进制随依赖带入(/usr/bin/journalctl 存在),但容器没有 systemd journal,journalctl -u NetworkManager --no-pager 只返回 No journal files were found. 与 — No entries —。日志双轨为文档口径:运行时 nmcli general logging level TRACE domains ALL——该子命令在 nmcli general --help 实测可见(日志 step9),排查完调回 level INFO domains ALL,TRACE 会明显放大日志量,影响不写量化数字;持久轨在 /etc/NetworkManager/conf.d/ 下放 .conf 写 [logging] 段——该目录与 NetworkManager.conf 实测存在(日志 step9),字段语法以官方 NetworkManager.conf 文档为准。运行时 TRACE 效果与真实 journalctl 日志行未实测。日志 step6 与 step9。
nmcli monitor 与事件追踪
Section titled “nmcli monitor 与事件追踪”两个入口:
nmcli monitor——全局事件流,设备、连接、连通性变化都会推一行。实测注意:容器无总线时连nmcli monitor --help都先报 NMClient 错(日志 step7)——monitor 先建客户端连接、后才谈用法,所以「用法都打不开」本身就是总线层故障的信号。nmcli connection monitor [id|uuid|path] <ID>——盯单个连接,连接属性变化打印一行;不指定 ID 盯全部。用法说明在容器实测可见(日志 step9):「Monitor connection profile activity.」
典型用法是把 monitor 输出与 journalctl 时间戳对齐,定位「配置什么时候被谁改了」:dispatcher 脚本、nmcli reapply、手动编辑都会在时间轴上留痕。事件链路的实机采样未实测——这需要真实的连接状态变化;dispatcher 的自动化链路见 nm-dispatcher 页。
常见问题速查表
Section titled “常见问题速查表”| 现象 | 先跑 | 判读 / 去向 |
|---|---|---|
Error: Could not create NMClient object… | 看总线 | D-Bus 总线不在——查 dbus-broker 服务(口径);容器/受限环境属预期 |
Error: NetworkManager is not running. | systemctl status NetworkManager | bus 在、NM 服务未起;enable —now 拉起前先看失败原因 |
device status 出现 unmanaged | nmcli device status | 接口不受 NM 管——多为 ifcfg/keyfile 混用或 unmanaged-devices 配置,见 nmcli 管理 profile |
connection show 有 profile、DEVICE=-- | nmcli connection up <名称> | profile 没绑设备:autoconnect 关闭或激活失败;报错行配 journalctl 看 |
connectivity = limited / portal | nmcli networking connectivity check | limited=打不到完整互联网;portal=有认证页拦着;与 nm-online 是两把尺子 |
| 设备有 IP 但上不了外网 | ip route、ping 网关 | 已出 NM 层——见网络排障;DNS 侧见 systemd-resolved |
| 改了配置不生效 | nmcli connection reload + reapply | keyfile 改动要 reload;自动化见 nm-dispatcher |
表中 systemctl 的服务行为与 unmanaged 成因均为文档口径,容器未测。
- 真实网络设备上的完整诊断输出与激活失败的端到端闭环——容器 eth0 是宿主托管的 veth,step13 的输出形态不能代表物理机激活故障;
- systemd 环境下
journalctl -u NetworkManager的真实日志行与-b/--since组合输出; nmcli general logging运行时开 TRACE 的效果与日志量变化(不写量化数字);- wifi/WWAN 设备、portal 连通性与 dispatcher 触发的事件追踪实机链路;
- connectivity 判定依赖的探测 URL 配置(
[connectivity]段)在 AlmaLinux 10 的默认值——本次容器采样出现 limited,未取证其成因。