树莓派使用Realtek RTL8188CUS USB网卡搭建热点：关键配置避坑指南

发表于 分类于 阅读次数：
在树莓派项目中，Realtek RTL8188CUS USB网卡是一款性价比很高的无线网卡选择，不仅支持网络连接，还能用来搭建热点实现设备共享网络。但在配置过程中，很容易遇到一个棘手的问题：手动添加的关键安全配置会被GUI网络设置覆盖删除。本文就来详细梳理完整的配置流程，并重点解决这个核心坑点。

一、前置准备

  • 硬件：树莓派（任意型号，确保USB接口正常）、Realtek RTL8188CUS USB无线网卡、电源适配器

  • 系统：推荐Raspbian（或基于Debian的树莓派官方系统），已完成基础初始化（开启SSH、配置网络等）

  • 工具：终端（本地或SSH远程连接）、文本编辑器（nano/vim）

二、核心配置步骤（重点避坑）

1. 确认网卡识别

首先将Realtek RTL8188CUS USB网卡插入树莓派的USB接口，通过终端执行以下命令，确认系统已成功识别网卡：

1
2

lsusb

在输出结果中，找到类似 Realtek Semiconductor Corp. RTL8188CUS 802.11n WLAN Adapter 的条目，说明网卡识别正常。

再通过以下命令查看网卡名称（通常为wlan1，默认板载网卡为wlan0）：

1
2

ip addr show

2. 编辑NetworkManager配置文件（关键步骤）

树莓派的网络管理主要依赖NetworkManager，搭建热点需要手动编辑对应的配置文件，重点是添加wifi-security相关配置，且后续避免通过GUI修改该网络。

步骤如下：

  1. 进入NetworkManager配置文件目录：
1
2

cd /etc/NetworkManager/system-connections/
  1. 创建或编辑热点配置文件（文件名可自定义，建议以热点名称命名，后缀为.nmconnection），这里以创建名为“RPi-Hotspot.nmconnection”的配置文件为例：
1
2

sudo nano RPi-Hotspot.nmconnection
  1. 在配置文件中添加以下内容，重点保留[wifi-security]模块下的4行关键配置：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

[connection]
id=RPi-Hotspot  # 热点名称（可自定义）
uuid=xxx-xxx-xxx-xxx  # 可通过uuidgen命令生成，或留空让系统自动分配
type=wifi
interface-name=wlan1  # 此处填写你的RTL8188CUS网卡名称（如wlan1）
permissions=

[wifi]
mode=ap  # 模式为接入点（热点）
ssid=RPi-Hotspot  # 热点广播名称（可自定义）
band=a  # 频段，可选a/b/g/n，根据网卡支持选择，RTL8188CUS支持2.4G，建议选g/n
channel=6  # 信道，2.4G推荐6、11等不重叠信道
mac-address=xxx  # 网卡MAC地址，可通过ip addr show查看，可选

[wifi-security]
group=ccmp;  # 关键配置：组加密方式
pairwise=ccmp;  # 关键配置：成对加密方式
proto=rsn;  # 关键配置：安全协议，rsn对应WPA2-PSK
key-mgmt=wpa-psk  # 密钥管理方式，WPA2-PSK
psk=12345678  # 热点密码，至少8位

[ipv4]
method=shared  # 共享树莓派的网络（如以太网或板载wifi的网络）给热点设备
address1=192.168.10.1/24  # 热点的网关地址，可自定义网段

[ipv6]
addr-gen-mode=stable-privacy
method=ignore

  1. 保存并退出nano编辑器：按Ctrl+O，回车确认保存，再按Ctrl+X退出。

  2. 设置配置文件权限（必须执行，否则NetworkManager无法识别）：

1
2

sudo chmod 600 RPi-Hotspot.nmconnection
  1. 重启NetworkManager服务，使配置生效：
1
2

sudo systemctl restart NetworkManager

3. 验证热点是否正常启动

执行以下命令查看热点状态：

1
2

nmcli connection show

如果输出中包含“RPi-Hotspot”且状态为“activated”，说明热点已成功启动。此时可以用手机或电脑搜索该热点名称，输入设置的密码（如12345678），即可连接使用。

三、关键避坑点：GUI修改会丢失配置

这是使用RTL8188CUS网卡搭建热点时最容易踩的坑：如果后续通过树莓派的图形界面（GUI）修改该热点的网络配置（如修改密码、热点名称等），[wifi-security]模块下的group=ccmp;、pairwise=ccmp;、proto=rsn;这三行关键配置会被自动删除。

一旦这三行配置丢失，热点会出现以下问题：

  • 设备无法正常连接热点，提示“认证错误”或“密码错误”（即使密码正确）；

  • 热点加密方式异常，可能变为无加密或低安全性加密，存在安全风险。

避坑解决方案：

  1. 尽量避免通过GUI修改该热点的任何配置，所有修改都通过终端编辑.nmconnection配置文件完成；

  2. 如果不小心通过GUI修改了配置，导致热点无法使用，只需重新通过nano编辑对应的.nmconnection文件，在[wifi-security]模块下补全以下三行配置，然后重启NetworkManager服务即可恢复：

1
2
3
4
5

[wifi-security]
group=ccmp;
pairwise=ccmp;
proto=rsn;

四、常见问题排查

  1. 网卡识别失败：检查USB接口是否正常，尝试更换USB口；确认系统已安装RTL8188CUS的驱动（Raspbian官方系统通常自带，无需额外安装）。

  2. 热点无法激活：检查配置文件中的interface-name是否正确（需与ip addr show显示的网卡名称一致）；检查配置文件权限是否为600；重启NetworkManager后再次尝试。

  3. 设备连接热点后无法上网：检查树莓派的主网络（如以太网）是否正常联网；确认ipv4模块的method设置为shared。

五、总结

使用Realtek RTL8188CUS USB网卡在树莓派上搭建热点的核心在于正确配置NetworkManager的.nmconnection文件，尤其是[wifi-security]模块下的三行关键加密配置。记住避免通过GUI修改该网络配置，所有调整都通过终端手动编辑配置文件完成，就能顺利避开认证失败的坑，稳定使用热点功能。