1. 项目概述：从命令行高效管理网络

在Linux服务器运维和桌面管理的日常工作中，网络配置是绕不开的一环。很多朋友习惯了图形界面，或者直接去修改/etc/sysconfig/network-scripts/下的配置文件，但当你面对一台没有图形界面的服务器，或者需要通过脚本批量管理成百上千台机器时，一个强大、统一的命令行工具就显得至关重要。nmcli（NetworkManager Command-Line Interface）就是这样一个被严重低估的利器。

简单来说，nmcli是 NetworkManager 服务的命令行客户端。NetworkManager 是一个动态的网络控制和配置系统，它让网络设备能够保持“在线可用”状态。而nmcli则让你无需启动任何图形工具，就能完成所有网络配置任务，从查看状态、连接Wi-Fi，到配置复杂的网卡绑定（Bonding）、桥接（Bridging），它都能胜任。尤其对于运维工程师，掌握nmcli意味着更高的效率和更强的可控性。今天，我就结合自己多年的踩坑经验，带你从常用操作到实战网卡绑定，彻底玩转nmcli。

2. nmcli核心概念与基础操作

在深入具体命令之前，我们必须先理解nmcli的几个核心对象，这能帮你避免很多混淆。nmcli管理的是 NetworkManager 的“对象”，主要有三类：设备（device）、连接（connection）和活动连接（active connection）。

2.1 理解设备、连接与活动连接

设备（Device）指的是物理或虚拟的网络接口硬件，比如你的有线网卡eth0、ens33，无线网卡wlan0，或者虚拟的virbr0等。你可以把它理解为网卡本身。

连接（Connection）则是一个“配置档案”。它定义了这个网络接口应该如何被配置，比如使用静态IP还是DHCP、IP地址是多少、网关、DNS是什么等。一个设备可以有多个连接配置，但同一时间只能激活其中一个。连接是持久化的，保存在/etc/sysconfig/network-scripts/（RHEL/CentOS 7）或/etc/NetworkManager/system-connections/（RHEL/CentOS 8+及Fedora等）目录下。

活动连接（Active Connection）是“设备”和“连接”结合后正在运行的实例。当一个连接被应用到某个设备上并启动后，就形成了一个活动连接。

举个例子：你的服务器有一块网卡叫ens33（设备）。你可以为它创建两个连接配置，一个叫office-static用于办公室的静态IP环境，另一个叫home-dhcp用于家里的DHCP环境。当你把office-static这个连接配置应用到ens33设备上并启动后，ens33就有了一个活动连接，其配置就是office-static里定义的内容。

注意：很多新手会直接用ip addr看到的接口名去操作nmcli，结果发现命令报错“找不到连接”。请务必记住，nmcli主要操作的是“连接”名，而不是“设备”名。你需要先知道针对某个设备有哪些连接配置。

2.2 状态查看与信息获取

查看所有网络设备的状态是第一步，也是最常用的命令。

nmcli device status

这个命令会输出一个清晰的表格，包含以下几个关键列：

• DEVICE: 设备（接口）名称。
• TYPE: 设备类型（ethernet, wifi, bridge, bond等）。
• STATE: 设备状态。connected表示已连接并激活，disconnected表示设备存在但未激活，unavailable可能表示网线没插或硬件禁用。
• CONNECTION: 当前在该设备上激活的连接名称。如果显示--，则表示该设备上没有激活任何连接。

如果你想看更详细的信息，比如某个连接的具体配置（IP、网关、DNS等），可以使用：

nmcli connection show [连接名称]

如果不加连接名称，会列出所有已保存的连接配置。加上连接名称，则会显示该连接的详细配置参数，这些参数非常多，涵盖了IPv4、IPv6、802.1x安全等各种设置。

对于无线网络，扫描和连接也是常见需求：

nmcli device wifi list # 列出可用的Wi-Fi网络 nmcli device wifi connect SSID名称 password 密码 # 连接指定Wi-Fi

2.3 连接的启停、添加与删除

掌握了信息查看，接下来就是控制连接。

启动、停止、重新加载一个连接：

nmcli connection up [连接名称] # 启动连接 nmcli connection down [连接名称] # 停止连接（注意：这会使该设备断网） nmcli connection reload # 重新加载所有连接配置文件（修改文件后常用）

