Ubuntu 网络配置

运行时配置无线网络｜Ubuntu 26.04+

适用于系统已安装运行（cloud-init 已完成），通过有线 SSH 登录后添加 / 切换 WiFi 的场景。

1. 查看当前 netplan 配置

sudo cat /etc/netplan/50-cloud-init.yaml

典型输出（有线已配置，WiFi 未配置）：

network:
  version: 2
  ethernets:
    eth0:
      optional: true
      dhcp4: true

2. 编辑 netplan 添加 WiFi

sudo vi /etc/netplan/50-cloud-init.yaml

在文件末尾追加 WiFi 配置：

  wifis:
    wlan0:
      dhcp4: true
      dhcp6: false
      optional: true
      access-points:
        "WiFi名称":
          password: "WiFi密码"

cloud-init 只在首次启动时运行，status: done 之后直接修改 netplan 文件即可，不会被覆盖。

3. 应用配置

sudo netplan apply

4. 触发 WiFi 连接

netplan apply 生成配置到 /run/systemd/network/，但如果 wlan0 处于 NO-CARRIER 状态，systemd-networkd 不会自动尝试连接，需要手动触发：

sudo networkctl reconfigure wlan0

5. 验证连接

networkctl status wlan0

关键输出：

Wi-Fi access point: MyWiFi (xx:xx:xx:xx:xx:xx)
Address: 192.168.x.x (DHCPv4 via 192.168.x.1)
Gateway: 192.168.x.1

排查

• sudo wpa_cli status 查看 wpa_supplicant 端的连接状态
• ls /run/netplan/wpa-*.conf 确认 netplan 生成了 wpa_supplicant 配置
• cat /sys/class/rfkill/*/state 检查是否被软屏蔽（输出 1 = 未屏蔽）

更多故障排查参考 Ubuntu 网络配置故障排查