CentOS 安装 MadWifi 无线驱动指南 (适用于特定旧硬件)

MadWifi (Multiband Atheros Driver for WiFi) 曾经是 Linux 系统上支持 Atheros 芯片组无线网卡的关键开源驱动项目，尤其在 CentOS 5/6 时代广泛应用，虽然其官方开发已停止多年，且现代内核通常集成了性能更好的 ath5k 或 ath9k 驱动，但对于某些遗留的 Atheros 硬件（特别是较旧的 ar500x 系列芯片）或在特定场景下，手动编译安装 MadWifi 驱动仍有其必要性，本指南将详细介绍在 CentOS 系统上安全、正确地安装 MadWifi 驱动的完整流程。

重要前提与注意事项

1. 硬件兼容性确认： MadWifi 仅适用于特定的 Atheros 无线芯片组（如 ar5210, ar5211, ar5212, ar5213 等系列），请务必确认您的无线网卡型号属于此范围，可使用 lspci | grep -i network 或 lspci -nn | grep -i 168c 查看设备 ID (形如 168c:xxxx)，并与 MadWifi 文档支持的 ID 列表核对。
2. 内核头文件匹配： 编译内核模块要求安装与当前运行内核版本完全一致的内核头文件和开发包，使用 uname -r 查看当前内核版本。
3. 驱动冲突风险： CentOS 可能已加载了内核自带的 ath5k 或 ath9k 驱动，这些驱动与 MadWifi 冲突，安装 MadWifi 前必须确保卸载或阻止这些驱动加载。
4. 替代方案优先：强烈建议首先尝试内核自带的 ath5k/ath9k 驱动，它们通常更稳定、维护更好，且支持电源管理和更多特性，仅在确认这些驱动无法工作或存在无法解决的功能缺失时，才考虑安装 MadWifi。
5. 环境准备： 您需要 root 权限或 sudo 权限来执行安装命令，确保系统能正常访问互联网以下载源码和依赖包。

步骤 1：安装编译环境与内核头文件

安装编译 MadWifi 所必需的开发工具链和与当前内核匹配的头文件包：

# CentOS 7/8 通用命令 (替换 `$(uname -r)` 为你的实际内核版本)
sudo yum groupinstall "Development Tools" -y
sudo yum install kernel-devel-$(uname -r) kernel-headers-$(uname -r) -y

步骤 2：卸载潜在冲突驱动并阻止加载

防止系统在启动时加载 ath5k 或 ath9k 驱动，避免与 MadWifi 冲突：

# 创建黑名单配置文件
echo "blacklist ath5k" | sudo tee /etc/modprobe.d/blacklist-ath.conf
echo "blacklist ath9k" | sudo tee -a /etc/modprobe.d/blacklist-ath.conf
# 立即卸载当前可能加载的冲突模块 (如果已加载)
sudo rmmod ath5k ath9k ath9k_common ath9k_hw ath mac80211 cfg80211 2>/dev/null || true

步骤 3：获取 MadWifi 源代码

MadWifi 官方项目已停止更新，推荐从可靠的存档仓库获取稳定快照：

# 创建一个工作目录并进入
mkdir ~/madwifi && cd ~/madwifi
# 下载 MadWifi 快照 (选择一个可靠来源)
# 示例 1 (常见存档源)
wget https://snapshots.madwifi-project.org/madwifi-trunk/madwifi-trunk-r5141-20130830.tar.gz
# 示例 2 (备用源)
# wget http://downloads.sourceforge.net/project/madwifi/madwifi-trunk/madwifi-trunk-r5141-20130830.tar.gz?use_mirror=autoselect -O madwifi-trunk-r5141.tar.gz
# 解压源代码
tar zxvf madwifi-trunk-*.tar.gz
cd madwifi-trunk-*

注意：版本号 r5141-20130830 是最后一个广泛使用的快照，请根据实际情况选择可用的最新稳定快照链接。

步骤 4：编译并安装 MadWifi 驱动

使用标准的 Linux 内核模块编译流程：

# 清理旧编译文件 (如果是重新编译)
make clean
# 编译模块
make
# 安装模块到系统内核模块目录
sudo make install
# 更新模块依赖关系
sudo depmod -a

步骤 5：加载 MadWifi 模块并验证

手动加载编译好的内核模块并检查是否成功识别无线设备：

# 加载核心模块 (通常会自动加载依赖项)
sudo modprobe ath_pci
# 检查模块加载情况
lsmod | grep ath_
# 应能看到类似 `ath_pci`, `wlan`, `ath_hal`, `ath_rate_sample` 等模块
# 查看无线接口是否出现 (通常命名为 `ath0` 或 `wifi0`)
iwconfig
# 或
ip link show

步骤 6：配置无线网络连接

驱动加载成功后,ath0 (或其他类似名称) 接口应可用，使用 CentOS 的网络管理工具配置连接：

• 命令行 (nmtui / nmcli)：

  sudo nmtui # 使用文本界面配置工具
  # 或使用 nmcli 命令配置
  sudo nmcli dev wifi list # 扫描网络 (需确保接口处于激活状态)
  sudo nmcli dev wifi connect "Your_SSID" password "Your_Password" ifname ath0

• 图形界面 (NetworkManager)： 系统托盘或设置中的网络图标应能搜索到无线网络，选择您的 SSID 并输入密码即可连接。

解决常见问题

• make 编译失败 (通常与内核版本有关)：
  • 再次确认 kernel-devel 和 kernel-headers 的版本严格匹配uname -r。
  • 查看错误输出,搜索错误关键词，较新的内核可能需要打补丁，这通常意味着兼容性问题严重，更应考虑放弃 MadWifi 或降级内核。
• 模块加载失败 (modprobe ath_pci 报错)：
  • 运行 dmesg | tail 查看内核日志，寻找具体错误信息，常见原因是驱动与当前内核不兼容，或仍有冲突驱动未卸载干净 (ath5k/ath9k)。
  • 确保已执行步骤 2 中的黑名单配置和模块卸载。
• 接口 ath0 未出现：
  • 检查 iwconfig 和 dmesg 输出。
  • 尝试手动加载其他可能需要的模块：sudo modprobe wlan。
  • 确认无线网卡硬件开关已开启 (如有)。
• 连接不稳定或性能差： MadWifi 驱动老旧，在现代网络环境或特定硬件上表现可能不佳，这往往是驱动本身限制，优化空间有限。

MadWifi 的现状与替代方案

必须坦诚地讲,MadWifi 是一个停止维护超过十年的项目，依赖它意味着接受潜在的安全风险（无安全更新）、与现代内核和网络协议栈的兼容性挑战，以及性能可能落后于主流驱动，对于绝大多数使用较新 Atheros 芯片 (ar9xxx 及以后) 的用户，内核内置的 ath9k 驱动是经过充分验证、功能完善且持续维护的最佳选择，即使是较旧的 ar5xxx 芯片，ath5k 驱动在大多数情况下的表现也优于 MadWifi，并支持重要的节能特性，除非您使用的硬件明确无法被 ath5k/ath9k 驱动识别或存在关键功能缺失，并且您完全了解使用废弃驱动的风险，否则投入时间尝试 MadWifi 通常不是最优解，对于必须使用特定旧硬件的场景，这份指南提供了清晰的路径，但务必优先评估现代驱动的可行性，技术决策应平衡需求与维护成本，选择长期可持续的方案往往是更明智的。