Linux用nmcli配置连接自动激活,重启后不生效该检查哪些设置

发布人:A5数据发布时间:2026-10-22 18:24阅读量:302

重启后网络连接没有自动起来,通常不是 nmcli connection up 命令失效,而是连接配置没有写入正确的配置文件、NetworkManager 没有在开机时接管网卡,或系统实际激活的是另一个连接配置。排查时应先确认“实际使用的连接配置”,再检查 connection.autoconnect、网卡绑定、服务状态和启动日志。

nmcli connection modify 修改的是持久化连接配置,而 nmcli connection up 只负责立即激活连接。手动执行 connection up 后当前网络正常,并不能证明重启后会自动激活。下面按已有 Linux 环境中的日常维护顺序进行检查,适用于使用 NetworkManager 管理网络的发行版。

nmcli 自动激活配置解决的是连接如何在系统启动时接入网络,服务器的硬件与线路资源则为持续运行的业务提供基础。A5数据提供香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器,覆盖常规建站、数据库、业务后台及多任务运行所需的不同CPU、内存、存储和网络方案。企业网站、接口服务与数据业务可结合部署地区和负载特点,匹配相应的服务器资源。

现状与条件:先确认网络由谁管理

确认 NetworkManager 正在运行

先检查 nmcli 是否能够正常访问 NetworkManager,以及服务是否设置为开机启动:

nmcli --version
nmcli general status

systemctl is-active NetworkManager
systemctl is-enabled NetworkManager

正常情况下,nmcli general status 能够返回网络状态,systemctl is-active 返回 active。如果服务已经运行但 is-enabled 返回 disabled,重启后可能没有自动启动 NetworkManager。

在确定该服务器使用 NetworkManager 管理网络的前提下,可以启用服务:

sudo systemctl enable --now NetworkManager

这会修改系统服务的开机启动状态,并立即启动 NetworkManager。远程 SSH 环境中执行前,应确认当前会话具备备用管理通道;如果系统实际由其他网络服务管理,不要同时启用多个网络管理后端。

部分发行版或定制系统可能使用不同的服务名称。遇到 Unit NetworkManager.service not found 时,先查看可用服务,不要直接猜测服务名:

systemctl list-unit-files | grep -Ei 'networkmanager|network|systemd-networkd'

确认网卡和连接配置的对应关系

查看网卡状态以及当前激活的连接:

确认网卡和连接配置的对应关系配图

nmcli device status
nmcli connection show --active

典型输出中的关键字段如下:

字段作用排查重点
DEVICE实际网卡名称是否为当前存在的网卡,如 ens160、enp1s0
CONNECTION当前激活的连接名称是否就是准备设置自动激活的配置
STATE网卡状态connected、disconnected、unavailable 的原因不同
AUTOCONNECT是否允许自动激活目标连接通常应为 yes
AUTOCONNECT-PRIORITY多个连接同时匹配时的优先级数值越高,通常越优先选择

再列出所有连接配置,重点观察实际连接名称、UUID、绑定网卡以及自动激活状态:

nmcli -f NAME,UUID,TYPE,DEVICE,AUTOCONNECT,AUTOCONNECT-PRIORITY connection show

不要只根据连接名称操作。服务器克隆、网卡更换或批量初始化后,连接名称可能相同,但 UUID、绑定网卡或 MAC 地址已经不同。应优先通过 DEVICE 列和当前激活状态确定目标连接。

确认设备由 NetworkManager 接管

如果 nmcli device status 中网卡显示为 unmanaged,即使连接配置的 autoconnect 为 yes,NetworkManager 也不会负责激活它:

nmcli -f GENERAL.STATE,GENERAL.CONNECTION,GENERAL.MANAGED,WIRED-PROPERTIES.CARRIER device show ens160

将 ens160 替换为实际网卡名。重点检查:

  • GENERAL.MANAGED 是否为 yes;
  • GENERAL.STATE 是否为可用或已连接状态;
  • WIRED-PROPERTIES.CARRIER 是否为 yes,有线网卡是否检测到链路。

如果只是临时测试,可以执行:

sudo nmcli device set ens160 managed yes

这通常只适合验证当前运行状态,不能替代持久化配置。若重启后又变为 unmanaged,应继续检查 /etc/NetworkManager/ 下的配置文件、发行版网络配置,以及是否存在 unmanaged-devices 规则。

日常操作:把自动激活写入正确的连接

