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 持久化建桥——逐项列在未验证事项。
KVM 网络:NAT vs 桥接
Section titled “KVM 网络:NAT vs 桥接”VM 的网卡要连到哪,本质是两个问题:流量从哪出去、外部能不能主动进来。libvirt 文档(formatnetwork)口径下有四类常见形态:
| 模式 | 桥设备 | VM 的位置 | 外部可达性 | 适合 |
|---|---|---|---|---|
| NAT(libvirt 默认网络) | virbr0(192.168.122.0/24 + DHCP) | 宿主后的私网,出站经宿主 NAT | 出站可以,入站默认全部禁止 | 笔记本/桌面实验、临时 VM |
| route | virbr1 等(virbr 前缀自动生成) | 宿主路由的独立网段 | 要上游路由器有回程路由 | 有网段规划的服务器 |
| bridge(挂既有宿主网桥) | 宿主网桥(如 PVE 的 vmbr0、自建 br0) | 与宿主同网段,等于插在局域网上 | 与物理机等同 | 服务器上对外提供服务的 VM |
| isolated | virbrN(无 forward) | 纯内网 | 不可达 | 隔离测试网 |
选型口诀:VM 要被局域网其他机器直接访问,就必须桥接;只是自己用、能上网就行,NAT 最省事。NAT 网络是「libvirt 替你建的私网 + 转发规则」,桥接是「你自己建(或发行版装好)的真网桥,libvirt/PVE 只负责把 VM 的虚拟网线插上去」——这也是为什么本页的实测重心在网桥本身。容器(NAT 的一种变体)与网桥的网络排查手法见 网络排查。
宿主机网桥创建与网口挂接(实测)
Section titled “宿主机网桥创建与网口挂接(实测)”四个动作,VM 301(x86_64)与容器(br-test)双环境实测同形:
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视角:物理口nic0master vmbr0(已挂桥);vmbr0、vmbr2两座桥都 UP;VM 301 的 tap 设备tap301i0master 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 vmbr0iface 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 vmbr2iface 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):
dnf install -y libvirtrpm -q libvirt # libvirt-11.10.0-12.9.el10_2.alma.1(容器实测)virsh --version # 11.10.0virsh 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 没了。双环境实测:
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 br0 | ip link add br0 type bridge | ✅ 实测 |
brctl delbr br0 | ip link del br0 | ✅ 实测 |
brctl addif br0 eth0 | ip link set eth0 master br0 | ✅ 实测 |
brctl delif br0 eth0 | ip link set eth0 nomaster | ✅ 实测 |
brctl show(成员表) | bridge link show / ip -d link show br0 | ✅ 实测(前者列成员状态,后者列桥参数) |
brctl stp br0 on | ip link set br0 type bridge stp_state 1 | 口径,未实测 |
brctl showmacs br0 | bridge fdb show br br0 | 口径,未实测 |
宿主机与客户机要分开看:PVE 宿主机有 brctl(它自己的 ifupdown2/bridge-utils 栈,实测可用),EL10 客户机没有——在宿主机上验证过的命令不能原样搬进 AlmaLinux 10 虚拟机的教程里。
常见坑与持久化
Section titled “常见坑与持久化”坑 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 版本行为未另行采样。