Linux服务器KVM桥接网络不通,如何分层检查网桥、路由与虚拟机配置
KVM桥接网络不通时,先不要直接重启虚拟机或重建网桥。相同的“虚拟机无法上网”现象,可能来自物理网卡未加入桥、宿主机地址配置在错误接口、虚拟机网卡没有挂到目标网桥、网关或路由错误,也可能是上游网络限制了虚拟机的MAC地址。应先确认故障影响范围,再按“物理链路—网桥—路由与ARP—虚拟机接口—客户机系统—服务端口”的顺序缩小范围。
桥接模式的基本关系是:物理网卡作为网桥端口,宿主机的三层地址配置在br0上,虚拟机的vnetX接口也接入br0,虚拟机再使用自己的IP、网关和MAC与外部网络通信。只要其中一层配置不一致,就可能出现宿主机正常而虚拟机不通,或者宿主机和所有虚拟机同时中断。

A5数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器,可作为KVM虚拟化宿主机及业务服务的资源基础。产品覆盖Xeon、AMD EPYC等平台,并提供SSD、NVMe、大内存、多IP及不同带宽线路方案,便于结合部署地区、虚拟机负载和网络架构,构建网站、数据库、接口服务及多任务运行环境。
先确认症状和影响范围
排查前准备一个可用的带外控制台、云平台控制台或本地终端。远程修改宿主机网桥、路由和防火墙都可能导致SSH断开,尤其是把物理网卡从当前连接中移入网桥时。涉及配置修改前,先保存当前状态:
sudo ip -br addr
sudo ip route
sudo bridge link
sudo virsh domiflist VM_NAME
sudo virsh dumpxml VM_NAME > /root/VM_NAME.xml.backup
VM_NAME替换为实际虚拟机名称。以上命令主要用于读取状态;保存XML是为了在修改虚拟机接口配置前保留回退依据。
先回答四个问题:
- 宿主机自身能否访问默认网关?
- 是所有虚拟机不通,还是只有一台虚拟机不通?
- 虚拟机是完全没有网络,还是只能访问内网、不能访问外部地址?
- 是IP地址不通,还是只有DNS或某个应用端口不通?
可以用下面的现象表快速确定排查起点。表中的输出是判断示例,不代表已经在当前环境执行过。
| 现象 | 优先检查位置 | 通常意味着什么 |
|---|---|---|
| 宿主机也无法访问网关 | 物理网卡、网桥端口、宿主机地址和VLAN | 故障在虚拟机之外 |
| 宿主机正常,所有虚拟机都不通 | br0、上游MAC限制、libvirt接口定义 | 共享链路或桥接方式存在问题 |
| 宿主机正常,只有一台虚拟机不通 | 虚拟机XML、vnetX、客户机网卡和地址 | 多数是单台虚拟机配置问题 |
| 虚拟机能访问网关,不能访问外部IP | 默认路由、上游出口、地址策略或安全策略 | 二层已基本连通,继续检查三层 |
| 虚拟机能访问IP,域名打不开 | DNS配置、DNS服务可达性 | 不应继续重建网桥 |
| IP和网关均可达,业务端口不通 | 客户机防火墙、宿主机防火墙、服务监听地址 | 网络基础链路可能已经恢复 |
客户机内部检查需要通过虚拟机控制台或其他可用登录方式执行。不要因为宿主机上的virsh domifaddr没有返回地址,就直接判定虚拟机网卡故障;该命令通常依赖客户机代理、DHCP租约或邻居信息,缺少这些条件时可能没有结果。
建立原因树:把“网络不通”拆成五层
桥接网络排错可以拆成以下五个层级:
- 物理和上游网络层:物理网卡是否有链路,交换机端口或云平台是否允许该VLAN和多个MAC。
- 宿主机二层层:物理网卡是否是
br0的端口,虚拟机的vnetX是否也接入同一个桥。 - 宿主机和客户机三层层:IP、掩码、默认网关、ARP邻居和路由是否正确。
- 虚拟化服务层:虚拟机XML中的接口类型、桥名称、虚拟网卡模型是否与实际配置一致。
- 客户机和应用层:客户机接口是否启用,防火墙是否丢包,应用是否监听在可访问地址上。
这棵原因树的关键是避免跨层推断。例如,虚拟机没有DNS解析,并不能证明网桥故障;宿主机能够访问互联网,也不能证明上游网络一定允许虚拟机使用第二个MAC地址。
第一层:检查物理网卡和网桥状态
在宿主机执行:
sudo ip -br link
sudo ip -br addr
sudo bridge link
sudo ip -d link show br0
正常的示例结构可能类似于:
eno1 UP ...
br0 UP 192.0.2.10/24
vnet3 UP ...
3: eno1: ... master br0 state forwarding
8: vnet3: ... master br0 state forwarding
这里需要关注三个关系:
- 物理网卡,例如
eno1,应显示为br0的端口; - 虚拟机接口,例如
vnet3,也应显示为br0的端口; - 宿主机的IPv4地址通常应配置在
br0,而不是继续配置在eno1上。
如果eno1是br0的端口,但eno1上仍有宿主机的主要IPv4地址,可能造成ARP响应和路由选择混乱。物理网卡上存在IPv6链路本地地址并不一定是错误,判断时要结合实际启用的IPv6配置。
检查物理链路时,可以使用:
sudo ethtool eno1
重点查看Link detected: yes。如果物理链路为no,先处理网线、交换机端口、虚拟化平台的VLAN或上联状态,暂时不要修改虚拟机配置。云服务器环境中,物理端口由平台管理,ethtool显示的信息可能有限,此时应结合平台控制台的网卡状态和VLAN配置。
再查看网桥学习到的MAC地址:
sudo bridge fdb show br br0
正常情况下,应能看到物理网卡、宿主机或虚拟机相关MAC条目。vnet3存在但没有流量,说明虚拟接口可能已经挂桥,但还不能证明客户机真正发送了数据;还需结合接口计数和抓包判断。
网桥配置文件是否真正生效
不同发行版可能使用NetworkManager、systemd-networkd或Netplan管理网卡。先确认管理者,不要把一种系统的配置文件直接套到另一种系统:
systemctl --type=service --state=running | grep -E 'NetworkManager|systemd-networkd'
NetworkManager环境可查看连接关系:
sudo nmcli -f NAME,TYPE,DEVICE connection show
sudo nmcli device status
如果使用Netplan,检查配置文件内容:
sudo ls -l /etc/netplan/
sudo sed -n '1,220p' /etc/netplan/*.yaml
下面只是网桥关系的示例形状,地址、接口名和网关必须替换为真实环境,不能直接当作现网配置执行:
network:
version: 2
ethernets:
eno1: {}
bridges:
br0:
interfaces:
- eno1
addresses:
- 192.0.2.10/24
routes:
- to: default
via: 192.0.2.1
nameservers:
addresses:
- 192.0.2.53
判断重点不是文件是否存在,而是运行状态是否与文件一致。宿主机配置修改前应保留原文件,并通过带外控制台执行。Ubuntu等使用Netplan的环境,可以优先使用带回退机制的测试方式,例如netplan try;远程操作不要直接执行会立即覆盖连接的命令,除非已经准备好控制台回退路径。
第二层:确认宿主机路由和ARP
网桥只解决二层转发,宿主机和虚拟机能否找到网关,还要看IP、掩码、路由和ARP。
sudo ip addr show dev br0
sudo ip route
sudo ip route get 192.0.2.1
sudo ip neigh show dev br0
典型的宿主机路由应能看到默认路由,示例:
default via 192.0.2.1 dev br0 proto static
192.0.2.0/24 dev br0 proto kernel scope link src 192.0.2.10
如果默认路由仍然指向eno1,或者默认路由存在多个出口,宿主机可能选择错误的接口。桥接场景中,宿主机的默认路由通常指向br0,而不是桥的物理从接口。
测试宿主机到网关的连通性:
ping -c 4 -I br0 192.0.2.1
如果网关地址已知,也可以检查ARP解析:
sudo arping -I br0 -c 3 192.0.2.1
结果的判断方式如下:
ping和arping都失败:优先检查网桥端口、VLAN、IP掩码和上游链路;arping有响应但ping失败:可能是网关禁ICMP,也可能是宿主机防火墙,不要仅凭ping判定二层故障;- 能解析ARP但路由不正确:修正宿主机路由配置;
- 网关可达但外部地址不可达:继续查看默认路由、上游出口策略和防火墙。
如果宿主机能够访问网关,而虚拟机不能,下一步应转向vnetX和虚拟机配置,而不是反复修改宿主机默认路由。
第三层:确认虚拟机接口是否接入正确网桥
先查看虚拟机当前接口:
sudo virsh domiflist VM_NAME
桥接到br0的示例结果:
Interface Type Source Model MAC
------------------------------------------------
vnet3 bridge br0 virtio 52:54:00:12:34:56
如果显示类似下面的结果:
Interface Type Source Model MAC
------------------------------------------------
vnet3 network default virtio 52:54:00:12:34:56
这表示虚拟机接入的是libvirt名为default的虚拟网络,不是物理网桥br0。default通常可能是NAT网络,具体行为要以其XML定义为准:
sudo virsh net-list --all
sudo virsh net-dumpxml default
如果虚拟机本应使用桥接,却实际连接到default,原因可能是修改了运行时接口但没有写入持久配置,或者虚拟机XML中的source仍然指向旧网络。
进一步查看接口定义:
sudo virsh dumpxml VM_NAME | sed -n '/<interface /,/<\/interface>/p'
桥接接口通常包含类似内容:
<interface type='bridge'>
<mac address='52:54:00:12:34:56'/>
<source bridge='br0'/>
<model type='virtio'/>
</interface>
同时确认对应的vnet3确实存在并且连接到br0:
sudo ip link show vnet3
sudo bridge link
sudo ip -s link show vnet3
如果domiflist能看到接口,但宿主机中没有对应的vnetX,可能是虚拟机未运行、接口没有成功创建,或运行时配置和持久配置不一致。若修改过虚拟机接口,需分别检查运行配置和持久配置:
sudo virsh dumpxml VM_NAME > /tmp/VM_NAME.live.xml
sudo virsh dumpxml --inactive VM_NAME > /tmp/VM_NAME.config.xml
两份XML不一致时,重启虚拟机可能恢复旧配置。不要只验证当前运行状态,还要确认持久定义中仍然是br0。
第四层:检查上游网络是否允许桥接流量
桥接模式会让上游网络看到宿主机MAC之外的虚拟机MAC。部分云平台、托管机房或交换机端口可能只允许一个MAC,或者要求为额外MAC、VLAN、IP地址设置白名单。此时宿主机本身可以正常通信,但虚拟机发出的ARP或IP包不会被上游接受。
可以在宿主机抓取桥上的ARP和ICMP:
sudo tcpdump -ni br0 'arp or icmp'
让虚拟机执行一次访问网关的操作,再观察:
- 能看到虚拟机发出的ARP请求,但没有ARP响应:可能是网关、VLAN或上游MAC策略;
- 能看到ARP请求和响应,但后续ICMP没有返回:继续检查路由、防火墙或地址策略;
br0上没有虚拟机流量,但vnet3计数增加:重点检查网桥挂接和桥过滤规则;vnet3接收和发送计数都不变化:重点检查客户机接口是否启用,或虚拟机接口是否没有真正连接。
如果上游明确限制额外MAC,不能通过反复调整Linux网桥来解决。应根据网络提供方要求申请额外MAC、配置允许的VLAN,或者改用适合当前地址分配方式的路由型或NAT型网络。特别是只有一个可用IP地址时,不能简单地把同一个公网IP同时配置给宿主机和虚拟机,这会导致IP冲突和ARP抖动。
检查是否存在重复地址时,可在同一网段内观察邻居变化:
sudo ip neigh show dev br0
sudo tcpdump -ni br0 'arp'
如果同一个IP不断对应不同MAC,优先排查虚拟机克隆后未修改静态IP、宿主机与虚拟机重复使用地址等问题。
第五层:在客户机内部检查网卡、地址和网关
进入虚拟机后,不要假定接口名称一定是eth0。执行:
ip -br link
ip -br addr
ip route
ip route get 192.0.2.1
需要确认:
- 网卡处于
UP状态; - 网卡拥有预期的IPv4地址和掩码;
- 静态地址没有与其他主机重复;
- 默认路由指向正确网关;
- 网关与虚拟机地址处于合理的二层网段;
- DHCP模式下确实获得了租约。
测试应从近到远:
ping -c 4 192.0.2.1
ping -c 4 198.51.100.1
getent hosts example.com
这里的198.51.100.1和example.com仅用于说明测试层次,实际环境应替换为已知可达的上游IP和业务域名。测试结果可以这样理解:
- 网关不通:客户机地址、网卡、桥接或上游二层仍有问题;
- 网关通、已知外部IP不通:检查客户机默认路由、上游策略和防火墙;
- 外部IP通、域名不通:检查
/etc/resolv.conf、systemd-resolved或NetworkManager的DNS配置; - DNS和IP都通,但应用失败:进入端口和应用层排查。
如果客户机使用NetworkManager,可查看活动连接:
nmcli device status
nmcli connection show --active
nmcli device show ens3
如果使用systemd-networkd,可查看:
networkctl status
networkctl status ens3
ens3只是示例接口名,必须替换为实际名称。修改客户机静态地址前也要备份原配置;远程客户机可优先使用控制台,并选择发行版提供的带回退机制。不要在没有控制台的情况下同时修改IP、默认路由和网络管理服务。
防火墙和桥过滤规则不要被忽略
宿主机、客户机或网桥过滤规则都可能造成“接口有流量但业务不通”。先读取规则,不要第一步就停止防火墙或清空规则:
sudo nft list ruleset
sudo iptables -S
sudo firewall-cmd --state
不同系统可能只使用其中一种工具。重点观察是否存在针对以下对象的丢弃规则:
br0或vnetX接口;- 虚拟机所在的源IP或目标IP;
- ARP、IPv4转发或特定业务端口;
- ICMP、DNS、SSH或Web服务端口。
如果抓包能看到请求进入网桥,却看不到响应,防火墙是重要候选原因;如果请求和响应都经过网桥,但客户机仍不能建立连接,则要继续检查客户机内部防火墙和服务监听。
确实需要临时调整规则时,应先保存当前规则并确认影响范围:
sudo nft list ruleset > /root/nft.rules.$(date +%F-%H%M%S)
不要使用清空全部规则的方式进行“快速验证”,因为这可能同时暴露宿主机和所有虚拟机服务。临时规则应限定接口、源地址、目标端口和测试时间;验证完成后删除临时规则。若需要回滚,应在带外控制台或已确认的安全窗口内加载此前保存的规则,并核对恢复后SSH、网关和虚拟机业务是否正常。
从网络连通转向应用端口检查
当虚拟机能够访问网关、外部IP和DNS时,网络基础层通常已经通过。此时检查应用是否监听在正确地址:
sudo ss -lntup
sudo ss -lntup | grep ':80\|:443\|:22'
如果服务只监听在127.0.0.1,宿主机或其他网络设备无法直接访问;如果服务监听在正确的虚拟机地址或0.0.0.0,再检查客户机防火墙和宿主机侧策略。
从宿主机或同网段测试端口:
nc -vz 192.0.2.20 80
curl -v --connect-timeout 5 http://192.0.2.20/
端口连接失败不等于网桥故障。只有在IP层和ARP层也失败时,才应继续回到网桥和路由分支。
按结果定位根因
经过上述检查后,常见根因通常可以归到以下几类:
| 最后一个成功点 | 最可能的根因 | 下一步动作 |
|---|---|---|
| 物理网卡无链路 | 交换机、VLAN、云平台网卡或上联故障 | 先恢复链路,不修改虚拟机 |
br0未运行或没有物理端口 | 网桥配置未生效、接口名错误、网络管理器冲突 | 核对配置管理者和网桥成员 |
| 宿主机网关不通 | 宿主机IP、掩码、默认路由、ARP或上游故障 | 先修复宿主机三层连通 |
| 宿主机正常,所有虚拟机都不通 | 所有虚拟机接错网络、上游限制多个MAC、桥过滤 | 对照domiflist和抓包结果 |
| 只有一台虚拟机不通 | XML中的桥名、vnetX、客户机接口或静态地址错误 | 对比正常虚拟机配置 |
| 虚拟机网关可达,外部IP不通 | 默认路由、出口策略或防火墙 | 检查客户机和上游三层规则 |
| IP可达,域名不通 | DNS配置或DNS访问被拦截 | 单独修复解析配置 |
| IP和端口均可达,业务仍失败 | 应用监听地址、虚拟主机或应用自身错误 | 查看应用日志和监听配置 |
这种定位方式比“重启libvirt”或“重建网桥”更安全。重启网络服务可能让所有虚拟机同时断线,只有在确认服务状态异常且具备控制台、配置备份和回退方案时才适合执行。
恢复后的验证与复发监控
故障修复后,至少完成一次从宿主机到客户机的完整验证:
sudo ip -br addr
sudo ip route
sudo bridge link
sudo virsh domiflist VM_NAME
sudo ip -s link show br0
sudo ip -s link show vnet3
随后在客户机执行:
ip -br addr
ip route
ping -c 4 GATEWAY_IP
ping -c 4 KNOWN_EXTERNAL_IP
getent hosts SERVICE_DOMAIN
最后从实际访问端测试业务端口,而不是只看ping。如果问题涉及重启后丢失,安排维护窗口重启一台非关键虚拟机或使用带外控制台验证持久性,重点确认:
- 重启宿主机后,物理网卡仍自动加入
br0; - 宿主机地址和默认路由仍在
br0; - 虚拟机持久XML仍引用正确的桥;
vnetX重新创建后仍能加入br0;- 客户机静态地址、默认路由和DNS没有被初始化服务覆盖。
日常监控可以围绕几个容易复发的点设置告警:物理端口或br0变为DOWN、网桥端口数量异常、虚拟机接口长期只有发送没有接收、默认网关连续不可达、ARP邻居频繁变化、虚拟机网络服务反复重启,以及关键业务端口连接失败。这样下一次出现“虚拟机网络不通”时,可以直接根据告警判断是链路、网桥、上游策略还是单台客户机配置,而不必从所有层级重新盲目排查。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4839.html