修改目标连接的自动激活属性

确认连接名称后,使用连接的 id 或 UUID 修改。连接名称包含空格时,需要加引号:

修改目标连接的自动激活属性配图

sudo nmcli connection modify id "prod-lan" connection.autoconnect yes

如果服务器存在多个可匹配的以太网连接,可以同时设置优先级:

sudo nmcli connection modify id "prod-lan" \
  connection.autoconnect yes \
  connection.autoconnect-priority 100

connection.autoconnect yes 是持久化设置,重启后仍然有效。connection.autoconnect-priority 只影响多个候选连接之间的选择,不会修复网卡不存在、链路断开或 DHCP 失败等问题。

修改后检查配置是否已经写入:

nmcli -f connection.id,connection.uuid,connection.autoconnect,connection.autoconnect-priority connection show id "prod-lan"

需要注意,nmcli connection reload 只负责重新读取连接配置,不会主动激活一个尚未连接的配置:

sudo nmcli connection reload

如果只是通过 nmcli connection modify 修改,NetworkManager 通常已经知道配置变化;执行 reload 适合在外部文件发生变化后使用。

设置或校正网卡绑定

继续查看目标连接是否绑定了错误的接口名或旧 MAC 地址:

nmcli -f connection.id,connection.interface-name,802-3-ethernet.mac-address connection show id "prod-lan"
nmcli -f GENERAL.DEVICE,GENERAL.HWADDR,GENERAL.MTU device show ens160

常见冲突包括:

  • 连接配置绑定 ens160,系统实际网卡已经变成 enp1s0;
  • 虚拟机迁移后 MAC 地址变化,连接仍绑定旧 MAC;
  • 从模板克隆系统时,旧连接配置被一并复制;
  • 同一网卡存在多个连接,优先激活了旧配置。

如果网卡名称已经确定且不会变化,可以重新绑定:

sudo nmcli connection modify id "prod-lan" connection.interface-name ens160

如果环境要求绑定固定 MAC,也可以设置 MAC 地址:

sudo nmcli connection modify id "prod-lan" 802-3-ethernet.mac-address "52:54:00:12:34:56"

绑定接口名或 MAC 会缩小连接的匹配范围。虚拟机模板、云主机弹性网卡或可能更换网卡的环境,不宜盲目增加固定绑定。修改前应以 nmcli device show 返回的实际信息为准。

检查是否存在多个自动连接

如果同一台服务器存在多个以太网连接,先完整列出它们:

nmcli -f NAME,UUID,TYPE,DEVICE,AUTOCONNECT,AUTOCONNECT-PRIORITY connection show

可以按下面的方式判断:

  • 只有一个目标连接:将它设置为 autoconnect yes;
  • 多个连接都能匹配同一网卡:保留一个目标连接为 yes,其他连接设为 no,或为目标连接设置更高优先级;
  • 旧连接只是暂时不用:优先禁用自动激活,不要立即删除;
  • 不确定哪个连接包含静态地址、网关或 DNS:先查看配置并备份,再做调整。

禁用已确认的旧连接:

sudo nmcli connection modify id "旧连接名称" connection.autoconnect no

这不会删除连接配置,但会阻止它在后续启动时自动参与选择。不要直接使用 nmcli connection delete 清理未知连接,删除可能导致静态地址、路由、DNS 或认证参数丢失。

结果检查:先测试当前激活,再模拟重启后的选择

立即激活并观察结果

在具备控制台或备用连接的情况下,可以测试目标连接:

sudo nmcli connection up id "prod-lan" ifname ens160

该命令可能短暂中断当前会话。远程操作时,如果目标连接就是当前 SSH 使用的连接,应优先安排维护窗口,或通过带外控制台执行。

根据返回结果判断:

立即激活并观察结果配图

  • 命令成功:连接配置至少能够在当前环境完成激活,应重点检查自动激活、服务启动和启动时序;
  • 提示接口不存在:ifname 写错,或者系统启动后的网卡名称发生变化;
  • 提示连接不匹配:通常与 connection.interface-name、MAC 地址、连接类型有关;
  • 提示 DHCP 超时:连接已经开始激活,但地址获取或上游链路存在问题;
  • 提示设备为 unmanaged:NetworkManager 没有接管该设备;
  • 提示连接已激活但没有默认路由:继续检查 ipv4.never-default、网关和其他连接的路由优先级。