停止连接 (down) 要小心使用，特别是在通过SSH远程操作时。如果停掉了你正在使用的那个连接，会话就会中断。更安全的做法是使用nmcli device disconnect [设备名]，它只断开设备，而不删除连接配置。

添加一个新的连接，比如为ens33添加一个DHCP配置：

nmcli connection add type ethernet con-name my-dhcp ifname ens33

• type ethernet: 指定连接类型为以太网。
• con-name my-dhcp: 指定连接名称为my-dhcp。
• ifname ens33: 指定这个连接配置将应用于设备ens33。

这条命令会创建一个使用DHCP自动获取IP的基本以太网连接。创建后，使用nmcli connection up my-dhcp即可激活它。

删除一个连接配置：

nmcli connection delete [连接名称]

这个操作会从磁盘上删除对应的配置文件，请确认后再执行。

2.4 连接配置的修改

动态修改连接参数是nmcli的强项，无需手动编辑配置文件。其通用格式是：

nmcli connection modify [连接名称] [参数名] [参数值]

设置静态IP地址：这是最频繁的操作之一。假设我们要将连接my-static的IPv4地址设置为192.168.1.100/24，网关为192.168.1.1，DNS服务器为8.8.8.8和114.114.114.114。

nmcli connection modify my-static ipv4.addresses 192.168.1.100/24 nmcli connection modify my-static ipv4.gateway 192.168.1.1 nmcli connection modify my-static ipv4.dns "8.8.8.8 114.114.114.114" nmcli connection modify my-static ipv4.method manual

关键点在于最后一句ipv4.method manual，它将IP获取方式从默认的auto(DHCP) 改为手动配置 (manual)。如果只设置了地址却没改method，配置可能不会生效。

启用/禁用自动连接：

nmcli connection modify my-static connection.autoconnect yes # 开机自动连接 nmcli connection modify my-static connection.autoconnect no # 开机不自动连接

修改连接名或绑定的设备：

nmcli connection modify old-name connection.id new-name # 重命名连接 nmcli connection modify my-static connection.interface-name ens34 # 更改此连接绑定的设备

修改完成后，通常需要重启连接或重启NetworkManager服务才能使更改生效：

nmcli connection down my-static && nmcli connection up my-static # 或者 systemctl restart NetworkManager

实操心得：nmcli connection modify命令的参数体系非常庞大，记不住没关系，多用Tab键补全。例如，输入nmcli connection modify my-static ipv4.后连按两次Tab，会列出所有可用的IPv4相关参数，如addresses,gateway,dns,method,routes等，非常方便。

3. 进阶实战：使用nmcli配置网卡绑定（Bonding）

网卡绑定，也叫链路聚合，是将多个物理网卡聚合成一个逻辑网卡，以实现带宽叠加、负载均衡或故障转移（高可用）。这在服务器网络配置中极为常见。nmcli使得配置绑定变得直观且不易出错。

3.1 绑定模式选择与前期准备

常见的绑定模式（mode）有：

• mode=0 (balance-rr): 轮询模式。数据包按顺序从各个网卡发送，提供负载均衡和带宽叠加，但需要交换机支持。
• mode=1 (active-backup): 主备模式。只有一个网卡活跃，其他作为备份。提供故障转移，不增加带宽。这是最常用、兼容性最好的模式。
• mode=4 (802.3ad): LACP动态链路聚合。需要交换机支持并启用LACP协议，能提供真正的带宽叠加和负载均衡，是生产环境首选（如果交换机支持）。
• mode=6 (balance-alb): 自适应负载均衡。不需要交换机特殊支持，既能接收也能发送的负载均衡。

前期准备：

1. 物理准备：确保要绑定的两块或多块物理网卡（例如ens33,ens34）已安装好，网线已连接至交换机。如果是主备模式，建议连接到同一台交换机的不同端口。
2. 清理现有配置：移除这些网卡上已有的连接配置，避免冲突。

   nmcli connection delete ens33-connection-name # 删除ens33上的旧连接 nmcli connection delete ens34-connection-name # 删除ens34上的旧连接

3. 规划IP：为即将创建的绑定接口（如bond0）规划好IP地址、子网掩码、网关等。

