解决银河麒麟系统板载 Realtek RTL8168H 网卡无法识别问题(更换主板无效)
记录一次在银河麒麟(KylinOS)系统下,板载网卡无法使用、更换主板后故障依旧,最终通过更换官方网卡驱动解决的完整排查过程。
一、故障现象
- 客户设备:搭载银河麒麟系统的国产台式机/工控机
- 故障表现:板载网卡无法联网,更换同型号主板后问题依旧
- 临时方案:客户外接了一块 USB 网卡(CH9100 芯片),并通过该网卡进行远程连接
- 核心诉求:排查并修复板载网卡,使其恢复正常使用
二、排查过程
1. 检查硬件识别情况
通过 SSH 远程登录后,首先使用 lspci 查看板载网卡是否被系统识别:
lspci -nnk | grep -iA5 ethernet
输出显示板载网卡为 Realtek RTL8168H(PCI ID: 10ec:8168,Rev: 2b)。但关键问题是:Kernel driver in use 一栏为空,说明系统没有成功加载任何驱动来接管这块网卡。
2. 分析内核日志
接着查看内核日志,寻找驱动加载失败的原因:
dmesg -T | grep -iE "r8169|eth|enp|firmware|phy"
日志中出现了明确的报错信息:
r8169 0000:04:00.0: unknown chip XID 6c0
同时伴随 can't disable ASPM; OS doesn't have ASPM control 的警告。这表明:系统自带的开源 r8169 驱动版本过旧,无法识别 RTL8168H 这款较新的芯片,因此拒绝绑定硬件。
三、解决方案:安装官方 r8168 驱动
既然内核自带的 r8169 不兼容,解决思路就是:拉黑旧驱动,安装 Realtek 官方闭源 r8168 驱动。
步骤 1:安装编译依赖与驱动包
利用当前可用的 USB 网卡连接互联网,安装必要的编译工具和驱动源码(DKMS 方式):
sudo apt update
sudo apt install -y build-essential dkms r8168-dkms linux-headers-$(uname -r)
注:如果软件源中找不到 r8168-dkms,需前往 Realtek 官网下载最新版源码手动编译,或配置对应的麒麟系统软件源。
步骤 2:拉黑旧驱动 r8169
echo "blacklist r8169" | sudo tee /etc/modprobe.d/blacklist-r8169.conf
echo "install r8169 /bin/false" | sudo tee -a /etc/modprobe.d/blacklist-r8169.conf
步骤 3:卸载旧驱动并加载新驱动
sudo modprobe -r r8169
sudo modprobe r8168
加载后通过 dmesg 确认,此时应看到 r8168 8.048.00-NAPI loaded 的日志,说明官方驱动已成功载入内核。
步骤 4:手动绑定驱动(如接口未自动生成)
部分主板上,驱动加载后不会自动绑定网卡设备,需手动触发:
sudo sh -c 'echo "0000:04:00.0" > /sys/bus/pci/drivers/r8168/bind'
步骤 5:激活网卡接口
驱动绑定成功后,使用 ip -br link 查看,会发现板载网卡以 eno1 的名字出现了(eno 代表板载以太网,这是 Linux 可预测网卡命名规则)。
sudo ip link set eno1 up
sudo dhclient -v eno1
至此,板载网卡成功获取 IP 地址,网络恢复正常。
四、BIOS 设置建议(重要)
由于客户“更换主板后故障依旧”,说明这并非单块主板的硬件损坏,而是该批次国产主板与 Linux 系统的通用兼容性问题。建议让客户在本地进入 BIOS 进行以下调整,以杜绝后续隐患:
- Load Optimized Defaults:恢复 BIOS 优化默认设置,确保板载网卡不被禁用。
- Onboard LAN:确认设置为
Enabled。 - PCIE ASPM:找到 PCIe 主动状态电源管理选项,将其关闭(Disabled)。这能解决内核中
can't disable ASPM的警告,防止网卡因节能机制进入休眠而导致断流。
五、总结
本次故障的根本原因是:银河麒麟系统内核自带的 r8169 开源驱动版本较老,无法识别客户主板上较新的 Realtek RTL8168H 网卡芯片(XID 6c0)。更换主板无效是因为同型号主板的 BIOS/ACPI 固件存在相同的默认配置。
最终解决方案:通过安装 Realtek 官方 r8168 驱动并拉黑 r8169,成功让板载网卡以 eno1 接口名正常工作。同时配合 BIOS 中关闭 ASPM 电源管理,确保网络长期稳定。
技术标签:银河麒麟 | KylinOS | Realtek RTL8168 | r8169 | r8168 | 网卡驱动 | Linux 运维 | ASPM












暂无评论内容