三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

树莓派与香橙派WIFI配置与热点搭建全攻略

发布时间：2026/8/8 4:28:14 三亩地 编程学习日记
树莓派与香橙派WIFI配置与热点搭建全攻略

1. 项目概述：为什么要在派上折腾WIFI和热点？

玩过树莓派或者香橙派的朋友，估计都经历过这个阶段：刚拿到手，兴冲冲地刷好系统，插上电，然后发现——这玩意儿怎么联网？对于绝大多数没有有线网络环境的场景，比如放在客厅做媒体中心、带到户外做数据采集、或者临时搭建个开发环境，WIFI就成了唯一的生命线。更进一步，当你需要让派本身成为一个无线接入点（AP），为其他设备提供网络，比如搭建一个便携的Web服务器、做一个临时的文件共享热点，或者为IoT设备组网时，开启热点功能就变得至关重要。

我手头常年备着几块树莓派3B+、4B和香橙派Zero 2、Orange Pi 5，从早期的wpa_supplicant手动配置，到后来系统集成的raspi-config和nmcli，再到用USB网卡扩展双频甚至热点功能，踩过的坑不计其数。很多人觉得“开启WIFI”不就是填个密码吗？但实际远不止如此：驱动兼容性、频段选择、国家代码设置、电源管理，每一个细节都可能让你卡上半天。而“开启热点”就更复杂了，它涉及到网络地址转换（NAT）、DHCP服务、防火墙规则等一系列后台服务的协同工作。

这篇文章，我就以一个老玩家的视角，把在树莓派和香橙派上配置WIFI客户端和AP热点的完整流程、核心原理、以及那些官方文档里不会写的“坑”和技巧，给你彻底讲透。无论你是用板载无线网卡，还是外接USB网卡，目标是连接家庭网络，还是自己创建一个独立的热点，都能在这里找到可复现的解决方案。

2. 核心思路与方案选型：板载、外置与系统工具

在动手之前，我们必须先理清思路：你的硬件是什么？你的系统是什么？你的最终目标是什么？不同的组合，意味着完全不同的操作路径。

2.1 硬件基础：板载WIFI vs. USB外置网卡

树莓派：从树莓派3代开始，板载了博通（Broadcom）的无线芯片，支持2.4GHz频段（802.11n）。树莓派4B和5的板载WIFI升级到了双频（2.4GHz/5GHz），支持802.11ac。板载网卡的优点是集成度高、免驱动，在官方Raspberry Pi OS（原Raspbian）下开箱即用。

香橙派：情况复杂一些。以流行的Orange Pi 5为例，其板载的通常是瑞昱（Realtek）的RTL8822CS或类似芯片，同样支持双频。但香橙派官方提供的系统镜像众多（Ubuntu, Debian, Android等），驱动可能没有预先集成，这是第一个可能遇到的坎。

USB外置网卡：当你需要更强的信号、支持更多客户端（做热点时）、或者板载网卡损坏时，USB网卡就成了救星。但这里水很深，不是所有USB网卡都能在Linux下完美工作，尤其是需要支持AP（Master）模式的。经过大量实测，芯片方案是决定性因素。能稳定支持AP模式的常见芯片有：RTL8812AU, RTL8814AU, MT7612U等。购买前务必查清芯片型号和Linux驱动支持情况。

注意：很多便宜的“随身WIFI”或免驱网卡，在Windows下即插即用，但在Linux下可能只有非常基础的STA（客户端）模式驱动，无法开启AP模式。想做热点，买之前一定要做功课。

2.2 系统与工具选型：图形化还是命令行？

