Linux服务器网卡驱动安装排错全流程

根据社区运维反馈统计，超过60%的Linux服务器网卡故障并非硬件问题，而是驱动安装或配置不当所致。其中，驱动版本与内核不匹配占比约35%，内核模块未正确加载占比约20%，PCIe链路协商异常占比约15%。这意味着，掌握一套系统化的驱动安装与排错方法，可以解决绝大多数网卡"不认卡""不通网"的问题。

本文以联瑞电子（LR-LINK）旗下多款服务器网卡为例，从环境检查、驱动安装、常见排错到性能调优，完整梳理Linux环境下的网卡驱动部署全流程。涉及的产品包括基于Intel E610主控的 LRES1060PT-RJ45 万兆电口网卡、基于Intel芯片方案的 LRES1004PF-2SFP 双口SFP+万兆网卡、基于Intel XL710主控的 LRES3042PF-OCP OCP 3.0网卡，以及 LRES1001PF-2SFP28 25G SFP28网卡等。

第一步——确认网卡硬件状态

在安装驱动之前，首先要确认系统能够识别到网卡硬件。使用以下命令查看PCIe设备列表：

lspci | grep -i ethernet

正常输出示例：

03:00.0 Ethernet controller: Intel Corporation Device 1593 (rev 02)
03:00.1 Ethernet controller: Intel Corporation Device 1593 (rev 02)

如果 lspci 输出中看不到网卡设备，需要检查物理安装是否到位，包括金手指是否完全插入PCIe插槽、辅助供电是否连接等。

确认硬件可见后，进一步查看当前已加载的驱动信息：

ethtool -i eth1

输出示例：

driver: ice
version: 1.12.6
firmware-version: 4.30 0x8001a5c0 1.3341.0

如果返回 Cannot get driver information，说明内核尚未为该设备绑定驱动。

第二步——安装或更新驱动程序

Linux下常见的Intel网卡驱动模块包括 igb（千兆）、ixgbe（万兆电口）、i40e（XL710系列）和 ice（E810/E830系列）。大多数发行版的内核已内置这些驱动的基础版本，但生产环境通常建议安装官方最新版本以获得完整的性能和功能支持。

安装内核自带驱动

对于Ubuntu/Debian系统：

sudo apt update
sudo apt install linux-modules-extra-$(uname -r)

对于CentOS/RHEL系统：

sudo yum install kernel-devel kernel-headers

从源码编译安装最新驱动

当内核自带驱动版本过旧或不支持新硬件时，需要手动编译安装：

tar -xzf ice-1.14.9.tar.gz
cd ice-1.14.9/src
make install
modprobe -r ice && modprobe ice

编译完成后，使用 modinfo ice 确认加载的驱动版本与编译版本一致。

设置驱动开机自动加载

编辑 /etc/modules-load.d/ 目录下的配置文件，确保驱动模块在系统启动时自动加载：

echo "ice" | sudo tee /etc/modules-load.d/ice.conf

对于使用 i40e 驱动的 LRES3042PF-OCP 等OCP网卡，将上述 ice 替换为 i40e 即可。

第三步——安装后验证

驱动加载成功后，需要验证网口是否正常工作。

ip link set eth1 up
ip addr show eth1
ethtool eth1

在 ethtool 输出中，重点确认以下字段：

• Link detected: yes 表示物理链路已建立
• Speed 与实际网卡速率一致（如10000Mb/s）
• Duplex: Full 表示全双工模式

使用 iperf3 进行带宽测试，验证吞吐能力：

# 服务端
iperf3 -s

# 客户端
iperf3 -c 192.168.1.100 -t 30 -P 4

常见安装错误与排错方案

问题一——驱动模块找不到（modprobe报错）

modprobe: FATAL: Module ice not found in directory /lib/modules/5.15.0-91-generic

原因：驱动未编译或内核版本与模块目录不匹配。解决：确认已安装 linux-headers-$(uname -r)，重新执行 make install，然后运行 depmod -a 更新模块依赖。

问题二——固件版本不匹配

dmesg 中出现如下日志：

ice 0000:03:00.0: The NVM image is incompatible with the PHY configuration

原因：网卡的NVM固件版本过旧，不支持当前驱动。解决：联系联瑞电子获取对应型号的NVM固件升级包，使用 ethtool -f eth1 firmware.bin 进行固件更新。

问题三——PCIe链路带宽协商不足

lspci -vv | grep -A5 "Ethernet"

输出中若显示 LnkSta: Speed 2.5GT/s, Width x4 而网卡标称为PCIe 3.0 x8，说明链路未协商到满速。原因：主板PCIe插槽规格不足或BIOS中设置了限速。解决：更换至PCIe x8或x16物理插槽，并在BIOS中确认对应插槽的Gen设置为Gen3或Auto。

问题四——网口UP后立即DOWN

ip link set eth1 up
# 几秒后自动DOWN

原因：通常是光模块兼容性问题或未正确插入。解决：确认使用的光模块与网卡兼容，重新插拔光模块并确保卡扣到位。对于 LRES1004PF-2SFP 等SFP+接口网卡，建议使用经过兼容性测试的光模块。

问题五——多队列RSS未生效

ethtool -l eth1

输出显示所有流量集中在一个队列。原因：驱动加载时未正确初始化多队列，或RSS（Receive Side Scaling）未启用。解决：通过 ethtool -L eth1 combined 8 手动设置队列数，队列数建议设为CPU核心数的一半或网卡支持的上限（取较小者）。

问题六——内核升级后驱动失效

系统执行 apt upgrade 或 yum update 后网卡驱动丢失。原因：内核升级后新内核缺少对应的驱动模块。解决：安装DKMS（Dynamic Kernel Module Support），使驱动在内核更新时自动重新编译：

sudo apt install dkms
sudo dkms install ice/1.14.9

性能调优建议

驱动安装完成并验证连通后，针对服务器高吞吐场景，建议进行以下调优。

调整Ring Buffer大小

ethtool -G eth1 rx 4096 tx 4096

增大环形缓冲区可以减少高负载下的丢包，但会增加少量内存占用。

绑定中断亲和性

将网卡中断绑定到特定CPU核心，避免中断处理跨核迁移带来的性能损耗：

# 查看当前中断分配
cat /proc/interrupts | grep eth1

# 绑定中断到CPU 0-3
echo 0f > /proc/irq/$(cat /sys/class/net/eth1/device/msi_irqs | head -1)/smp_affinity

对于多队列网卡，建议使用 irqbalance 的 --banirq 选项排除网卡中断，手动分配以获得更稳定的性能。

关闭节能特性

部分网卡的节能功能会降低延迟敏感场景的性能：

ethtool --set-eee eth1 eee off
ethtool -C eth1 adaptive-rx off adaptive-tx off

启用硬件卸载

ethtool -K eth1 tso on gso on gro on lro on

TSO（TCP Segmentation Offload）和GRO（Generic Receive Offload）可以显著降低CPU在大包传输场景下的开销。