确认连接、地址和路由状态:

nmcli device status
nmcli connection show --active
ip -br address show ens160
ip route

如果系统使用 systemd-resolved,还可以检查 DNS:

resolvectl status ens160

区分“没有自动激活”和“已激活但网络不可用”

重启后执行以下检查,可以避免把不同问题混在一起:

nmcli -f NAME,DEVICE,AUTOCONNECT connection show
nmcli device show ens160
ip -br address show ens160
ip route

如果连接没有出现在 connection show --active 中,优先检查自动激活属性、服务状态、设备管理状态和接口绑定。

如果连接已经激活,但没有 IPv4 地址,应检查连接的 IP 配置:

nmcli -f ipv4.method,ipv4.addresses,ipv4.gateway,ipv4.dns,ipv4.never-default,ipv6.method,ipv6.never-default connection show id "prod-lan"

例如:

  • ipv4.method 为 auto:需要 DHCP 服务正常响应;
  • ipv4.method 为 manual:应确认地址、掩码、网关配置完整;
  • ipv4.method 为 disabled:不会获得 IPv4 地址;
  • ipv4.never-default 为 yes:该连接不会提供默认路由;
  • 连接有地址但没有默认路由:应用访问外部网络可能失败,但这不属于自动激活失败。

检查重启后的 NetworkManager 日志

重启后使用本次启动的日志进行排查:

journalctl -b -u NetworkManager --no-pager

为了快速筛选常见原因:

journalctl -b -u NetworkManager --no-pager | grep -Ei 'autoconnect|unmanaged|carrier|dhcp|timeout|failed|activated'

重点关注以下类型的信息:

日志现象可能原因下一步
跳过自动连接autoconnect 为 no、连接被标记失败或没有匹配设备检查连接属性和失败计数
device is unmanaged设备未由 NetworkManager 管理检查网络后端和 unmanaged 规则
carrier not available网线、虚拟交换机或虚拟网卡链路未就绪检查宿主机、交换机和网卡状态
DHCP timeoutDHCP 服务不可达、VLAN 错误或链路启动较慢检查二层连通性和 DHCP 日志
connection activation failed地址、认证、绑定或配置项不匹配使用 nmcli connection up 获取完整错误
activated 但应用仍失败网络已起来,但应用启动早于网络或路由、DNS不完整检查应用依赖和 wait-online 状态

异常处理:按低风险到高风险排除冲突

autoconnect 已经是 yes,但仍不自动激活

先检查是否修改了错误的连接。以下命令可以查看连接的 UUID、文件位置和接口绑定:

nmcli -f connection.id,connection.uuid,connection.filename,connection.interface-name,connection.autoconnect connection show id "prod-lan"

如果当前活动连接的 UUID 与修改的连接 UUID 不一致,说明修改的是另一个配置。应以 nmcli connection show --active 返回的实际连接为准。

还要查看自动连接重试次数:

nmcli -f connection.autoconnect,connection.autoconnect-retries connection show id "prod-lan"

如果 connection.autoconnect-retries 被设为 0,连接失败后可能不会继续尝试。确认网络环境确实允许持续重试时,可以设置为无限重试:

sudo nmcli connection modify id "prod-lan" connection.autoconnect-retries -1

这不能解决 DHCP 服务永久不可达的问题,只会让 NetworkManager继续尝试。对故障链路较多的服务器,应结合日志和告警使用,避免持续重试掩盖物理链路或交换机配置问题。

重启后出现多个连接,激活了错误配置

如果旧连接和新连接都显示 AUTOCONNECT yes,优先降低冲突范围。先记录两条连接的关键配置:

nmcli -f all connection show id "旧连接名称"
nmcli -f all connection show id "prod-lan"

确认旧连接不再使用后,禁用它的自动激活:

sudo nmcli connection modify id "旧连接名称" connection.autoconnect no

如果必须保留多个备用网络,使用优先级区分:

sudo nmcli connection modify id "prod-lan" connection.autoconnect-priority 100
sudo nmcli connection modify id "备用连接" connection.autoconnect-priority 20

这里的优先级只用于连接选择,不代表链路质量,也不等同于路由 metric。多个连接同时成功激活时,还需要单独检查默认路由是否冲突。

NetworkManager与其他网络后端冲突

如果系统配置文件明确使用其他网络后端,直接用 nmcli 修改可能不会成为启动时的最终配置。例如,使用 Netplan 的系统需要查看 renderer:

