Skip to content
Search AlmaLinux

This page uses Chinese content. Search opens the Chinese documentation.

    Browse this documentation

    AlmaLinux 10 KVM 网桥:NAT 还是桥接,怎么建、怎么接

    This content is not available in your language yet.

    本页做的是 KVM 虚拟机网络竖切:为什么需要网桥、网桥怎么建、VM 网卡怎么接上去。KVM 本身的安装与基本使用见 virt-kvm。三路取证,三个视角互相咬合:

    视角环境做了什么日志
    VM 内x86_64 实机 VM 301(AlmaLinux 10.2,PVE 上)网桥创建/启用/删除、brctl 缺席检查plans/content-expansion/evidence/logs/alma-p3-vm-network.log
    宿主机PVE(pve-manager/9.2.2,只读采集)网桥与 tap 设备视图、qm config 网卡声明、持久化配置文件plans/content-expansion/evidence/logs/alma-kvm-bridge-network.log(pve-1..5)
    工具链almalinux:10 容器(aarch64,--cap-add NET_ADMIN)libvirt 安装与 virsh 采样、网桥全生命周期实验(创建→挂接→解挂→删除)同上(step1..10)

    容器实验特意做了完整的生命周期闭环:建桥、看桥、挂网口、看成员、解挂、删桥,每一步都有输出留痕。没有实测的:VM 桥接后的真实网络通信、libvirt XML 配置的启动验证、virbr0 运行态、NM 持久化建桥——逐项列在未验证事项。

    VM 的网卡要连到哪,本质是两个问题:流量从哪出去、外部能不能主动进来。libvirt 文档(formatnetwork)口径下有四类常见形态:

    模式桥设备VM 的位置外部可达性适合
    NAT(libvirt 默认网络)virbr0(192.168.122.0/24 + DHCP)宿主后的私网,出站经宿主 NAT出站可以,入站默认全部禁止笔记本/桌面实验、临时 VM
    routevirbr1 等(virbr 前缀自动生成)宿主路由的独立网段要上游路由器有回程路由有网段规划的服务器
    bridge(挂既有宿主网桥)宿主网桥(如 PVE 的 vmbr0、自建 br0)与宿主同网段,等于插在局域网上与物理机等同服务器上对外提供服务的 VM
    isolatedvirbrN(无 forward)纯内网不可达隔离测试网

    选型口诀:VM 要被局域网其他机器直接访问,就必须桥接;只是自己用、能上网就行,NAT 最省事。NAT 网络是「libvirt 替你建的私网 + 转发规则」,桥接是「你自己建(或发行版装好)的真网桥,libvirt/PVE 只负责把 VM 的虚拟网线插上去」——这也是为什么本页的实测重心在网桥本身。容器(NAT 的一种变体)与网桥的网络排查手法见 网络排查。

    宿主机网桥创建与网口挂接(实测)

    Section titled “宿主机网桥创建与网口挂接(实测)”

    四个动作,VM 301(x86_64)与容器(br-test)双环境实测同形:

    Terminal window
    ip link add br-demo type bridge # 创建(输出 bridge-created)
    ip link set br-demo up # 启用
    ip -br addr show br-demo # 查看
    ip link del br-demo # 删除(清理)

    实测要点(日志:VM 301 == bridge-create;容器 step5-6):

    • 刚建好的空桥显示 UNKNOWN + 一个 fe80:: link-local 地址。UNKNOWN 不是故障——没有成员端口、没有载波概念,网桥就处于这个状态;link-local 是内核给网桥自动配的 IPv6 地址。
    • ip -d link show br-test 才能看到网桥专有属性:实测 bridge forward_delay 1500 hello_time 200 max_age 2000 ageing_time 30000 stp_state 0 priority 32768 vlan_filtering 0。普通 ip link show 看不到这些;默认 STP 关闭(stp_state 0)、不启用 VLAN 过滤。
    • 挂接:ip link set eth0 master br-test,返回码 0。成员视图用 bridge link show——实测输出 eth0@if2406 … master br-test state forwarding priority 32 cost 2,这就是 brctl show 的 iproute2 对等物。解挂是 ip link set eth0 nomaster。

    一个值得单独说明的实测结果:裸内核态下,enslave 之后原 IP 仍留在物理口上(容器实测:eth0 的 172.17.0.13/16 在挂接前后、解挂之后全程都在,路由表也没动)。网上流传的「挂桥就丢 IP」其实是网络配置管理层(NetworkManager)的行为——NM 把物理口连接切换成 bridge-slave 连接时会停用原连接、释放 IP,需要把 IP 配置迁移到网桥连接上。两层行为在常见坑里分开讲。

    PVE 视角:vmbr 与 VM 网卡(实测 qm config)

    Section titled “PVE 视角:vmbr 与 VM 网卡(实测 qm config)”

    生产宿主机上的网桥长什么样?PVE 宿主机(只读采集,日志 pve-1..pve-5)给出了完整的参照:

    • ip link 视角:物理口 nic0 master vmbr0(已挂桥);vmbr0、vmbr2 两座桥都 UP;VM 301 的 tap 设备 tap301i0 master vmbr2。PVE 还会为开启防火墙的 VM 自动生成 fwbr/fwpr/fwln 防火桥对(实测可见 fwbr103i0 一组)。
    • qm config 301 | grep net 的声明视角:net0: virtio=BC:24:11:FF:F4:3B,bridge=vmbr2。三方对应关系可以逐位核对:VM 301 内部 ip -br addr 的 fe80::be24:11ff:feff:f43b 正是由这个 MAC 做 EUI-64 推导(首字节 BC 翻转 U/L 位成 BE,中间插入 ff:fe)——**声明(qm)、宿主(tap301i0→vmbr2)、VM 内(link-local)**三方能对上,这就是「VM 网卡桥接到哪个 vmbr」的完整证据链。
    • brctl show 视角:PVE 宿主机自带 bridge-utils(注意:是宿主自己的老栈,EL10 客户机里没有,见下节),实测列出 vmbr0(成员 nic0、tap100i0、tap330i0、veth101i0、fwpr103p0)与 vmbr2(成员 tap301i0、tap400i0)——一台真正在跑的宿主机上,网桥成员表里混着物理口、VM 的 tap、容器的 veth 和防火桥端口。
    • 持久化视角(/etc/network/interfaces 实测,ifupdown2 语法):
    iface nic0 inet manual # 物理口:无 IP
    auto vmbr0
    iface vmbr0 inet static
    address 192.168.50.2/24 # IP 在网桥上
    gateway 192.168.50.1
    bridge-ports nic0 # 物理口挂进来
    bridge-stp off
    bridge-fd 0
    auto vmbr2
    iface vmbr2 inet static
    address 192.168.2.2/24
    bridge-ports none # 不挂物理口:仅内部/专用桥(VM 301 所在)

    这就是「IP 迁到网桥」在生产机上的标准形态:物理口 manual(无 IP),网桥 static(带 IP 和网关)。libvirt 侧等价的口径是网络 XML 的 <forward mode='bridge'/><bridge name='…'/>——声明「这是 libvirt 之外配好的宿主网桥,libvirt 不管理它、不附加任何防火墙规则或 IP/DHCP 服务」(formatnetwork 文档口径,本环境未实测启动)。

    libvirt 默认网桥 virbr0(工具链实测)

    Section titled “libvirt 默认网桥 virbr0(工具链实测)”

    virbr0 不是你建的,是 libvirt 默认 NAT 网络的桥设备。容器里把 libvirt 工具链装起来验证(日志 step1-3):

    Terminal window
    dnf install -y libvirt
    rpm -q libvirt # libvirt-11.10.0-12.9.el10_2.alma.1(容器实测)
    virsh --version # 11.10.0
    virsh help # 分组命令列表(Domain Management / Networking …)正常输出
    virsh net-list --all # 无 libvirtd 时报错 ↓

    无守护进程时 virsh net-list --all 报 error: failed to connect to the hypervisor(cannot identify any listening daemon socket path)——「工具在、守护进程不在」的典型报错形态,排查时看到它先查 libvirtd/virtqemud 服务而不是怀疑 virsh 安装。容器里没有 KVM,本页只用 virsh 做 CLI 采样,不实测守护进程行为。

    按 libvirt formatnetwork 文档口径(本环境未实测运行态):

    • default 网络:virbr0 + forward mode=nat + 192.168.122.1/24 + DHCP 池,所有 libvirt 安装开箱即启用;VM 出站经宿主 NAT,外部入站默认全部禁止。
    • nat/route/open/isolated 这四类网络自动生成的桥名都以 virbr 为前缀;你自建的网桥(br0/vmbr)与 virbr0 是两个世界——libvirt 对 forward mode='bridge' 的既有宿主网桥完全不管:不加 iptables 规则、不配 IP、不提供 DHCP/DNS。
    • firewalld 关系(文献口径):nat/route/open/isolated 网络的桥默认被放进 firewalld 的 libvirt zone(放行 guest 对宿主的 DNS/DHCP/TFTP/SSH),since libvirt 5.1.0;桥上流量经宿主转发的 NAT 规则也由 libvirt 生成。自建桥不进这个 zone——它是普通 L2 网桥,宿主防火墙如何对待桥上流量取决于你的 firewalld 策略(zones 体系见 firewalld)。

    一句话分工:virbr0 管「NAT 出去」,宿主网桥管「直接在线」。VM 要局域网可达就接宿主网桥;接错到 virbr0 的话,外部永远 ping 不进来。

    EL10 无 brctl(实测 + iproute2 替代命令)

    Section titled “EL10 无 brctl(实测 + iproute2 替代命令)”

    旧教程的第一个坑在这里:brctl 没了。双环境实测:

    Terminal window
    which brctl # VM 301 实机:不存在(日志 == brctl-avail)
    command -v brctl # 容器:不存在(日志 step4)
    dnf list bridge-utils # Error: No matching Packages to list——EL10 仓库无此包

    连带一个包名澄清(日志 step4 与补采 step10):rpm -q iproute2 会报 not installed,别以为 iproute2 工具没装——EL 的包名是 iproute(实测 iproute-6.17.0-2.el10 同时提供 /usr/sbin/ip 与 /usr/sbin/bridge),ip -V 报的 iproute2-6.17.0 是上游项目的叫法。顺带一提:almalinux:10 基础容器镜像连 ip 命令都没有(step10 实测),要 dnf install iproute;完整安装的 AlmaLinux 10 系统自带。

    brctl → iproute2 对照(实测行打勾,口径行标注):

    旧命令(brctl)iproute2 替代状态
    brctl addbr br0ip link add br0 type bridge✅ 实测
    brctl delbr br0ip link del br0✅ 实测
    brctl addif br0 eth0ip link set eth0 master br0✅ 实测
    brctl delif br0 eth0ip link set eth0 nomaster✅ 实测
    brctl show(成员表)bridge link show / ip -d link show br0✅ 实测(前者列成员状态,后者列桥参数)
    brctl stp br0 onip link set br0 type bridge stp_state 1口径,未实测
    brctl showmacs br0bridge fdb show br br0口径,未实测

    宿主机与客户机要分开看:PVE 宿主机有 brctl(它自己的 ifupdown2/bridge-utils 栈,实测可用),EL10 客户机没有——在宿主机上验证过的命令不能原样搬进 AlmaLinux 10 虚拟机的教程里。

    坑 1:挂桥断网/断 SSH——两层行为要分清。 裸内核层(实测):ip link set eth0 master br0 不会动 IP,地址还在物理口上。真正丢 IP 的是 NetworkManager 管理层(文档口径,未实测):把物理口连接变成 bridge-slave 时 NM 停用原连接、DHCP 租约释放,IP 随之消失——远程操作到这一步 SSH 就断了。规范顺序(NM 文档口径):先 nmcli con add type bridge 建网桥连接并把 IP 配置放在它身上,再把物理口加为 bridge-slave 连接,让 IP 从物理口连接迁移到网桥连接;PVE 生产配置(实测读取)就是这个形态的注脚——nic0 manual、vmbr0 static。改动前用带外手段(控制台/IPMI)兜底。

    坑 2:UNKNOWN 不是故障。 空桥、无成员端口时 ip -br addr 显示 UNKNOWN(VM 301 与容器双实测同形);挂上成员后才会变 UP(容器实测挂接后 br-test 转为 UP)。排障时别对着 UNKNOWN 空忙。

    坑 3:临时命令不持久。 本页所有 ip link 实验重启即失(实验后清理也证明了命令可逆:nomaster + del,实测清理干净、IP 完好)。持久化按管理者走三条路:EL10 客户机用 NM 的 bridge/bridge-slave 连接(nmcli con add type bridge / type bridge-slave,文档口径未实测);PVE 宿主机用 /etc/network/interfaces(实测样例见上节);libvirt 的 NAT 网络由 libvirtd 管理(virsh net-define/net-autostart 口径,未实测)。

    坑 4:接错桥。 virbr0(NAT)与宿主网桥(vmbr/br0)是两种网络形态;「VM 在局域网不可达」的排查第一步就是确认接的是哪座桥——PVE 用 qm config id | grep net 一眼看声明(实测见上节),libvirt 用 virsh domifaddr/域 XML 口径。网桥成员层面的对照用 bridge link show。

    坑 5:实验要闭环。 容器/VM 里建桥实验结束记得 nomaster + del(实测清理输出 bridge-deleted、IP 未失);把 br-test 留在系统里,NM 或持久化工具下次激活时可能试图接管它,留下难查的幽灵设备。

    • VM 内真实网络通信验证:桥接完成后跨主机互通、外部机器主动访问 VM、DHCP 从局域网获取地址——本页只到「桥设备创建与挂接声明」层,未做端到端连通实测;
    • libvirt 完整 XML 配置的启动验证:virsh net-define 一个 forward mode='bridge' 网络、域 XML <interface type='bridge'> 挂桥启动——容器无 libvirtd/KVM,virsh 只做了 CLI 采样;
    • virbr0 运行态:libvirtd 启动后 default 网络的 virbr0 创建、192.168.122.0/24 地址与 DHCP、firewalld libvirt zone 的实际规则生成——全部为 formatnetwork 文档口径;
    • NM 持久化建桥:nmcli con add type bridge/type bridge-slave 的命令行为、IP 迁移时的断线时长与 SSH 断连——文档口径,未实测;
    • STP 与多桥拓扑:stp_state 1、bridge link 的 cost/priority 调整、多网桥冗余——未实测;
    • 架构差异:容器会话为 aarch64(本机 docker),实机侧(VM 301、PVE)为 x86_64;x86_64 容器的 iproute2/libvirt 版本行为未另行采样。