Debian10系统下安装高通无线网卡需先确认网卡型号(如lspci查看),下载对应驱动源码(如ath11k/ath10k系列),解压后编译安装(./configure && make && make install),加载驱动模块(modprobe),若驱动未自动识别,需检查内核版本兼容性,或安装firmware-linux-nonfree,网络配置可通过NetworkManager编辑Wi-Fi连接,或使用netplan设置静态/动态IP,确保服务重启后联网,全程需注意依赖安装(build-essential等),驱动加载失败时查看dmesg日志排查问题,最终实现稳定网络连接。
Debian10作为一款稳定、开源的Linux发行版,深受开发者与爱好者喜爱,但在使用过程中,部分用户可能会遇到无线网卡无法识别的问题,尤其是搭载高通无线网卡(如QCA6174、QCA9377、AR956x等芯片型号)的设备,由于Debian10默认内核可能未包含最新或特定的高通无线网卡驱动,需手动安装配置,本文将详细介绍在Debian10系统中识别、安装并配置高通无线网卡驱动的完整流程,帮助用户快速解决无线网络连接问题。
第一步:确认无线网卡型号
在安装驱动前,首先需要明确设备的高通无线网卡具体型号,以便选择对应的驱动方案。
查看PCIe网卡信息
如果是内置的PCIe无线网卡,可通过以下命令查看:

lspci -knn | grep -iA3 net
执行后,若输出中包含“Qualcomm Atheros”或“QCA”等关键字,且设备ID以17开头(如17cb:1103),则可确认是高通无线网卡。
03:00.0 Network controller [0280]: Qualcomm Atheros QCA6174 802.11ac Wireless Network Adapter [17cb:1103]
Subsystem: Foxconn International, Inc QCA6174 802.11ac Wireless Network Adapter [105b:e0cd]
Kernel driver in use: ath10k_pci
Kernel modules: ath10k_pci
查看USB网卡信息
若为USB外置无线网卡,使用以下命令:
lsusb | grep -i qualcomm
输出示例:
04f2:b1f1 Qualcomm Atheros Communications AR9271 802.11n
第二步:安装必要依赖与工具
编译和安装高通无线网卡驱动需要依赖部分基础工具和开发库,先通过以下命令安装:
sudo apt update sudo apt install -y build-essential linux-headers-$(uname -r) dkms git wget
build-essential:包含gcc、make等编译工具;linux-headers-$(uname -r):当前内核的头文件,用于编译驱动;dkms:动态内核模块支持,便于驱动管理与更新;git/wget:用于下载驱动源码或固件。
第三步:安装高通无线网卡驱动
根据网卡芯片型号不同,驱动安装方案分为两类:ath10k驱动(QCA6174/QCA9377等新型号)和ath9k驱动(AR946x/AR956x等旧型号)。
ath10k驱动(适用于QCA6174/QCA9377/AR956x等)
Debian10默认内核已包含ath10k驱动,但可能因固件版本过低导致无法识别,此时需安装最新固件。
安装官方固件包
Debian官方仓库中提供了firmware-atheros包,包含部分高通固件:
sudo apt install -y firmware-atheros
安装后,重启系统查看无线网卡是否可识别(可通过iwconfig命令检查,若出现wlan0等无线网卡名称则说明成功)。
手动安装最新固件(若官方固件无效)
若官方固件仍无法解决问题,需从GitHub下载最新ath10k-firmware固件:
git clone https://github.com/kvalo/ath10k-firmware.git cd ath10k-firmware/QCA6174/hw1.0 sudo cp -r . /lib/firmware/ath10k/
替换为对应网卡型号的固件目录(如QCA9377则在QCA9377/hw1.0目录下),完成后重启系统,驱动会自动加载最新固件。
ath9k驱动(适用于AR946x/AR956x等旧型号)
部分老旧高通网卡(如AR9462、AR9565)使用ath9k驱动,Debian10默认已支持,但需确保固件完整。
安装ath9k固件
sudo apt install -y firmware-atheros firmware-atheros-pci
安装后,若网卡仍未识别,可尝试手动加载驱动:
sudo modprobe ath9k
查看是否成功:
lsmod | grep ath9k
第四步:验证驱动加载与网卡识别
安装驱动后,需验证内核是否正确加载驱动模块,以及网卡是否被系统识别。
检查驱动模块
lsmod | grep -E "ath10k|ath9k"
若输出包含ath10k_pci或ath9k,则说明驱动已加载。
查看无线网卡状态
iwconfig
若成功识别,会显示类似以下内容(wlan0为网卡名称,可能因设备不同而变化):
wlan0 IEEE 802.11 
