Ubuntu Server 20.04 网卡无法启动，配置文件 netplan 错误如何解决？

Question

在Ubuntu Server 20.04中，如果网卡无法启动且提示Netplan配置错误，通常是因为`/etc/netplan/`目录下的YAML配置文件存在语法或设置问题。例如，错误的缩进、缺失的字段或不正确的网络参数都可能导致此问题。 常见问题包括：1) YAML文件缩进不正确（需使用空格而非制表符）；2) 配置中未指定正确的网卡名称或IP地址；3) renderer设置错误（如选择networkd或NetworkManager不匹配实际需求）。 解决方法如下：首先，检查Netplan配置文件（如`01-netcfg.yaml`），确保格式正确。例如，基本静态IP配置应包含`network:`、`ethernets:`等字段，并正确设置`addresses:`、`gateway4:`和`nameservers:`。其次，运行`netplan try`测试配置是否有效，若无误则应用配置（`netplan apply`）。最后，重启网络服务或系统以确认网卡正常启动。若问题依旧，可通过`journalctl -xe`查看详细错误日志进行排查。

Answer 1

1. 问题概述

在Ubuntu Server 20.04中，如果网卡无法启动且提示Netplan配置错误，通常是因为`/etc/netplan/`目录下的YAML配置文件存在语法或设置问题。以下是可能导致此问题的常见原因：

• YAML文件缩进不正确（需使用空格而非制表符）。
• 配置中未指定正确的网卡名称或IP地址。
• renderer设置错误（如选择networkd或NetworkManager不匹配实际需求）。

了解这些基础问题后，我们可以通过以下步骤逐步排查和解决问题。

2. 配置文件检查

首先，我们需要检查Netplan配置文件（如`01-netcfg.yaml`），确保其格式正确。一个基本的静态IP配置示例如下：

network:
  version: 2
  ethernets:
    eth0:
      dhcp4: no
      addresses:
        - 192.168.1.100/24
      gateway4: 192.168.1.1
      nameservers:
        addresses:
          - 8.8.8.8
          - 8.8.4.4

确保上述字段完整无误，并且注意YAML文件的缩进必须使用空格，不能使用制表符。

3. 测试与应用配置

完成配置文件修改后，可以运行以下命令测试配置是否有效：

sudo netplan try

如果测试成功，可以正式应用配置：

sudo netplan apply

接下来，重启网络服务或整个系统以确认网卡能够正常启动：

sudo systemctl restart networking

或者直接重启系统：

sudo reboot

4. 错误日志分析

如果问题仍未解决，可以通过查看系统日志进一步排查：

sudo journalctl -xe

以下是可能的日志输出示例：

日志信息	可能原因
netplan: /etc/netplan/01-netcfg.yaml: Invalid YAML syntax	YAML文件缩进错误或包含非法字符。
netplan: Failed to start Network Service	网卡名称或IP地址配置错误。
netplan: renderer 'NetworkManager' not found	选择了不支持的renderer。

5. 排查流程图

以下是完整的排查流程图：

graph TD;
        A[网卡无法启动] --> B{Netplan配置错误?};
        B -- 是 --> C[检查配置文件];
        C --> D[修正YAML语法];
        C --> E[确认网卡名称和IP];
        C --> F[调整renderer设置];
        B -- 否 --> G[查看系统日志];
        G --> H[定位其他问题];