配置网络，主要有三条路径：

  1. 图形化界面（GUI）：对于桌面版系统，这是最直观的方式。在Raspberry Pi OS或Ubuntu Desktop上，点击右上角的网络图标，选择网络、输入密码即可。优点是无脑快捷，适合新手和一次性配置。缺点是难以批量部署、无法应对复杂网络环境（如企业WPA2-Enterprise），且不适用于无桌面的服务器版（Lite版）系统。

  2. 系统配置工具：这是兼顾易用性和灵活性的选择。

    • 树莓派专属：sudo raspi-config。在System Options->Wireless LAN中，可以方便地设置国家代码和连接WIFI。但它功能有限，无法配置热点。
    • NetworkManager (nmcli/nmcli)：这是现代Linux桌面发行版（包括Ubuntu、Fedora等）主流的网络管理工具。香橙派的Ubuntu桌面版通常也用它。它功能强大，既能管理WIFI连接，也能创建热点，并且有命令行(nmcli)和图形化(nmtui)两种操作方式，强烈推荐使用。

  3. 底层网络配置：直接编辑配置文件，如/etc/wpa_supplicant/wpa_supplicant.conf（用于WIFI客户端）和配置hostapd、dnsmasq（用于创建热点）。这是最根本、最通用的方法，适用于所有派和所有Linux发行版，尤其是无桌面的服务器环境。虽然步骤稍多，但学会了就能一通百通，也是本文重点讲解的方法。

我的建议是：如果你是初学者，只是想连上家里的WIFI，优先使用图形界面或raspi-config（树莓派）。如果你想深入理解原理，或者需要在无桌面系统上配置，那么学习命令行和编辑配置文件是必经之路。对于创建热点，在桌面环境下可以尝试nmcli，在服务器环境下则必须掌握hostapd+dnsmasq的方案。

3. 实战操作一：配置WIFI客户端连接

无论你的目标是什么，让派先“上网”总是第一步。我们分别从最简单和最通用的两种方法来说。

3.1 方法A：使用NetworkManager (nmcli) - 适用于现代桌面系统

如果你的香橙派或树莓派安装了Ubuntu Desktop、Raspberry Pi OS with Desktop等系统，并且网络由NetworkManager管理（通常是默认），那么nmcli是你的瑞士军刀。

首先，打开终端，查看可用的WIFI设备及网络：

nmcli device wifi list

这会列出周围所有的WIFI网络，包括SSID（网络名）、信号强度、频段等信息。

连接一个开放网络（无密码）：

sudo nmcli device wifi connect <SSID名称>

连接一个使用WPA/WPA2加密的网络（最常见）：

sudo nmcli device wifi connect <SSID名称> password <你的WIFI密码>

例如：sudo nmcli device wifi connect MyHomeWiFi password MySecretPassword123

连接后，可以用以下命令查看连接状态：

nmcli connection show --active

或者用熟悉的ifconfig或ip addr命令查看是否获取到了IP地址。

nmcli的优势与注意事项：

  • 优势：命令简洁，无需编辑文件；连接信息会自动保存，重启后自动重连；可以方便地管理多个连接配置。
  • 注意：如果系统没有安装NetworkManager，需要先安装network-manager包。在一些极简的服务器镜像中，可能默认使用systemd-networkd或netplan，这时nmcli命令无效。

3.2 方法B：编辑wpa_supplicant配置文件 - 通用终极方法

这是最经典、最底层的方法，适用于所有基于Debian/Ubuntu的系统，包括无桌面的Lite版本。其原理是配置wpa_supplicant这个守护进程，让它来负责WIFI的认证和连接。

步骤1：确认WIFI接口名称通常，板载WIFI接口叫wlan0。如果你接了USB网卡，可能是wlan1。使用ip addr或ifconfig命令查看。

步骤2：编辑WPA supplicant配置文件

sudo nano /etc/wpa_supplicant/wpa_supplicant.conf

如果文件不存在，就新建一个。在其中添加以下内容：

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev update_config=1 network={ ssid="你的WIFI名称" psk="你的WIFI密码" key_mgmt=WPA-PSK }

关键参数解析：

  • country=CN：极其重要！这设置了国家代码，决定了WIFI可以使用的信道和频率范围。不设置或设置错误，可能导致WIFI无法打开或信号极差。中国是CN，美国是US，以此类推。
  • ctrl_interface和update_config：允许外部程序（如wpa_cli）更新配置。
  • network块：每个块定义一个网络。ssid和psk顾名思义。key_mgmt是密钥管理方式，对于绝大多数家庭WPA2-Personal网络，就是WPA-PSK。如果是开放的没有密码的网络，则写成key_mgmt=NONE。

