提示：此网卡linux6.11内核开始包含驱动，因此图方便也可以直接安装24.04

适用机型：MSI MAG B850M MORTAR WIFI
适用系统：Ubuntu 22.04.2
主要问题：系统安装后无以太网或 Wi-Fi 驱动
实测网卡型号：Realtek RTL8126 5 G Ethernet（PCI ID 10ec:8126）

---

🧠 问题背景

安装 Ubuntu 22.04 或 22.04.2 后，执行

ip a

发现只有 lo （本地回环接口），系统无法识别主板自带 LAN。
查看设备：

lspci -nnk | grep -A3 8126

输出：

Ethernet controller [0200]: Realtek Semiconductor Co., Ltd. Device [10ec:8126]

Ubuntu 22.04 默认内核 5.15 / 5.19 太旧，没有 RTL8126 驱动支持。
要么升级内核到 6.8 HWE，要么手动安装 Realtek 官方驱动。

---

🚀 最终可行方案概览

步骤	操作	说明
①	升级 Ubuntu HWE 内核到 6.8	提供新接口支持
②	安装 Realtek 官方 RTL8126 驱动	核心步骤
③	关闭 Secure Boot	否则驱动无法加载
④	验证驱动加载成功	确认 r8126 生效

---

① 升级内核到 6.8 （必做）

Ubuntu 22.04.2 最高可用 HWE 内核 6.8。
执行以下命令：

sudo apt update
sudo apt install --install-recommends linux-generic-hwe-22.04 -y
sudo reboot

重启后验证：

uname -r

若输出 6.8.x-xx-generic 即升级成功。
这一步非常重要，否则 Realtek 驱动编译会失败。

---

② 安装 Realtek 官方 RTL8126 驱动

1. 打开 Realtek 官网：
   🔗 https://www.realtek.com/Download/List?cate_id=584
2. 下载最新的 RTL8126 Linux driver（例如 r8126-10.016.00.tar.gz）
3. 解压并执行安装脚本： cd ~/Downloads tar -xvf r8126-*.tar.gz cd r8126-* sudo bash ./autorun.sh
4. 完成后重启： sudo reboot

---

③ 关闭 Secure Boot

若主板开启 Secure Boot，内核将拒绝加载 r8126 模块。
进入 BIOS 设置：

Settings → Security → Secure Boot → Disabled

保存退出，重新启动系统。

---

④ 验证驱动加载成功

回到系统执行：

lspci -nnk | grep -A3 8126

若看到：

Kernel driver in use: r8126

说明驱动已加载。
再查看接口：

ip a

应出现 enpXs0 等网卡名称，测试网络：

ping -c 4 1.1.1.1

---

📡 Wi-Fi 补充（未验证）

该主板 Wi-Fi 为 Qualcomm FastConnect 6900 (QCNFA765)，需 ath11k_pci 驱动。

安装方法：

sudo apt update
sudo apt install -y linux-firmware
sudo reboot

若仍未识别，可手动补齐固件：

sudo mkdir -p /lib/firmware/ath11k/WCN6855/hw2.1
cd /lib/firmware/ath11k/WCN6855/hw2.1
sudo wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/ath11k/WCN6855/hw2.1/board-2.bin
sudo wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/ath11k/WCN6855/hw2.1/firmware-2.bin
sudo update-initramfs -u
sudo reboot

---

✅ 总结

项目	状态
芯片	Realtek RTL8126 5 G Ethernet
内核版本	Ubuntu 22.04.2 HWE 6.8
驱动来源	Realtek 官方 r8126
是否需 Secure Boot 关闭	✅ 是
Wi-Fi 芯片	Qualcomm FastConnect 6900 (QCNFA765)
Wi-Fi 驱动	ath11k_pci + linux-firmware

---

🏁 结论

在 Ubuntu 22.04.2 上，MSI B850M 迫击炮 WIFI 主板的 RTL8126 5 G LAN 无法被默认识别。
需要先 升级内核到 6.8 HWE，再从 Realtek 官网下载并执行 autorun.sh 安装驱动，
最后关闭 Secure Boot。