Ubuntu 22.04 Netplan配置后网络无法连接

Question

在Ubuntu 22.04中，使用Netplan配置网络后出现无法连接的问题，常见于YAML配置文件格式错误或网络设备名称识别不正确。例如，用户误将网卡名称写为`eth0`，而系统实际使用`ens33`等命名规则，导致网络接口未被正确启用。此外，缩进不当、冒号缺失或多余空格等YAML语法错误也会使配置失效，系统无法生成有效的网络设置。此类问题常表现为重启后网络丢失或SSH连接中断。

Answer 1

1. 问题现象与典型表现

在Ubuntu 22.04系统中，使用Netplan进行网络配置后出现无法连接的问题是运维和系统工程师常见的痛点。最典型的症状包括：

• 系统重启后网络接口未激活，IP地址未分配
• SSH远程连接中断，无法重新接入服务器
• ping命令无响应，外网或网关不可达
• ip a 显示网卡处于DOWN状态
• 系统日志中出现failed to bring up interface等错误信息

这些问题往往并非由硬件故障引起，而是源于Netplan配置文件的语义或语法错误。

2. 常见错误类型分析

Netplan依赖YAML格式定义网络拓扑，而YAML对格式极为敏感。以下是两类高频错误：

2.1 网络设备名称识别错误

传统习惯中，用户倾向于使用eth0作为网卡名称，但现代Linux系统（包括Ubuntu 22.04）采用基于固件、拓扑结构的可预测命名规则（Predictable Network Interface Names），实际设备名可能为：

命名前缀	含义
ensXX	PCI热插拔索引号（如ens33）
enpXsY	PCI总线/插槽编号（如enp0s3）
wlpXsY	无线网卡

若配置中仍使用eth0，而系统实际为ens33，则该接口将被忽略。

2.2 YAML语法错误

YAML依赖缩进表达层级结构，常见错误包括：

• 使用Tab代替空格
• 冒号后缺少空格
• 嵌套层级缩进不一致
• 多余空格导致键值解析失败

这些看似微小的格式问题会导致Netplan无法正确解析配置文件。

3. 诊断流程与排查步骤

为系统性定位问题，建议按以下顺序执行检查：

1. 确认当前活动网卡名称：ip link show
2. 查看Netplan配置文件路径：/etc/netplan/*.yaml
3. 验证YAML语法：sudo netplan try
4. 应用配置并观察输出：sudo netplan apply
5. 检查系统日志：journalctl -u systemd-networkd
6. 测试连通性：ping 8.8.8.8
7. 确认路由表：ip route show

4. 正确配置示例与代码实现

以下是一个适用于静态IP配置的Netplan示例文件：

# /etc/netplan/01-netcfg.yaml
network:
  version: 2
  renderer: networkd
  ethernets:
    ens33:
      dhcp4: false
      addresses:
        - 192.168.1.100/24
      gateway4: 192.168.1.1
      nameservers:
        addresses:
          - 8.8.8.8
          - 1.1.1.1
    

注意：所有缩进必须使用空格，且层级对齐严格。

5. 自动化检测与流程图辅助

为提升排查效率，可构建如下决策流程：

graph TD
            A[网络连接失败] --> B{能否本地登录?}
            B -->|是| C[执行 ip link show]
            B -->|否| D[通过KVM/IPMI访问]
            C --> E[确认网卡名称是否匹配配置]
            E -->|不匹配| F[修改Netplan中的interface name]
            E -->|匹配| G[运行 netplan try]
            G --> H{语法正确?}
            H -->|否| I[修正YAML格式]
            H -->|是| J[执行 netplan apply]
            J --> K[测试网络连通性]

6. 高级调试技巧

对于资深工程师，可结合以下手段深入分析：

• 启用Netplan调试模式：NETPLAN_DEBUG=1 netplan apply
• 查看生成的systemd-networkd配置：/run/systemd/network/
• 使用netplan generate预生成配置而不立即应用
• 对比udevadm info -e | grep ID_NET_NAME获取设备命名依据

这些方法有助于理解Netplan如何将YAML转换为底层网络服务指令。