3.2 分步创建主备模式绑定

我们以最常用的active-backup(mode=1) 为例，创建绑定接口bond0，并为其配置静态IP。

第一步：创建绑定接口（Bond Interface）

nmcli connection add type bond con-name bond0 ifname bond0 mode active-backup

• type bond: 创建类型为bond的连接。
• con-name bond0: 连接名称。
• ifname bond0: 绑定接口的设备名。
• mode active-backup: 指定绑定模式。

执行后，会生成一个名为bond0的连接，但此时它还没有绑定任何物理网卡。

第二步：为绑定接口配置IP地址

nmcli connection modify bond0 ipv4.addresses 192.168.1.200/24 nmcli connection modify bond0 ipv4.gateway 192.168.1.1 nmcli connection modify bond0 ipv4.dns "8.8.8.8" nmcli connection modify bond0 ipv4.method manual nmcli connection modify bond0 connection.autoconnect yes

第三步：将物理网卡作为“从属接口”加入绑定现在，将ens33和ens34添加到bond0中。注意，这里是为每个物理网卡创建一个类型为bond-slave的连接。

nmcli connection add type bond-slave con-name bond0-slave-ens33 ifname ens33 master bond0 nmcli connection add type bond-slave con-name bond0-slave-ens34 ifname ens34 master bond0

• type bond-slave: 类型为绑定的从属接口。
• con-name: 从属连接的名称，建议包含主绑定名和接口名，便于管理。
• ifname: 物理网卡设备名。
• master bond0: 指定其主绑定接口为bond0。

第四步：启动绑定启动顺序很重要：先启动从属连接，最后启动主绑定连接。

nmcli connection up bond0-slave-ens33 nmcli connection up bond0-slave-ens34 nmcli connection up bond0

3.3 验证绑定状态与故障测试

配置完成后，如何验证？

1. 查看绑定接口状态：

   cat /proc/net/bonding/bond0

   这个文件提供了绑定的详细信息。在Bonding Mode部分，你会看到IEEE 802.3ad Dynamic link aggregation或Active-Backup等字样。在Slave Interface部分，可以看到ens33和ens34的状态，其中MII Status应为up，Link Failure Count应为 0。对于active-backup模式，会明确标出当前Active Slave是哪一个。

2. 使用nmcli查看：

   nmcli device status

   你应该能看到bond0的类型是bond，状态是connected。而ens33和ens34的类型会是ethernet，状态也是connected，并且它们的CONNECTION列显示的是对应的bond-slave连接名。

3. 故障转移测试（针对active-backup模式）： 这是验证高可用的关键。首先通过cat /proc/net/bonding/bond0记下当前的Active Slave（假设是ens33）。

   • 模拟故障：拔掉ens33的网线。
   • 观察切换：迅速再次执行cat /proc/net/bonding/bond0。你会发现ens33的MII Status变为down，而Active Slave已经切换到了ens34。
   • 测试连通性：使用ping命令持续ping一个网关或外网地址，在拔线瞬间，可能会丢1-3个包，随后立即恢复。这就证明故障转移成功。
   • 恢复测试：插回ens33的网线，它会作为备份链路重新上线。

注意事项：绑定配置对交换机有一定要求。对于mode=0和mode=4，交换机必须进行相应配置（如将端口加入同一个channel-group并启用LACP）。mode=1和mode=6对交换机要求较低，但为了获得最佳性能，建议将多个物理端口配置在同一个VLAN中，并关闭STP（生成树协议）或将其优先级调到最低，避免因STP阻塞端口导致绑定失效。

4. 网络配置的持久化与故障排查

4.1 配置的持久化与文件管理

使用nmcli所做的修改，默认就是持久化的。它会将连接配置写入到磁盘文件中。了解文件位置有助于手动排查或备份。

• RHEL/CentOS 7及更早版本：配置文件通常位于/etc/sysconfig/network-scripts/，文件名如ifcfg-bond0,ifcfg-bond0-slave-ens33。
• RHEL/CentOS 8、Fedora及大多数现代发行版：配置文件位于/etc/NetworkManager/system-connections/，文件名就是连接名，如bond0.nmconnection,bond0-slave-ens33.nmconnection。

