Linux服务器NetworkManager配置不生效时,如何定位连接与路由问题?
服务器上执行了 nmcli connection modify,但重连后地址、默认网关或静态路由仍然不对,常见表现包括:nmcli connection show 里配置看起来正确,ip route 却没有对应路由;服务器能访问同网段网关,却无法访问其他网段;重启 NetworkManager 或服务器后配置恢复旧值;多块网卡同时启用时,默认流量走错出口。
这类问题不能只盯着某一个配置文件。NetworkManager 至少涉及连接配置文件、当前激活的连接、内核实际地址与路由、DHCP 下发内容,以及云初始化或其他网络管理服务。排查时应先确认“哪个连接被激活”,再对比“配置值”和“运行值”,最后使用 ip route get 验证真实选路。

先确认故障属于哪一层
在开始修改前,先把现象分成连接、地址、路由和 DNS 四类。不同现象对应的检查位置不同:
| 现象 | 优先检查位置 | 常见原因 |
|---|---|---|
| 网卡显示未连接或没有地址 | 物理链路、虚拟网卡状态、激活连接 | 网卡未接入、连接未激活、接口名称变化 |
| 地址存在,但没有默认路由 | NetworkManager 连接属性、DHCP 路由 | ipv4.never-default、ipv4.ignore-auto-routes 或网关未配置 |
| 默认路由存在,但流量走错网卡 | 路由 metric、策略路由、多个激活连接 | 多个默认网关、ip rule 优先级、路由表冲突 |
| 访问 IP 正常,域名失败 | DNS 配置和 /etc/resolv.conf | DNS 未下发、解析服务未运行、配置被覆盖 |
| 当前有效,重启后失效 | 外部配置管理器和启动流程 | cloud-init、Netplan、旧版 ifcfg 配置或其他网络服务覆盖 |
| 配置文件正确,但当前运行状态未变 | 激活连接与内核状态 | 只修改了 profile,没有重新激活或重新应用 |
下面的命令以已安装 NetworkManager 的 Linux 服务器为例。建议通过控制台、带外管理或第二条管理链路操作;远程执行 nmcli connection down、nmcli connection up 或重启 NetworkManager,都可能导致当前 SSH 断开。
第一步:采集当前状态,不先改配置
确认 NetworkManager 是否真正接管网络
先检查服务状态、版本和设备状态:
systemctl is-active NetworkManager
NetworkManager --version
nmcli general status
nmcli device status
正常情况下,systemctl is-active 返回 active,nmcli general status 能显示运行状态,nmcli device status 会列出接口、类型、状态和当前连接。
如果 NetworkManager 不在运行,或者 nmcli 报错无法连接到服务,继续修改连接 profile 不会改变内核网络状态。此时应先确认服务器是否实际由 systemd-networkd、Netplan 生成配置,或发行版自身的其他机制管理。
可以同时查看:
systemctl is-active systemd-networkd
systemctl is-enabled systemd-networkd 2>/dev/null || true
如果 NetworkManager 和其他网络管理服务同时尝试管理同一接口,配置可能反复变化。不要立即停用服务,先记录当前启用情况,并确认该服务器的启动方式和发行版配置约定。
保存诊断信息
以下命令只读取状态,不会改变网络。建议在 root shell 中执行,避免输出重定向时权限不足:
D="/root/nm-audit-$(date +%F-%H%M%S)"
mkdir -p "$D"
nmcli -f all connection show > "$D/profiles.txt"
nmcli connection show --active > "$D/active-profiles.txt"
nmcli device show > "$D/devices.txt"
ip -br link > "$D/ip-link.txt"
ip -br address > "$D/ip-address.txt"
ip route show table all > "$D/routes.txt"
ip rule show > "$D/rules.txt"
journalctl -u NetworkManager -b --no-pager -n 200 > "$D/NetworkManager-journal.txt"
这里没有使用 nmcli --show-secrets,避免把连接密码等敏感信息写入诊断文件。如果系统使用 keyfile 保存连接,也可以在确认权限后备份配置目录:
if [ -d /etc/NetworkManager/system-connections ]; then
cp -a /etc/NetworkManager/system-connections "$D/"
fi
备份目录通常只允许 root 读取。不要把其中的配置文件直接上传到公开工单或聊天工具。
确认接口、地址和链路状态
ip -br link
ip -br address
示例输出可能类似:
eth0 UP 192.0.2.10/24
eth1 UP 198.51.100.10/24
这里只能说明接口处于启用状态并拥有地址,不能说明默认流量一定走这块网卡。继续查看链路和当前连接:
nmcli device status
nmcli connection show --active
重点看 DEVICE 和 CONNECTION 的对应关系。连接列表中 DEVICE 显示为 -- 的 profile 当前没有被激活,不能把它当成正在生效的配置。
第二步:确认实际激活的是哪个连接
NetworkManager 的“连接”是一个配置 profile,不等同于网卡本身。一个接口可能存在多个 Ethernet profile,但同一时刻通常只有一个 profile 处于激活状态。
先列出所有连接:
nmcli -f NAME,UUID,TYPE,DEVICE connection show
可能出现以下情况:
NAME UUID TYPE DEVICE
public-net 11111111-1111-1111-1111-111111111111 ethernet eth0
old-public 22222222-2222-2222-2222-222222222222 ethernet --
storage-net 33333333-3333-3333-3333-333333333333 ethernet eth1
此时应检查 public-net,而不是只修改名称相似的 old-public。如果修改的是未激活 profile,nmcli connection show 能看到新值,但 ip address 和 ip route 不会立即变化。

