Linux · 19 9 月, 2026 0

Raspberry Pi OS Lite无图形界面如何连接Wi-Fi(命令速查)

💻操作环境

本文介绍命令适用于版本为 Debian 13 (trixie) 的Raspberry Pi OS Lite。使用其他版本的小伙伴也可以试试。

📡常用命令

开关与扫描

  • 打开 Wi-Fi:nmcli radio wifi on
  • 关闭 Wi-Fi:nmcli radio wifi off
  • 列出可见 Wi-Fi:nmcli device wifi list
  • 强制重新扫描:nmcli device wifi rescan

连接与断开

  • 连接指定 Wi-Fi:nmcli device wifi connect "SSID" password "密码"
  • 连接一个已保存的 Wi-Fi:nmcli connection up "连接名"
  • 断开一个已保存的 Wi-Fi:nmcli connection down "连接名"

连接配置管理

  • 查看全部已保存的 Wi-Fi:nmcli connection show
  • 删除(忘掉)一个已保存的 Wi-Fi:nmcli connection delete "连接名"
  • 修改一个已保存的 Wi-Fi 属性:
# 示例
nmcli connection modify "连接名" \
  ipv4.method manual \
  ipv4.addresses "192.168.1.50/24" \
  ipv4.gateway "192.168.1.1" \
  ipv4.dns "192.168.1.1 8.8.8.8"

🚀进阶玩法:脚本化

下面这段脚本实现的是:扫描 Wi-Fi,直到 SSID 为 MYSSID 出现时自动连接。

#!/bin/bash

# === 在这里修改你的 Wi-Fi 信息 ===
SSID="MYSSID"
PASSWORD="XXXXX"
# =================================

# 等待 wlan0 就绪
while ! ip link show wlan0 &>/dev/null; do sleep 1; done

# 等待扫描到目标 SSID
while ! nmcli -t -f SSID device wifi list | grep -q "^${SSID}$"; do
    nmcli device wifi rescan
    sleep 3
done

# 连接
nmcli device wifi connect "${SSID}" password "${PASSWORD}"

如果你配置了诸如 OverlayFS 这样的只读文件系统,无法保存 Wi-Fi 信息,亦或是你希望能在开机时连接 Wi-Fi 后有序进行进一步的操作,那么这段脚本可能会很有帮助。