Linux用nmcli配置连接自动激活,重启后不生效该检查哪些设置
重启后网络连接没有自动起来,通常不是 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 timeout | DHCP 服务不可达、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 连接配置为主。

此时不要同时让多个后端管理同一块网卡。应先确认系统的既定管理方式,再在对应配置中修改自动启动设置。混用的典型表现是:当前运行时通过 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