对正在使用的 UUID 查看关键属性:
UUID="11111111-1111-1111-1111-111111111111"
nmcli -f \
connection.id,connection.uuid,connection.interface-name,connection.autoconnect,connection.autoconnect-priority,\
ipv4.method,ipv4.addresses,ipv4.gateway,ipv4.routes,ipv4.route-metric,\
ipv4.never-default,ipv4.ignore-auto-routes,ipv4.dns,ipv4.ignore-auto-dns \
connection show "$UUID"
需要重点关注:
connection.interface-name是否绑定到了正确接口;connection.autoconnect是否允许开机自动连接;connection.autoconnect-priority是否导致错误 profile 优先;ipv4.method是auto、manual还是disabled;ipv4.never-default是否阻止了默认路由;ipv4.ignore-auto-routes是否忽略了 DHCP 下发的路由;ipv4.route-metric是否比另一块网卡更高或更低;ipv4.routes中是否存在重复、错误或过期的静态路由。
ipv4.method 为 manual 时,地址、前缀和网关通常由 profile 定义;为 auto 时,地址和路由可能由 DHCP 动态提供。不要仅凭配置文件中的 ipv4.gateway 判断默认路由一定存在,还要检查 never-default、DHCP 选项和当前内核路由表。
第三步:对比配置值与实际运行值
这是定位“配置不生效”的关键步骤。分别执行:
nmcli connection show "$UUID"
nmcli device show eth0
ip -br address show dev eth0
ip route show dev eth0
这里有三种常见结果。
连接 profile 正确,内核状态仍是旧值
例如 profile 中已经是 192.0.2.10/24,但 ip -br address 仍显示旧地址。这通常说明修改只写入了 profile,当前激活连接还没有重新应用。
对于支持重新应用的属性,可以先尝试:
nmcli device reapply eth0
如果返回不支持重新应用,或者地址、网关等关键参数没有变化,应在维护窗口中重新激活:
nmcli connection up "$UUID" ifname eth0
这一步可能删除旧地址、重建路由并中断 SSH。远程服务器不要在唯一管理链路上直接执行,除非已经准备好控制台或回滚路径。
当前运行值正确,profile 中的值错误
这可能是通过临时方式修改了设备状态,例如:
nmcli device modify eth0 ipv4.route-metric 50
nmcli device modify 主要用于修改当前设备的运行状态,重连或重启后可能消失。需要持久化时,应修改连接 profile:
nmcli connection modify "$UUID" ipv4.route-metric 50
修改后再按照维护窗口安排重新应用或重连。不要把临时验证命令当成永久修复。
profile 和当前地址都正确,但路由仍不符合预期
此时要从路由表判断真实选路,不能只看 NetworkManager 输出:
ip route
ip route show table all
ip rule show
再对目标地址进行选路查询:
ip route get 8.8.8.8
ip route get 10.20.30.40
ip route get 显示的是内核针对某个目标地址选择的出口、下一跳、接口和源地址。例如:

8.8.8.8 via 192.0.2.1 dev eth0 src 192.0.2.10 metric 100
10.20.30.40 via 198.51.100.1 dev eth1 src 198.51.100.10 metric 50
这说明两个目标使用了不同的出口。若业务要求所有外部流量都走 eth0,就要继续检查 eth1 是否安装了更低 metric 的默认路由,或者是否存在策略路由规则。
第四步:按由外到内的顺序检查路由
先看直连网段和网关是否合理
常见路由结构可能是:
192.0.2.0/24 dev eth0 proto kernel scope link src 192.0.2.10
default via 192.0.2.1 dev eth0 metric 100
第一行表示本地地址和网段,第二行表示默认出口。若只有第一行,没有 default,访问同网段地址可能正常,但跨网段流量没有出口。
检查网关是否与接口地址处于可达的本地网段:
ip route get 192.0.2.1
ping -c 3 -W 1 192.0.2.1
网关不响应不一定代表配置错误,因为网络设备可能禁止 ICMP。可以把 ip route get 结果作为主要判断依据,再结合业务端口或网络设备日志验证。
检查默认路由是否被禁止或忽略
以下属性会直接影响默认路由:
nmcli -f ipv4.method,ipv4.gateway,ipv4.never-default,ipv4.ignore-auto-routes,ipv4.route-metric \
connection show "$UUID"
重点判断:
ipv4.never-default: yes:该连接不会成为默认路由来源;ipv4.ignore-auto-routes: yes:DHCP 提供的路由可能被忽略;ipv4.method: manual但没有有效网关:不会得到预期的默认出口;- 多个 profile 都是自动连接:可能出现多个默认路由;
- 多个默认路由的 metric 不同:数值较小的通常优先。
如果服务器有内外两块网卡,常见设计是只让外网接口提供默认路由,内网接口只提供特定网段路由。此时可以给内网 profile 设置:
nmcli connection modify "$UUID" ipv4.never-default yes
这会改变流量出口,属于有影响的配置,执行前应确认该接口确实不承担默认流量,并保留原值以便回滚。
检查静态路由是否写入了错误 profile
静态路由只写在某个 profile 中,只有该 profile 激活时才会安装到内核。检查当前 profile:
nmcli -f ipv4.routes,ipv4.routing-rules connection show "$UUID"
ip route show table main
添加一条示例内网路由时,可以使用:
nmcli connection modify "$UUID" +ipv4.routes "10.20.0.0/16 192.0.2.1"
如果需要设置多个静态路由,也可以整体指定:
nmcli connection modify "$UUID" ipv4.routes \
"10.20.0.0/16 192.0.2.1,10.30.0.0/16 192.0.2.1"
整体指定会替换该属性原有列表,不能直接照抄到已有复杂配置中。修改前应记录原来的 ipv4.routes,确认不会删除业务必需路由。下一跳 192.0.2.1 只是文档示例,实际环境必须替换为当前接口可达的网关。
检查策略路由和多出口场景
如果 ip route 看起来正常,但特定源地址或业务仍然走错出口,需要检查策略路由:
ip rule show
ip route show table all
策略路由可能依据源地址、目标网段或防火墙标记选择不同路由表。此时只查看 main 表不够,必须确认:
ip rule的优先级顺序;- 规则匹配的源地址和目标地址;
- 规则指向的路由表;
- 目标路由表中是否存在下一跳;
- 返回流量是否能沿正确路径返回。
可以带源地址查询:
ip route get 10.20.30.40 from 198.51.100.10
ip route get 10.20.30.40 from 192.0.2.10
如果两个查询结果不同,说明源地址参与了选路。此时不应简单删除某一条默认路由,应先确认业务是否依赖双出口。
第五步:排除 DHCP、云初始化和其他服务覆盖
观察 NetworkManager 是否反复重写配置
查看本次启动的日志:
journalctl -u NetworkManager -b --no-pager | \
grep -Ei 'dhcp|route|gateway|dispatcher|failed|error|activate'
如果能看到 DHCP 租约更新、连接反复激活、路由被添加后又删除,说明问题可能不是静态配置写错,而是动态事件在改变运行状态。
也可以实时观察地址和路由变化:
ip monitor address route
在另一个终端执行重连或等待 DHCP 更新。如果路由刚出现又消失,或者接口重新获得地址后默认路由发生变化,应继续查 DHCP 和外部管理流程。
确认配置来源
不同发行版和版本可能使用 keyfile、旧版 ifcfg 文件或 Netplan 生成配置。先查看 NetworkManager 的配置来源:
NetworkManager --print-config
find /etc/NetworkManager /etc/sysconfig/network-scripts /etc/netplan \
-maxdepth 2 -type f -print 2>/dev/null
还应检查是否存在启动时改写网络的组件:
systemctl is-active cloud-init 2>/dev/null || true
find /etc/NetworkManager/dispatcher.d -maxdepth 1 -type f -print 2>/dev/null
判断方法如下:

