解决银河麒麟系统板载 Realtek RTL8168H 网卡无法识别问题(更换主板无效)

AI智能摘要
板载 Realtek RTL8168H 网卡在银河麒麟下无法联网,换同型号主板仍无效。排查发现系统自带 r8169 驱动版本过旧,报错 unknown chip XID 6c0,未能接管网卡。解决靠拉黑 r8169、安装官方 r8168 驱动,必要时手动绑定 PCI 设备,让接口以 eno1 出现,并关闭 BIOS 中的 ASPM。
— 此摘要由AI分析文章内容生成,仅供参考。

解决银河麒麟系统板载 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

© 版权声明
THE END
喜欢就支持一下吧
点赞184赞赏 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容