简介成都海光网卡驱动安装包面向需要为海光网卡部署驱动的运维与开发人员解决网卡在操作系统中无法被正确识别、性能无法充分发挥的问题。压缩包共22个文件约146KB以14个C源文件与3个头文件为核心辅以Makefile、.mk构建脚本、Shell脚本及readme说明属于典型的源码级驱动工程便于按目标平台自行编译适配。包内还包含配置与诊断相关工具可帮助完成网络参数调整、状态监控与故障排查并覆盖不同系统版本与速率标准的兼容需求。目前已有657人学习下载适合具备一定Linux内核与驱动基础、希望深入理解网卡驱动编译与调试流程的读者参考也可作为排查驱动加载失败、版本不匹配等问题的对照材料。1. 成都海光网卡驱动安装包从识别芯片到跑通链路的一次完整拆解手上有一台成都海光平台的机器系统装完了ip a只看到 lolspci里网卡明明在就是没有对应的网络接口。这种场景下你要的不是一篇讲 PCIe 总线原理的科普而是一个能直接落地的驱动安装包以及一套从确认芯片型号到验证链路通断的完整流程。成都海光网卡驱动安装包解决的正是这件事它面向海光 CPU 平台含 K100、K100AI 等整机与板卡形态上常见的板载网卡与独立网卡提供匹配内核版本的驱动源码或预编译模块让你在国产化平台上把网络先跑起来。适合两类人一是刚接手海光整机、准备做系统部署的运维二是需要在海光平台上做应用适配、被网卡不通卡住的开发。下面按「先认芯片、再装驱动、最后排错」的顺序走一遍中间会给出可直接抄的命令和参数说明。2. 先搞清楚网卡是谁芯片识别与驱动匹配装驱动翻车十次里有八次是芯片认错了。海光平台整机厂牌多板载网卡可能是国产控制器也可能是常见的 Realtek、Intel 方案同一型号整机不同批次都可能换料。所以第一步不是急着insmod而是把「这块网卡到底是谁」钉死。2.1 用 lspci 和 ethtool 锁定芯片身份登录系统后先看 PCI 设备列表重点抓网络控制器的厂商 ID 和设备 ID# 列出所有网络控制器-nn 会同时显示厂商ID:设备ID lspci -nn | grep -i -E ethernet|network # 输出示例 # 03:00.0 Ethernet controller [0200]: Realtek Semiconductor Co., Ltd. # RTL8125 2.5GbE Controller [10ec:8125] (rev 05)-nn这个参数是关键它把人类可读的名字和[10ec:8125]这样的数字 ID 一起打出来。名字可能因为 pci.ids 数据库版本旧而显示不准但数字 ID 是硬件写死的拿这个去对驱动才靠谱。如果系统里已经加载了某个驱动但没起来可以用ethtool -i反查当前绑定的驱动名和版本# 假设接口名是 eth0先确认接口存在 ip link show # 查看该接口使用的驱动、固件版本、总线地址 ethtool -i eth0ethtool -i输出的driver字段告诉你内核现在用的是哪个模块version是模块版本bus-info是 PCI 地址。如果ip link里压根没有接口说明驱动没加载或加载失败这时回到lspci的 ID 去匹配。常见做法是拿[10ec:8125]这类 ID 去内核源码的drivers/net/ethernet/下对应厂商目录里搜或者直接查驱动包里的README支持列表。2.2 驱动包里的文件结构与选型逻辑拿到成都海光网卡驱动安装包后先别急着编译把目录结构看清楚。典型的驱动包会包含这几类内容目录/文件作用使用时机src/驱动源码含.c.h和 Makefile需要按当前内核重新编译时prebuilt/针对特定内核版本预编译的.ko内核版本完全匹配时可直接用dkms.confDKMS 配置支持内核升级后自动重编长期维护的机器优先用README/INSTALL编译参数、支持列表、已知问题动手前必读scripts/加载、卸载、状态检查脚本快速验证和回滚选型逻辑很简单内核版本和预编译模块的vermagic一致就直接用prebuilt/不一致或者你要保证以后内核升级还能用就走 DKMS 或手动编译源码。判断vermagic是否匹配# 查看当前内核版本和 vermagic uname -r modinfo prebuilt/xxx.ko | grep vermagic两个输出里的内核版本号必须完全一致包括-generic、-rt这类后缀。差一个字符insmod就会报invalid module format。这是血泪经验很多人看到uname -r是5.10.0预编译模块是5.10.0-rt觉得差不多就硬上结果直接翻车。2.3 依赖检查编译驱动前必须装的东西如果决定从源码编译先确认编译环境齐全。海光平台通常是 aarch64 或 x86_64 架构对应内核头文件和编译器要装对# 确认架构 uname -m # 安装内核头文件和编译工具以常见发行版为例 # Debian/Ubuntu 系 apt-get install -y build-essential linux-headers-$(uname -r) dkms # RHEL/CentOS 系 yum install -y gcc make kernel-devel-$(uname -r) kernel-headers-$(uname -r) dkmslinux-headers-$(uname -r)这个包名里的$(uname -r)必须和当前运行内核一致否则编译出来的模块 vermagic 对不上。dkms是可选的但强烈建议装后面讲进阶用法会用到。装完用gcc --version和ls /lib/modules/$(uname -r)/build确认编译器和内核构建目录都在。如果/lib/modules/$(uname -r)/build是个死链接说明头文件包没装对版本编译一定失败。3. 装驱动从编译到加载的完整命令链芯片认准了依赖也齐了接下来就是编译、加载、验证三步。这一章把每条命令的参数含义和失败时的观察点都写清楚照着走基本能跑通。3.1 源码编译make 参数与产物位置进入驱动源码目录先看 Makefile 里有没有针对海光平台的特殊开关。常见做法是直接make但有些包需要指定架构或内核路径# 进入源码目录 cd driver-package/src # 清理上次编译残留避免旧 .o 文件干扰 make clean # 编译KERNELDIR 指向当前内核构建目录 make KERNELDIR/lib/modules/$(uname -r)/build # 编译成功后产物通常是 xxx.ko ls -l *.komake clean不是可选项。我遇到过好几次改了源码里的一个宏直接make结果链接的还是旧.o行为跟预期完全不一样查了半天才发现是残留文件。KERNELDIR参数告诉 Makefile 去哪里找内核头文件不指定的话它可能去/usr/src/linux找那个路径在多数发行版上是空的或指向错误版本。编译过程如果报error: implicit declaration of function基本是内核 API 版本不匹配需要看驱动包 README 里标注的支持内核范围。3.2 加载模块与绑定接口编译出.ko之后先insmod加载再看内核日志和接口状态# 加载模块注意用绝对路径或 ./ 前缀 insmod ./xxx.ko # 查看内核最近日志确认加载是否报错 dmesg | tail -30 # 确认模块已加载 lsmod | grep xxx # 查看是否出现新的网络接口 ip link showinsmod和modprobe的区别这里要拎清insmod只加载你指定的那个.ko文件不处理依赖modprobe会去/lib/modules/$(uname -r)/下找模块并自动解决依赖。驱动包刚编译出来还没安装到系统模块目录时只能用insmod加路径。加载后dmesg里如果出现xxx: probe of 0000:03:00.0 failed with error -5-5是-EIO通常是硬件没复位干净或固件没加载可以先rmmod再重新insmod试一次不行就得查固件文件是否放到了/lib/firmware/下。接口出现后用ip link set eth0 up拉起再ip addr add配地址。如果接口出现了但up不起来dmesg里一般会有link is not ready之类的提示这时候检查网线和对端交换机端口状态别一味怀疑驱动。3.3 用 DKMS 做持久化避免内核升级后失效手动insmod的模块重启就没了内核一升级还得重编。生产环境常见做法是用 DKMS 把驱动注册进内核模块管理体系# 把源码目录复制到 DKMS 管理路径 cp -r driver-package/src /usr/src/xxx-1.0.0 # 编写 dkms.conf如果包里没现成的 cat /usr/src/xxx-1.0.0/dkms.conf EOF PACKAGE_NAMExxx PACKAGE_VERSION1.0.0 BUILT_MODULE_NAME[0]xxx DEST_MODULE_LOCATION[0]/kernel/drivers/net/ethernet/xxx AUTOINSTALLyes EOF # 添加、编译、安装 dkms add -m xxx -v 1.0.0 dkms build -m xxx -v 1.0.0 dkms install -m xxx -v 1.0.0 # 确认状态 dkms statusDEST_MODULE_LOCATION决定模块最终装到/lib/modules/$(uname -r)/kernel/下的哪个子目录写错不影响加载但会让modprobe找不到。AUTOINSTALLyes保证内核升级后 DKMS 自动为新内核重编。dkms status输出里如果显示installed就对了显示built但没installed说明最后一步没执行。这套流程走完以后apt upgrade或yum update带了新内核驱动会自动跟着编省掉后悔药。4. 避坑与排查五条真实踩坑记录驱动装不上、装上不通、通了不稳原因往往不在驱动本身。下面五条是按「现象 → 原因 → 解决」整理的现场记录覆盖了海光平台上最常见的几类问题。4.1 现象insmod 报 invalid module format原因预编译模块的 vermagic 和当前内核不匹配或者编译时用的内核头文件版本和运行内核不一致。海光平台有些整机出厂内核是厂商定制的版本号带特殊后缀和通用发行版内核对不上。解决modinfo xxx.ko | grep vermagic和uname -r逐字符比对。不一致就放弃预编译模块走源码编译编译时显式指定KERNELDIR/lib/modules/$(uname -r)/build。如果头文件包版本本身就和运行内核不一致先apt-get install --reinstall linux-headers-$(uname -r)把版本对齐。4.2 现象驱动加载了ip link 里没有新接口原因模块加载成功但 probe 失败常见于固件缺失或 PCI 设备被其他驱动先占用了。海光平台上有些网卡会被内核自带的通用驱动先绑定你的专用驱动再加载时设备已经被占。解决先dmesg | grep -i firmware看有没有固件加载失败。有的话把驱动包firmware/目录下的文件复制到/lib/firmware/再重新加载。如果是驱动抢占用lspci -k看当前绑定的驱动名然后echo 0000:03:00.0 /sys/bus/pci/drivers/旧驱动/unbind解绑再加载新驱动。4.3 现象接口能 up但 ping 不通网关原因链路层通了不代表网络层通。常见是 IP 配错网段、子网掩码写错或者对端交换机端口划了 VLAN 而本机没配。解决ip addr show eth0确认地址和掩码ip route show确认默认路由指向正确网关。如果交换机侧有 VLAN需要ip link add link eth0 name eth0.100 type vlan id 100创建子接口再配地址。用ethtool eth0看Link detected: yes确认物理链路ethtool -S eth0看收发包计数是否在涨。4.4 现象大流量下丢包严重、速率上不去原因驱动默认的 ring buffer 和中断合并参数偏保守或者网卡协商速率没到预期。海光平台上 2.5G 网卡协商成 1G 的情况不少见跟线缆质量和对端端口能力都有关。解决ethtool eth0看Speed字段确认协商速率。没到预期就换六类线、检查对端端口。速率对了还丢包用ethtool -G eth0 rx 4096 tx 4096加大 ring bufferethtool -C eth0 rx-usecs 50调整中断合并。改完用ethtool -S eth0 | grep -i drop观察丢包计数是否停止增长。4.5 现象重启后驱动没了接口消失原因insmod是临时加载没写进开机加载配置。或者写了/etc/modules但模块没安装到/lib/modules/$(uname -r)/下开机时modprobe找不到。解决用 DKMS 安装见 3.3或者手动make install把.ko复制到/lib/modules/$(uname -r)/kernel/drivers/net/下再depmod -a然后在/etc/modules-load.d/xxx.conf里写模块名。重启后用lsmod | grep xxx确认自动加载生效。5. 进阶用 ethtool 和 ethtool -S 做链路质量基线驱动跑通只是起点真正要判断这块网卡在海光平台上稳不稳得建立一套链路质量基线。我一般会在机器交付前跑一遍下面这套检查把输出存档以后出问题好对比。先看协商速率和双工模式这是最基础的# 查看链路状态、速率、双工、端口类型 ethtool eth0 # 关键字段 # Speed: 2500Mb/s # Duplex: Full # Link detected: yesSpeed必须是预期值Duplex必须是Full。如果显示Half说明协商出了问题强制全双工ethtool -s eth0 speed 2500 duplex full autoneg off。注意autoneg off之后对端也得对应设置否则可能直接不通这是把双刃剑。然后看统计计数器重点盯错误和丢包# 查看全部统计过滤关键项 ethtool -S eth0 | grep -i -E error|drop|discard|fifo|miss # 常见输出项 # rx_errors: 0 # tx_errors: 0 # rx_dropped: 0 # rx_fifo_errors: 0这些计数器在空闲时应该全是 0。rx_fifo_errors增长说明 ring buffer 太小收包速度跟不上加大rx值。rx_missed_errors增长说明中断处理不及时调rx-usecs。tx_errors增长通常是线缆或对端问题不是驱动能解决的。最后做一次持续压测观察计数器变化# 用 iperf3 打流 60 秒同时另一窗口观察计数器 iperf3 -c 对端IP -t 60 -P 4 # 打流前后各取一次计数器快照对比差值 ethtool -S eth0 /tmp/eth0_before.txt # ... 打流 ... ethtool -S eth0 /tmp/eth0_after.txt diff /tmp/eth0_before.txt /tmp/eth0_after.txt-P 4是开四个并行流更容易压出瓶颈。打流结束后diff出来的增量里如果rx_errors或tx_errors涨了几百上千说明链路质量有问题优先换线、换端口别在驱动参数上死磕。如果只有rx_dropped小幅增长那是正常的缓冲区溢出调大 ring buffer 就能压下去。这套基线我一般会存成脚本交付时跑一遍把ethtool、ethtool -S、ip -s link三份输出一起归档。从那以后我每次上架海光机器都强制走一遍这个流程先确认链路质量再谈应用部署省得后面业务跑起来才发现网络在偷偷丢包。希望帮到你。本文还有配套的精品资源点击获取