树莓派无屏幕启动的WiFi配置全攻略：从基础配置到隐藏网络连接

树莓派作为一款功能强大的微型计算机，广泛应用于物联网、智能家居、教育等领域。但对于许多初次接触树莓派的开发者来说，如何在无显示器、键盘和鼠标的情况下完成初始配置，尤其是WiFi连接，往往成为第一个需要跨越的技术门槛。本文将深入探讨如何通过 wpa_supplicant.conf 文件实现树莓派的无屏幕WiFi配置，包括常规网络和隐藏网络的连接方法，以及常见问题的排查技巧。

1. 准备工作与基础概念

在开始配置之前，我们需要了解几个关键概念和准备工作。树莓派的无屏幕启动通常被称为"无头模式"(Headless Mode)，这种模式下，我们需要通过预先配置SD卡来实现开机即连WiFi的功能。

首先，你需要准备以下物品：

• 一台树莓派（任何型号，但建议使用3B+或更新版本以获得更好的WiFi性能）
• 一张已烧录树莓派官方操作系统（如Raspberry Pi OS）的microSD卡
• 一台可以读写SD卡的电脑（Windows、macOS或Linux均可）
• 可靠的WiFi网络信息（SSID和密码）

关键文件位置 ： 树莓派启动时，会首先读取 boot 分区中的 wpa_supplicant.conf 文件。这个分区在Windows和macOS上都是可直接访问的FAT32格式分区，无需特殊工具即可编辑文件。

注意：从Raspberry Pi OS Bullseye开始，网络配置方式有所变化，但本文介绍的方法仍然有效，且兼容性更好。

2. 创建基础wpa_supplicant.conf文件

让我们从最基本的WiFi配置开始。在SD卡的 boot 分区根目录下创建一个名为 wpa_supplicant.conf 的文本文件，内容如下：

country=CN
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1

network={
    ssid="你的WiFi名称"
    psk="你的WiFi密码"
}

这个配置文件包含几个关键部分：

1. country=CN ：设置国家代码（中国为CN），这会影响WiFi信道选择
2. ctrl_interface 和 update_config ：允许网络配置的更新和修改
3. network 块：定义要连接的WiFi网络

文件保存注意事项 ：

• 确保文件扩展名是 .conf ，而不是 .txt
• 使用纯文本编辑器（如Notepad++、VS Code）创建文件，避免使用Word等富文本编辑器
• 文件编码应为UTF-8，避免特殊字符问题

3. 高级配置选项

基础配置能满足大多数需求，但实际使用中我们可能需要更复杂的配置。以下是几种常见的高级配置场景：

3.1 连接隐藏网络

隐藏网络不会广播其SSID，因此需要额外配置：

network={
    ssid="隐藏网络名称"
    psk="密码"
    scan_ssid=1
}

scan_ssid=1 告诉树莓派主动扫描并连接这个隐藏网络。

3.2 多网络配置与优先级

可以配置多个网络，并为它们设置优先级：

network={
    ssid="办公室WiFi"
    psk="office123"
    priority=5
}

network={
    ssid="家庭WiFi"
    psk="home456"
    priority=1
}

priority 值越高，连接优先级越高。当多个配置的网络都可用时，树莓派会选择优先级最高的连接。

3.3 企业网络配置

对于使用WPA-EAP的企业网络，配置略有不同：

network={
    ssid="公司网络"
    key_mgmt=WPA-EAP
    eap=PEAP
    identity="你的用户名"
    password="你的密码"
    phase2="auth=MSCHAPV2"
}

4. 验证与问题排查

配置完成后，如何确认树莓派已成功连接WiFi？以下是几种验证方法：

4.1 首次启动检查

1. 将配置好的SD卡插入树莓派并通电
2. 等待约1-2分钟让系统完成初始化
3. 检查路由器管理界面，查看是否有新设备连接

4.2 通过SSH连接验证

如果已启用SSH（在boot分区创建名为 ssh 的空文件即可），可以尝试连接：

ssh pi@raspberrypi.local

默认密码为 raspberry 。

4.3 常见问题排查

问题1：树莓派无法连接WiFi

解决方案：

• 确认SSID和密码正确
• 检查国家代码设置是否正确
• 尝试将配置移动到 /etc/wpa_supplicant/wpa_supplicant.conf （需要先通过有线网络连接）

问题2：连接不稳定或速度慢

解决方案：

• 在配置中添加明确的频段偏好：

network={
    ssid="你的WiFi"
    psk="密码"
    freq_list=2412 2437 2462
}

• 更新树莓派系统： sudo apt update && sudo apt upgrade

问题3：无法解析主机名

解决方案：

• 检查DNS设置，可以尝试使用公共DNS：

interface wlan0
static domain_name_servers=8.8.8.8 8.8.4.4

5. 安全最佳实践

在配置WiFi连接时，安全同样重要。以下是几个安全建议：

1. 避免明文密码 ：可以使用 wpa_passphrase 生成加密的PSK：

wpa_passphrase "你的SSID" "你的密码"

这将输出一个包含加密PSK的network配置块。

2. 文件权限设置 ：确保配置文件权限正确：

sudo chmod 600 /etc/wpa_supplicant/wpa_supplicant.conf

3. 定期更新 ：保持系统更新以获取最新的安全补丁：

sudo apt update && sudo apt upgrade -y

4. 禁用不必要服务 ：如果不需要蓝牙，可以禁用：

sudo systemctl disable bluetooth

6. 自动化脚本与进阶技巧

对于需要频繁配置多台树莓派的用户，可以创建自动化脚本简化流程。

6.1 自动配置脚本示例

创建一个 setup_wifi.sh 脚本：

#!/bin/bash

SSID=$1
PASSWORD=$2

CONFIG_FILE="/etc/wpa_supplicant/wpa_supplicant.conf"

if [ ! -f "$CONFIG_FILE" ]; then
    echo "country=CN" > "$CONFIG_FILE"
    echo "ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev" >> "$CONFIG_FILE"
    echo "update_config=1" >> "$CONFIG_FILE"
fi

wpa_passphrase "$SSID" "$PASSWORD" | sudo tee -a "$CONFIG_FILE" > /dev/null
sudo wpa_cli -i wlan0 reconfigure

使用方法： sudo ./setup_wifi.sh 你的SSID 你的密码

6.2 使用systemd服务自动重连

创建 /etc/systemd/system/wifi-reconnect.service ：

[Unit]
Description=WiFi reconnect service
After=network.target

[Service]
ExecStart=/usr/sbin/iwconfig wlan0 power off
ExecStartPost=/bin/sleep 5
ExecStartPost=/sbin/wpa_cli -i wlan0 reconfigure
Restart=on-failure
RestartSec=10s

[Install]
WantedBy=multi-user.target

然后启用服务：

sudo systemctl daemon-reload
sudo systemctl enable wifi-reconnect.service
sudo systemctl start wifi-reconnect.service

7. 性能优化与监控

确保WiFi连接稳定高效，还需要一些优化和监控措施。

7.1 信号强度监控

使用以下命令监控信号强度：

watch -n 1 "iwconfig wlan0 | grep -i quality"

7.2 最佳信道选择

查找周围最少使用的WiFi信道：

sudo iwlist wlan0 scan | grep Frequency | sort | uniq -c | sort -n

7.3 禁用电源管理

WiFi电源管理可能导致连接不稳定，禁用它可以提高可靠性：

sudo iwconfig wlan0 power off

可以将此命令添加到 /etc/rc.local 使其开机自动执行。