这些文件是ini格式的，你可以用cat或vim查看。但强烈不建议直接手动编辑这些文件，因为nmcli能保证语法的正确性，并与NetworkManager服务的内存状态同步。手动编辑可能导致配置无法加载或服务报错。

如果需要备份网络配置，直接备份整个目录即可：

cp -r /etc/NetworkManager/system-connections/ ~/network-backup/

4.2 常见问题与排查技巧实录

即使按照步骤操作，也可能会遇到问题。下面是我总结的几个常见坑点及解决方法。

问题1：执行nmcli connection up时报错 “Connection activation failed: No suitable device found”

• 原因：这通常意味着你尝试启动的连接配置里指定的interface-name（设备名）在系统中不存在，或者该设备已经被其他连接占用了。
• 排查：
  1. 使用nmcli device status确认设备名是否正确（注意虚拟机环境网卡名可能是ens192,eth0等变体）。
  2. 使用nmcli connection show查看是否已有其他连接绑定了这个设备。一个设备同一时间只能有一个活跃连接。
  3. 检查连接配置：nmcli connection show [连接名] | grep interface-name。
• 解决：修改连接绑定的设备名：nmcli connection modify [连接名] connection.interface-name [正确的设备名]。

问题2：绑定创建成功，但Slave接口状态一直是disconnected或unavailable

• 原因：物理链路问题，或者从属连接的配置未正确关联到主绑定。
• 排查：
  1. 检查网线、交换机端口。
  2. 使用ethtool [设备名]查看物理链路状态，Link detected应为yes。
  3. 检查从属连接的配置：nmcli connection show [slave-conn-name] | grep master，确认其connection.master属性是否正确指向了你的绑定接口（如bond0）。
• 解决：确保物理链路畅通，并核对从属连接的master参数。

问题3：修改IP后，ping不通网关或外网

• 原因：网关或DNS配置错误；防火墙规则阻止；或路由表未更新。
• 排查：
  1. ip route show或route -n查看默认路由 (default via) 是否正确指向了你设置的网关IP。
  2. cat /etc/resolv.conf查看DNS配置是否生效。
  3. 使用nmcli connection show [激活的连接名] | grep -E 'ipv4.(dns|gateway|addresses)'确认配置是否正确。
  4. 临时关闭防火墙测试：systemctl stop firewalld(RHEL/CentOS) 或ufw disable(Ubuntu)，测试后记得开启。
• 解决：通过nmcli connection modify修正网关或DNS，并重启连接。检查防火墙规则。

问题4：NetworkManager服务与其他网络配置工具冲突

• 现象：配置时好时坏，重启后失效，nmcli显示的状态和ip addr显示的不一致。
• 原因：系统中可能存在其他网络配置工具（如network.service）或手动修改了/etc/network/interfaces(Debian系) ，与NetworkManager产生了冲突。
• 解决：在RHEL/CentOS 7+上，NetworkManager和network服务可以共存，但管理同一个设备时，只应由其中一个控制。建议：
  • 禁用旧的network服务：systemctl disable --now network。
  • 确保NetworkManager开机自启：systemctl enable --now NetworkManager。
  • 对于Debian/Ubuntu，如果使用NetworkManager，建议不要直接编辑/etc/network/interfaces，而是通过nmcli或图形界面管理。

问题5：如何彻底删除一个绑定配置？直接nmcli connection delete bond0只会删除主绑定连接，其对应的从属连接 (bond-slave) 仍然存在，并且可能因为autoconnect=yes而在下次启动时尝试连接一个不存在的master，导致错误。

• 正确步骤：
  1. nmcli connection down bond0
  2. nmcli connection down bond0-slave-ens33
  3. nmcli connection down bond0-slave-ens34
  4. nmcli connection delete bond0
  5. nmcli connection delete bond0-slave-ens33
  6. nmcli connection delete bond0-slave-ens34
  7. 如果需要为物理网卡重新配置普通连接，再使用nmcli connection add type ethernet ...重新创建。

掌握这些排查思路，你就能独立解决大部分nmcli配置过程中遇到的问题。网络配置本身就是一个需要细致和耐心的工作，理解其背后的逻辑比死记命令更重要。