- 修改后立即生效、重启后恢复:优先检查 cloud-init、Netplan 生成文件和启动脚本;
- DHCP 每次续租后恢复旧路由:检查 DHCP 服务器下发的网关、路由和 DNS;
- NetworkManager 日志显示连接被其他服务停止:确认是否有
systemd-networkd或自动化工具竞争; - 只修改了某个文件但
nmcli connection show不变:该文件可能不是当前版本使用的配置来源。
不要同时编辑多个来源。应先确定由哪个组件负责生成配置,再在上游配置中修改,否则手工改动可能在下一次启动或租约更新时被覆盖。
第六步:根据结果选择低风险修复方式
只是激活了错误 profile
先确认正确 profile 的 UUID 和接口,再禁用错误 profile 的自动连接:
nmcli connection modify "old-public" connection.autoconnect no
nmcli connection modify "$UUID" connection.autoconnect yes
如果存在多个 profile 竞争同一接口,可以设置明确的优先级:
nmcli connection modify "$UUID" connection.autoconnect-priority 100
修改后不要立即重启整台服务器,先在维护窗口激活目标 profile,并观察 nmcli device status、ip address 和 ip route。
需要修正持久化地址或网关
静态 IPv4 示例:
nmcli connection modify "$UUID" \
ipv4.method manual \
ipv4.addresses "192.0.2.10/24" \
ipv4.gateway "192.0.2.1" \
ipv4.never-default no
如果是纯 DHCP profile,可以使用:
nmcli connection modify "$UUID" ipv4.method auto
不要在不清楚原有静态路由的情况下直接清空 ipv4.routes、DNS 或其他属性。对生产服务器来说,逐项修改比整段覆盖更容易回滚。
只需要调整多个默认出口的优先级
例如让 eth0 优先于 eth1:
nmcli connection modify "$UUID_ETH0" ipv4.route-metric 100
nmcli connection modify "$UUID_ETH1" ipv4.route-metric 200
这只适合“两个接口都可以提供默认出口,但有明确主次”的场景。如果某个接口不应出现默认路由,使用 ipv4.never-default yes 更清晰。
重新加载和激活
如果只修改了 profile 文件,可以先重新加载连接配置:
nmcli connection reload
但重新加载不一定改变当前运行状态。需要重新安装地址和路由时,再执行:
nmcli connection up "$UUID" ifname eth0
如果命令失败,立即查看:
journalctl -u NetworkManager -b --no-pager -n 100
nmcli device status
nmcli connection show --active
常见失败原因包括接口名称不匹配、地址格式错误、DHCP 超时、网关不可达或 profile 被设置为不允许自动连接。
修复后的验证顺序
不要只以 nmcli connection modify 返回成功作为验收结果。至少按以下顺序复测:
- 确认目标 profile 已激活:
nmcli connection show --active
nmcli device status
- 确认地址和前缀:
ip -br address show dev eth0
- 确认直连路由和默认路由:
ip route show dev eth0
ip route
- 确认目标地址的真实出口:
ip route get 8.8.8.8
ip route get 10.20.30.40
- 确认网关和业务目标。ICMP 被禁用时,
ping失败不能单独证明路由错误,应结合实际业务端口、应用日志或网络设备侧状态判断:
ping -c 3 -W 1 192.0.2.1
ping -c 3 -W 1 10.20.30.40
- 如果表现为域名访问失败,再单独检查 DNS:
resolvectl status
ls -l /etc/resolv.conf
getent ahostsv4 example.com
IP 访问正常而域名解析失败,问题通常在 DNS,不应继续修改默认路由。/etc/resolv.conf 如果是符号链接,应确认其背后的解析服务和 NetworkManager DNS 配置,不要只手工覆盖该文件。
常见分支和处理方向
| 复测结果 | 判断 | 后续动作 |
|---|---|---|
| profile、地址、路由都正确,业务恢复 | 配置已生效 | 保留诊断记录,继续观察 |
| profile 正确,运行地址或路由旧 | 尚未重新应用 | 使用 nmcli device reapply 或维护窗口重连 |
| 激活连接不是预期 profile | profile 竞争 | 调整自动连接和优先级,禁用错误 profile |
| 默认路由缺失 | 网关、never-default 或 DHCP 路由问题 | 检查 profile 属性和 DHCP 日志 |
| 有多个默认路由,出口不稳定 | metric 或策略路由冲突 | 使用 ip route get 和 ip rule 确认主次 |
| 重启后恢复旧配置 | 外部配置源覆盖 | 检查 cloud-init、Netplan、启动脚本和其他网络服务 |
| 路由正确但业务不通 | 可能是防火墙、ACL、服务监听或回程路径 | 检查主机防火墙、目标端口和返回路径 |
| IP 正常、域名失败 | DNS 故障 | 检查 NetworkManager DNS、解析服务和 /etc/resolv.conf |
回滚和持续观察
涉及地址、网关、默认路由的修改,回滚重点不是“重启服务器”,而是恢复原 profile 属性并重新激活。修改前应保存 nmcli connection show 输出和 keyfile 备份;如果直接编辑了 /etc/NetworkManager/system-connections/ 下的文件,应先恢复备份,再执行:
nmcli connection reload
nmcli connection up "$UUID" ifname eth0
如果当前 SSH 连接依赖被修改的接口,回滚动作也可能中断会话,因此应优先使用控制台或安排维护窗口。不要把 systemctl restart NetworkManager 作为第一选择;它会重新评估所有连接,可能同时影响多块网卡和现有业务。
修复后可在一段时间内观察地址、路由和 NetworkManager 日志:
ip monitor address route
journalctl -u NetworkManager -f
需要验证重启持久性时,应在确认管理链路和回滚方式后安排维护窗口。重启后再次检查激活 profile、地址、默认路由、策略路由和 DNS,而不是只看服务器是否能够登录。这样才能区分“当前会话中临时恢复”和“配置已经稳定生效”。
Linux服务器的连接与路由配置,最终需要落在与业务负载和访问区域相匹配的基础设施上。A5数据提供中国香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器,覆盖常规建站、数据库、接口服务和多任务计算等资源需求,并提供不同CPU、内存、存储及网络线路组合,为多地区业务部署和网络架构规划提供硬件与线路选择。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4676.html