grep -R -n '^[[:space:]]*renderer:' /etc/netplan 2>/dev/null

如果结果显示使用 networkd,则实际生效的启动配置由 systemd-networkd 处理;如果显示使用 NetworkManager,才应继续以 NetworkManager 连接配置为主。

NetworkManager与其他网络后端冲突配图

此时不要同时让多个后端管理同一块网卡。应先确认系统的既定管理方式,再在对应配置中修改自动启动设置。混用的典型表现是:当前运行时通过 nmcli 可以激活,重启后又被另一个后端接管,或者出现重复地址、默认路由反复变化。

应用启动早于网络

有些场景中连接已经自动激活,但依赖网络的应用在网络完全就绪前就启动,表现为应用启动失败或首次连接超时。这与 autoconnect 不是同一问题。

检查 NetworkManager 的等待服务:

systemctl is-active NetworkManager-wait-online.service
systemctl is-enabled NetworkManager-wait-online.service
systemctl status NetworkManager-wait-online.service --no-pager

如果应用明确依赖 network-online.target,应检查应用单元是否声明了正确的启动依赖,并确认等待服务配置符合实际网络类型。启用等待服务会增加启动等待时间,不能用来修复错误的连接配置或无响应的 DHCP。

必要恢复:修改前备份,异常时按原值回退

修改前保存配置

即使本次只调整自动激活,也建议先记录目标连接的完整属性。连接配置文件可能包含静态地址、路由、DNS、认证信息等内容,备份目录应限制为 root 可读:

backup_dir="/root/nm-backup-$(date +%F-%H%M%S)"
sudo install -d -m 700 "$backup_dir"

sudo nmcli -f all connection show id "prod-lan" \
  | sudo tee "$backup_dir/prod-lan.txt" >/dev/null

if [ -d /etc/NetworkManager/system-connections ]; then
  sudo cp -a /etc/NetworkManager/system-connections "$backup_dir/"
fi

备份目录中的连接文件可能含有敏感配置,不要直接复制到普通用户目录或上传到公共位置。执行备份后,再修改 connection.autoconnect、优先级或接口绑定。

只回退本次变更

如果本次仅将自动激活从 no 改为 yes,应根据修改前记录恢复原值,而不是套用固定命令。例如原值为 no 时:

sudo nmcli connection modify id "prod-lan" connection.autoconnect no

如果同时修改了优先级或接口绑定,应一并恢复原来的值:

sudo nmcli connection modify id "prod-lan" \
  connection.autoconnect no \
  connection.autoconnect-priority 0 \
  connection.interface-name ens160

上面的值只是示例,实际回退值必须以修改前的记录为准。直接恢复错误的接口名或优先级,可能让连接再次无法匹配。

如果修改的是当前 SSH 使用的连接,回退或重新激活可能导致会话中断。优先使用控制台、远程管理卡或云平台串口进行恢复;没有备用通道时,不应在生产时段反复执行 connection down、connection up 或删除连接。

上线或验收检查清单

  • [ ] nmcli general status 能正常返回,NetworkManager 服务处于 active。
  • [ ] 已确认系统由 NetworkManager 管理,没有与其他网络后端同时接管同一网卡。
  • [ ] 目标连接的 UUID、名称和实际激活连接一致。
  • [ ] 目标连接的 connection.autoconnect 为 yes。
  • [ ] 多个连接同时匹配时,已设置清晰的自动连接优先级,或已禁用确认无用的旧连接。
  • [ ] connection.interface-name 和 MAC 地址没有绑定到已不存在的网卡。
  • [ ] nmcli device status 中目标网卡不是 unmanaged,链路状态正常。
  • [ ] connection.autoconnect-retries 没有被错误设为 0。
  • [ ] 手动执行 nmcli connection up id "目标连接" ifname "实际网卡" 能成功。
  • [ ] 连接激活后能获得预期 IP 地址、默认路由和 DNS。
  • [ ] 已通过 journalctl -b -u NetworkManager 检查过一次启动日志。
  • [ ] 如有应用依赖网络启动,已单独验证 NetworkManager-wait-online.service 和应用启动顺序。
  • [ ] 已保存修改前的连接配置,并明确记录了回退命令或原始参数。
  • [ ] 在维护窗口或带外控制台条件下完成过一次重启验证,确认无需手工执行 nmcli connection up。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5208.html

相关推荐