步骤3：配置网络接口（传统方法）编辑网络接口配置文件。在旧系统（如Raspbian Buster及以前）中，是/etc/network/interfaces。但在新系统（如Raspberry Pi OS Bullseye及以后、Ubuntu 18.04+）中，更推荐使用dhcpcd。 编辑dhcpcd配置文件：

sudo nano /etc/dhcpcd.conf

在文件末尾添加：

interface wlan0 static ip_address=192.168.1.100/24 static routers=192.168.1.1 static domain_name_servers=192.168.1.1 8.8.8.8

或者，更常见的是使用DHCP自动获取IP，那么只需确保没有针对wlan0的静态配置即可（通常默认就是DHCP）。

步骤4：重启服务或系统

# 重启wpa_supplicant和dhcpcd服务 sudo systemctl restart wpa_supplicant sudo systemctl restart dhcpcd # 或者更直接地重启网络接口 sudo ip link set wlan0 down sudo ip link set wlan0 up

等待几十秒，然后使用ifconfig wlan0查看是否获取到了IP地址（inet字段）。也可以用ping -I wlan0 8.8.8.8测试外网连通性。

实操心得与避坑指南：

  1. 国家代码（country code）是万恶之源：超过一半的WIFI连接失败，尤其是提示“SSID not found”或者接口一直处于DOWN状态，都和这个有关。务必在wpa_supplicant.conf开头正确设置。在树莓派上，raspi-config里也可以设置。
  2. 密码错误与特殊字符：确保密码完全正确，注意大小写。如果密码包含特殊字符（如#,!,&），最好用wpa_passphrase工具生成加密后的PSK，避免转义错误。
    wpa_passphrase “你的WIFI名称” “你的明文密码”
    命令输出的psk=...后面那一长串加密字符串，可以直接用来替换配置文件里的psk="明文密码"。
  3. 隐藏网络（Hidden SSID）：如果你的网络不广播SSID，需要在network块里加上一行：scan_ssid=1。
  4. 5GHz频段连接不上：有些老旧的板载网卡（如树莓派3B+）虽然支持5GHz，但驱动可能不稳定。尝试在路由器后台将5G频段的信道固定在36, 40, 44, 48这几个低信道（属于DFS-free信道），兼容性更好。

4. 实战操作二：将派设置为无线热点（AP模式）

让派发出WIFI信号，自己当路由器，这个需求在创客项目中非常普遍。比如，做一个无需外部网络即可访问的智能家居控制面板，或者一个离线数据收集站。下面我们使用最经典的hostapd（提供AP功能）+dnsmasq（提供DHCP和DNS服务）组合来实现。

4.1 准备工作与依赖安装

首先，确保你的WIFI网卡支持AP（Master）模式。可以运行以下命令检查：

sudo iw list | grep -A 10 “Supported interface modes”

在输出中，你应该能看到“AP”字样。如果只有“managed”（客户端模式），那么这块网卡可能无法用作热点。

更新软件包列表并安装必要软件：

sudo apt update sudo apt install hostapd dnsmasq -y

安装完成后，先不要启动它们，因为我们还需要配置。

4.2 配置静态IP地址

当派作为热点时，它需要有一个固定的IP地址，作为这个微型局域网的网关。我们通常使用192.168.4.1这个网段，避免和家中主路由的192.168.1.x冲突。

配置dhcpcd，告诉它不要管理wlan0的IP（因为我们要手动设置）：

sudo nano /etc/dhcpcd.conf

在文件末尾添加：

denyinterfaces wlan0

保存退出。

接下来，为wlan0设置静态IP。编辑网络接口配置文件（对于使用systemd-networkd或ifupdown的系统）：

sudo nano /etc/network/interfaces

