Ubuntu 22网络接口配置常见问题解析

Question

在Ubuntu 22.04中，使用Netplan进行网络接口配置时，常见的技术问题之一是**如何正确配置静态IP地址并确保网络连通性**。许多用户在修改`/etc/netplan/`下的YAML配置文件后，执行`netplan apply`命令时遇到“Invalid YAML”或“Network is unreachable”等错误提示。问题通常源于YAML语法格式不正确（如缩进错误、冒号后缺少空格）或网关、DNS配置不当。此外，部分用户在虚拟机或云环境中更改IP后未刷新网络服务或重启系统，导致配置未生效。掌握Netplan的语法规则和调试方法，是解决此类网络配置问题的关键。

Answer 1

1. Netplan配置基础与静态IP设置

Netplan 是 Ubuntu 从 17.10 版本开始引入的网络配置工具，它使用 YAML 格式定义网络接口的配置。在 Ubuntu 22.04 中，Netplan 成为默认的网络管理方式。

要配置静态 IP 地址，需编辑位于 /etc/netplan/ 目录下的 YAML 文件（通常文件名为 01-netcfg.yaml 或类似名称）。

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

上述示例展示了如何为网卡 enp0s3 配置静态 IP 地址、网关和 DNS。

2. 常见问题：Invalid YAML 错误

执行 netplan apply 时出现 “Invalid YAML” 错误，通常是由于 YAML 文件格式错误所致。

• 缩进不一致或错误
• 冒号后未加空格
• 使用 Tab 而非空格
• 关键字拼写错误（如 gateway4: 写成 gatewary4:）

解决方法：

1. 使用在线 YAML 校验工具检查语法
2. 使用命令 sudo netplan try 进行安全测试
3. 逐行查看缩进是否统一（建议使用两个空格作为单位）

3. 网络不可达：“Network is unreachable”

当配置完成后执行 ping www.example.com 失败，并提示“Network is unreachable”，可能是以下原因导致：

可能原因	解决方案
网关地址配置错误	确认 gateway4 是否指向正确的路由器地址
DNS 无法解析域名	检查 nameservers.addresses 是否正确
IP 地址不在同一子网	确认 CIDR 掩码（如 /24）是否与网络匹配

此外，可在终端中运行 ip route show 检查路由表是否包含默认网关。

4. 环境相关问题：虚拟机与云平台中的网络配置

在虚拟机（如 VirtualBox、VMware）或云平台（如 AWS、Azure）中配置静态 IP 后，可能出现配置未生效的情况。

常见原因包括：

• 虚拟化平台本身限制了 MAC 地址绑定
• 云平台自动分配 DHCP 地址覆盖了本地配置
• 未重启网络服务或系统

推荐做法：

• 在云平台中使用官方推荐的静态 IP 设置方式（如 AWS 使用 ENI 绑定）
• 修改 Netplan 后执行 sudo netplan apply 而非仅重启网络服务
• 若不确定配置是否生效，可重启系统进行验证

5. Netplan 调试技巧与最佳实践

为了高效排查 Netplan 配置问题，可以采用以下调试手段：

sudo netplan apply --debug

该命令会输出详细的日志信息，有助于定位问题源头。

其他建议：

• 备份原始配置文件再进行修改
• 使用版本控制工具（如 Git）管理 Netplan 配置
• 避免直接在生产环境中修改配置，应先在测试环境中验证

流程图如下所示，描述了 Netplan 静态 IP 配置的完整调试路径：

graph TD
            A[编辑 /etc/netplan/*.yaml] --> B{语法是否正确?}
            B -->|是| C[执行 netplan apply]
            B -->|否| D[修正 YAML 缩进或拼写错误]
            C --> E{网络是否可达?}
            E -->|是| F[完成]
            E -->|否| G[检查网关/DNS/IP范围]
            G --> H[重新应用配置或重启系统]