本文档记录了在 Armbian 系统下配置 RTL8188GU 无线网卡的完整步骤。

1. 安装插件

apt update
apt install usb-modeswitch usb-modeswitch-data -y
usb_modeswitch -KW -v 0bda -p 1a2b
lsusb | grep Realtek

2. 安装固件

apt install armbian-firmware-full -y
wget -4 -O /lib/firmware/rtlwifi/rtl8710bufw_UMC.bin \
  https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/rtlwifi/rtl8710bufw_UMC.bin
modprobe -r rtl8xxxu && modprobe rtl8xxxu

3. 安装 NetworkManager

apt install network-manager -y
systemctl start NetworkManager
systemctl enable NetworkManager

4. 连接 WiFi

# 查看网卡接口名
ip a

# 开启网卡（替换 wlx... 为实际接口名）
ip link set wlx488ad2f6faf4 up

# 扫描 WiFi
nmcli dev wifi list

# 连接 WiFi
nmcli dev wifi connect "WiFi名称" password "WiFi密码"

# 验证
ip a show wlx488ad2f6faf4
ping -c 4 8.8.8.8

5. 常用管理命令

nmcli connection show          # 查看连接
nmcli dev wifi list            # 扫描 WiFi
nmcli connection down "名称"   # 断开
nmcli connection up "名称"     # 重连
nmcli connection delete "名称" # 删除
nmcli dev status               # 设备状态

6. 故障排查

lsusb -t
dmesg | tail -30 | grep -E "rtl|8188|usb|wlan|firmware"
systemctl status NetworkManager
journalctl -u NetworkManager -f

7. 一键配置脚本

#!/bin/bash
apt update
apt install usb-modeswitch usb-modeswitch-data armbian-firmware-full network-manager -y
usb_modeswitch -KW -v 0bda -p 1a2b
wget -4 -O /lib/firmware/rtlwifi/rtl8710bufw_UMC.bin \
  https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/rtlwifi/rtl8710bufw_UMC.bin 2>/dev/null || true
modprobe rtl8xxxu
systemctl start NetworkManager
systemctl enable NetworkManager
sleep 2
ip link set wlx488ad2f6faf4 up 2>/dev/null || true
echo "完成！执行 nmcli dev wifi connect 'WiFi名' password '密码' 连接"

参考: https://github.com/ericklv/RTL8188GU-armbian-op5