添加或修改关于wlan0的部分：

auto wlan0 iface wlan0 inet static address 192.168.4.1 netmask 255.255.255.0 network 192.168.4.0 broadcast 192.168.4.255

对于更新的系统，可能需要使用Netplan（如Ubuntu Server 18.04+）。这里不展开，原理都是分配静态IP192.168.4.1/24。

4.3 配置hostapd（创建热点）

hostapd的配置决定了热点的名称、密码、加密方式和信道。

sudo nano /etc/hostapd/hostapd.conf

写入以下配置（这是一个通用且稳定的配置）：

interface=wlan0 # 使用Linux标准的nl80211驱动 driver=nl80211 # 热点的SSID名称 ssid=MyPiHotspot # 无线模式，802.11g = 2.4GHz, 802.11a = 5GHz, 802.11n = 2.4/5GHz hw_mode=g # 信道，2.4GHz常用1,6,11，避免干扰 channel=6 # 开启802.11n支持 ieee80211n=1 # 开启WMM（QoS支持） wmm_enabled=1 # 国家代码，同样重要！ country_code=CN # 认证方式 auth_algs=1 # 隐藏SSID，0=不隐藏，1=隐藏 ignore_broadcast_ssid=0 # WPA2配置 wpa=2 wpa_passphrase=MyStrongPassword123 wpa_key_mgmt=WPA-PSK wpa_pairwise=TKIP CCMP rsn_pairwise=CCMP

关键配置解析：

  • hw_mode：g代表2.4GHz（802.11g），如果你想用5GHz，需要网卡支持，并改为hw_mode=a，同时channel要设置为5GHz的信道（如36, 149等）。
  • channel：1, 6, 11是2.4GHz三个互不干扰的信道，选一个周围用得少的。
  • wpa_passphrase：这就是热点的连接密码。
  • country_code：再次强调，必须设置正确，否则可能无法启动或功率受限。

然后，告诉系统hostapd配置文件的位置：

sudo nano /etc/default/hostapd

找到#DAEMON_CONF=""这一行，修改为：

DAEMON_CONF=“/etc/hostapd/hostapd.conf”

4.4 配置dnsmasq（分配IP地址）

dnsmasq轻量且易配置。我们先备份原配置，然后新建一个：

sudo mv /etc/dnsmasq.conf /etc/dnsmasq.conf.orig sudo nano /etc/dnsmasq.conf

写入以下精简配置：

interface=wlan0 # 不监听其他接口 bind-interfaces # DHCP地址池范围 dhcp-range=192.168.4.100,192.168.4.200,255.255.255.0,24h # 网关和DNS服务器地址（都指向派自己） dhcp-option=3,192.168.4.1 dhcp-option=6,192.168.4.1

这个配置意味着，dnsmasq会为连接到MyPiHotspot的设备，分配192.168.4.100到192.168.4.200之间的IP地址，网关和DNS都是192.168.4.1（即派本身）。

4.5 配置IP转发与NAT（共享互联网）

现在，热点内的设备可以互相通信了，但还上不了外网。我们需要启用IP转发，并设置NAT（网络地址转换），让热点客户端能通过派的有线网卡（eth0）或者另一个WIFI连接（wlan1，如果你有的话）访问互联网。

步骤1：启用IP转发编辑系统参数文件：

sudo nano /etc/sysctl.conf

找到这一行#net.ipv4.ip_forward=1，去掉开头的#号，使其生效：

net.ipv4.ip_forward=1

然后立即生效：

sudo sysctl -p

步骤2：设置iptables规则实现NAT假设派通过有线网卡eth0连接互联网，那么需要添加以下规则：

# 清除现有规则（小心，如果在生产环境请先备份） sudo iptables -t nat -F sudo iptables -F # 添加NAT规则：将来自wlan0（热点）的流量，通过eth0进行地址转换 sudo iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE # 允许转发来自wlan0去往eth0的流量 sudo iptables -A FORWARD -i wlan0 -o eth0 -j ACCEPT # 允许已建立连接的及相关流量返回 sudo iptables -A FORWARD -i eth0 -o wlan0 -m state --state RELATED,ESTABLISHED -j ACCEPT

