Ubuntu 20.04 WiFi + Netplan + SSH 修复指南

概述

本配置适用于 Ubuntu 20.04 嵌入式系统（Raspberry Pi / Jetson 类设备）。系统最初存在：

错误启动后无 WiFi 连接
错误 hostname -I 输出为空
错误网络初始化导致启动延迟
错误其他设备无法 SSH 访问

目标：
通过启用稳定 WiFi 连接
通过保持静态 Ethernet 配置
通过确保自动 IP 分配
通过可靠恢复 SSH 访问

警告初始问题

1. WiFi 未自动连接

wlan0 存在但：
• 保持在 DOWN 状态
• 未获得 DHCP IP
• 未自动连接到 SSID

2. 缺少 IP 地址

hostname -I

返回空 → 未获得 DHCP 租约，WiFi 接口未完全连接。

3. Netplan 配置错误

早期尝试因以下原因失败：
• 错误 YAML 缩进错误
• 错误 wlan0 放置位置错误
• 错误缺少 wifis: 块
• 错误无效键结构

4. DHCP 未自动触发

即使 WiFi 接口 UP，系统仍需手动 DHCP：
sudo dhclient wlan0

逐步修复

Step 1 — 修复 netplan 结构

系统使用 renderer: networkd

network:
 version: 2
 renderer: networkd

 ethernets:
 eth0:
 dhcp4: no
 addresses: [192.168.1.130/24]
 gateway4: 192.168.1.1
 nameservers:
 addresses: [8.8.8.8, 1.1.1.1]

 wifis:
 wlan0:
 dhcp4: true
 optional: true
 access-points:
 "CMCC-7135":
 password: "88888888"
 dhcp4-overrides:
 use-dns: true
 use-routes: true

Step 2 — 安全验证配置

sudo netplan try

通过临时测试配置 · 网络失败时自动回滚

Step 3 — 应用配置

sudo netplan apply

Step 4 — 手动解决 DHCP（测试期间临时方案）

sudo dhclient wlan0

DHCPDISCOVER → DHCPOFFER → DHCPREQUEST → DHCPACK
通过绑定到 192.168.1.37

Step 5 — 验证网络状态

ip a
hostname -I

通过 WiFi 接口 UP · IP 分配成功

Step 6 — SSH 验证

网络修复后：
• 设备在 LAN/WiFi 上可达
• 其他 PC SSH 访问成功恢复

根本原因分析

问题不是硬件故障，而是：

错误 Netplan 结构错误
错误缺少 WiFi 配置块
错误 systemd-networkd 下 DHCP 未自动触发
错误早期尝试中的 YAML 缩进问题

最终系统状态

Ethernet： 静态 IP 192.168.1.130
WiFi： 自动连接 SSID，DHCP IP 自动分配
网络： 稳定连接，无启动挂起，无需手动干预
SSH： 外部机器完全可访问

关键经验

• Netplan 对 YAML 格式极为严格
• wifis: 必须正确嵌套在 network 下
• networkd 可能需要手动 DHCP 调优
• netplan try 对于嵌入式系统避免锁定至关重要
• 手动 dhclient 对调试 DHCP 问题非常有用

结果

网络完全就绪
SSH 可访问
WiFi + Ethernet 双模稳定
适用于机器人 / Jetson 部署

平台：Ubuntu 20.04 · Jetson / Raspberry Pi · Netplan · systemd-networkd
(c) 卓博泰科技 · WiFi + Netplan + SSH 修复指南

Related Drobotics guides