为了让这些规则开机自动生效，我们需要保存它们。在Debian/Ubuntu上，可以安装iptables-persistent：

sudo apt install iptables-persistent -y

在安装过程中，它会询问是否保存当前IPv4和IPv6规则，选择“是”。或者安装后手动保存：

sudo netfilter-persistent save

4.6 启动服务并测试

现在，启动所有服务，并设置为开机自启：

# 重启网络接口，应用静态IP sudo systemctl restart networking # 或 sudo ifdown wlan0 && sudo ifup wlan0 # 启动hostapd和dnsmasq sudo systemctl unmask hostapd sudo systemctl enable hostapd sudo systemctl enable dnsmasq sudo systemctl start hostapd sudo systemctl start dnsmasq

检查服务状态：

sudo systemctl status hostapd sudo systemctl status dnsmasq

如果看到“active (running)”，基本就成功了。

现在，用你的手机或电脑搜索WIFI，应该能看到名为“MyPiHotspot”的网络，用密码“MyStrongPassword123”连接。连接后，设备应该能自动获取到192.168.4.x的IP地址。在派上运行sudo arp -a可以看到连接的设备。

测试互联网共享：在派上确保eth0已经联网（可以ping通外网）。然后，在连接到热点的设备上，尝试ping 8.8.8.8。如果通，说明NAT设置成功。

5. 进阶与排错：USB网卡、双频与常见问题

5.1 使用USB网卡创建更佳热点

板载网卡性能有限，尤其是做热点时，连接设备一多就容易不稳定。使用一个支持AP模式的USB网卡是更好的选择。操作流程和上面完全一样，只需注意几点：

  1. 识别接口名：插入USB网卡后，用ip addr或iwconfig查看新出现的接口，通常是wlan1。在hostapd.conf和dnsmasq.conf中，将所有wlan0替换为wlan1，静态IP也配置给wlan1。
  2. 驱动安装：这是最大的挑战。对于RTL8812AU/8814AU芯片，通常需要从GitHub编译安装驱动。例如：
    sudo apt install dkms build-essential git clone https://github.com/aircrack-ng/rtl8812au.git cd rtl8812au sudo make dkms_install
    安装后重启。使用sudo iw list确认新网卡支持“AP”模式。
  3. 性能调优：USB网卡可能受供电和USB总线速度限制。尽量使用派上独立的USB端口（非共享总线），并确保电源适配器功率充足（推荐5V/3A以上）。

5.2 同时连接WIFI和开启热点（双频活用）

一个非常实用的场景：派通过5GHz WIFI连接上级路由器上网，同时用2.4GHz频段开启热点供其他设备接入。这需要你的派拥有双频网卡（如树莓派4B板载），或者使用两个USB网卡。

思路：用wlan0（或一个USB网卡）作为客户端（STA模式），连接互联网。用wlan1（另一个USB网卡或双频网卡的另一个虚拟接口）作为AP模式，开启热点。配置上，就是前面两节内容的组合。

关键点：

  • 虚拟接口：有些高级网卡驱动支持创建一个虚拟接口（如wlan0和wlan0ap）。这样一块物理网卡就能同时工作在STA和AP模式，但通常性能折损较大，且配置复杂，不推荐新手尝试。
  • 独立配置：为STA接口（wlan0）配置wpa_supplicant连接互联网。为AP接口（wlan1）配置hostapd和dnsmasq，并设置不同的IP网段（如192.168.5.1/24）。
  • NAT规则：此时的NAT规则，源接口是AP接口（wlan1），出口接口是STA接口（wlan0）。
    sudo iptables -t nat -A POSTROUTING -o wlan0 -j MASQUERADE sudo iptables -A FORWARD -i wlan1 -o wlan0 -j ACCEPT sudo iptables -A FORWARD -i wlan0 -o wlan1 -m state --state RELATED,ESTABLISHED -j ACCEPT

5.3 常见问题排查速查表

遇到问题别慌，按照以下流程排查，能解决90%以上的情况：

问题现象可能原因排查步骤与解决方案
WIFI无法打开，ip link show wlan0显示DOWN1. 国家代码未设置或错误。
2. 硬件被软屏蔽（rfkill）。
3. 驱动问题。		1. 检查/etc/wpa_supplicant/wpa_supplicant.conf或/etc/default/crda中的country=设置。
2. 运行sudo rfkill list all，如果WLAN显示Soft blocked: yes，则执行sudo rfkill unblock wifi。
3. 对于USB网卡，检查驱动是否安装成功lsmod | grep 驱动名。
扫描不到WIFI网络（sudo iwlist wlan0 scan无结果）1. 国家代码问题（最常见）。
2. 网卡不支持某些信道。
3. 路由器设置了隐藏SSID。		1.首要检查国家代码，确保正确且生效（重启wpa_supplicant）。
2. 尝试在路由器后台将信道固定在1, 6, 11。
3. 在wpa_supplicant.conf的network块中添加scan_ssid=1。
能扫描到网络，但连接失败/超时1. 密码错误。
2. 加密方式不匹配。
3. 信号太弱。
4. DHCP获取IP失败。		1. 用wpa_passphrase生成加密PSK替换明文密码。
2. 确认路由器加密是WPA2-PSK (AES)，在配置中key_mgmt=WPA-PSK,pairwise=CCMP。
3. 拉近距离或调整天线。
4. 尝试为wlan0设置静态IP，排除DHCP问题。
热点创建失败，hostapd服务启动失败1. 网卡不支持AP模式。
2.hostapd.conf配置文件语法错误。
3. 选择的信道不被允许（国家代码限制）。
4. 端口被占用（如NetworkManager）。		1.sudo iw list | grep “AP”确认支持。
2.sudo hostapd -dd /etc/hostapd/hostapd.conf前台调试，看具体报错。
3. 尝试更换信道（1,6,11）。
4. 停止NetworkManager：sudo systemctl stop NetworkManager; sudo systemctl disable NetworkManager(注意：这会禁用图形化网络管理)。
设备能连接热点，但获取不到IP地址1.dnsmasq未运行或配置错误。
2. 防火墙阻止了DHCP请求（端口67）。
3.wlan0的静态IP没设置好。		1.sudo systemctl status dnsmasq查看状态和日志。
2. 暂时关闭防火墙测试：sudo systemctl stop ufw(如果用了UFW)。
3.ip addr show wlan0确认IP是192.168.4.1/24。
设备能获取IP，但无法上网（NAT失败）1. IP转发未开启。
2. iptables NAT规则错误或未保存。
3. 派本身的外网接口（eth0）没网。		1.cat /proc/sys/net/ipv4/ip_forward确认是1。
2.sudo iptables -t nat -L -n -v查看NAT规则。
3. 在派上ping 8.8.8.8，确保派自己能上网。
USB网卡识别不到或频繁断开1. 供电不足。
2. USB端口接触不良或带宽不足。
3. 驱动不稳定。		1. 使用带额外供电的USB Hub，或更换更大功率的电源。
2. 换一个USB口试试，避免使用USB Hub。
3. 尝试更新或回滚驱动版本，查看内核日志dmesg | grep usb或dmesg | grep 芯片名。

最后分享一个我自己的习惯：在折腾网络配置，尤其是iptables规则之前，先运行sudo iptables-save > ~/iptables.backup备份当前规则。一旦配置乱了，可以sudo iptables-restore < ~/iptables.backup快速恢复。对于重要的系统配置文件，如/etc/network/interfaces，/etc/dhcpcd.conf，在修改前也务必先sudo cp 原文件 原文件.bak做一个备份。这些小小的习惯，能在你调试得焦头烂额时，给你一个全身而退的机会。

编程学习 学习日记 实战经验
← 返回列表