Ubuntu Netplan配置IP后无法生效？

Question

在使用Ubuntu Netplan配置静态IP后，网络无法生效是常见问题。典型表现为修改`/etc/netplan/*.yaml`文件并执行`netplan apply`后，IP地址未按预期更改或网络连接中断。可能原因包括：YAML语法错误（如缩进不当、冒号格式错误）、网卡名称识别错误（如误将`ens33`写成`eth0`）、未正确指定`dhcp4: no`导致DHCP覆盖静态配置，或Netplan未正确渲染配置。此外，某些系统因缺少`networkd`或`NetworkManager`后端服务也会导致应用失败。需通过`journalctl -u systemd-networkd`排查服务状态，并使用`ip a`验证实际接口配置。

Answer 1

Ubuntu Netplan 静态IP配置失效问题深度解析与实战指南

1. 问题背景与典型表现

在现代 Ubuntu 系统中（尤其是 18.04 及以上版本），Netplan 已成为网络配置的标准工具。它通过声明式 YAML 文件统一管理网络接口，但在实际运维过程中，配置静态 IP 后网络无法生效是高频问题。

典型表现为：

• 执行 netplan apply 后，IP 地址未按预期更改
• 系统重启后网络中断或回退到 DHCP 地址
• ip a 显示接口仍为动态获取状态
• 远程 SSH 连接断开且无法重连

此类问题若发生在生产服务器上，可能导致严重服务中断。

2. 常见原因分类分析

类别	具体原因	影响机制
语法错误	YAML 缩进不一致、冒号后缺少空格	Netplan 解析失败，配置未加载
设备识别	网卡名错误（如 eth0 vs ens33）	目标接口未被正确绑定
DHCP 冲突	未设置 dhcp4: no	DHCP 覆盖静态配置
后端缺失	systemd-networkd 或 NetworkManager 未启用	配置无法渲染到底层
权限问题	文件属主或权限错误	netplan 无法读取配置

3. 排查流程图：从表象到根因

graph TD
    A[网络不通或IP未变] --> B{是否执行 netplan apply?}
    B -->|否| C[执行 sudo netplan apply]
    B -->|是| D[检查 ip a 查看实际IP]
    D --> E{IP是否正确?}
    E -->|否| F[检查 /etc/netplan/*.yaml 语法]
    F --> G[使用 yamllint 验证]
    G --> H[确认网卡名称是否准确]
    H --> I[检查 dhcp4: no 是否设置]
    I --> J[查看 journalctl -u systemd-networkd]
    J --> K{服务是否运行正常?}
    K -->|否| L[启用并启动 systemd-networkd]
    K -->|是| M[检查后端 renderer 设置]
    M --> N[最终验证配置渲染结果]
    

4. 深度技术排查步骤

1. 验证当前网络状态：
   使用 ip a 查看接口实际分配的 IP 和状态，确认是否仍由 DHCP 控制。
2. 检查 Netplan 配置文件语法：
   yamllint /etc/netplan/*.yaml 可检测缩进、冒号格式等常见错误。
3. 确认网卡名称准确性：
   通过 ls /sys/class/net/ 或 ip link show 获取真实接口名，避免传统 eth0 的思维惯性。
4. 确保禁用 DHCPv4：
   必须显式设置 dhcp4: no，否则即使配置了 addresses，DHCP 仍可能覆盖。
5. 查看后端服务日志：
   执行 journalctl -u systemd-networkd --since "5 minutes ago"，观察应用时的错误输出。
6. 确认 renderer 正确性：
   若系统使用 NetworkManager，则需在 yaml 中指定 renderer: NetworkManager。
7. 测试配置渲染结果：
   使用 netplan --debug generate 查看生成的 networkd 配置文件内容。
8. 检查文件权限：
   Netplan 配置应为 root:root，权限 600，避免被意外修改。
9. 重启网络服务：
   在关键场景下，可尝试 systemctl restart systemd-networkd 强制重载。
10. 备份与恢复策略：
    修改前备份原文件，如 cp /etc/netplan/01-netcfg.yaml{,.bak}。

5. 典型配置示例与对比

以下是一个正确的静态 IP 配置示例（基于 ens33 接口）：

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

常见错误写法包括：

• 缩进错误：addresses 下级未正确缩进 4 格
• 遗漏 dhcp4: no，导致地址短暂生效后被 DHCP 覆盖
• 使用 eth0 而非实际的 ens33 或 enp0s3
• gateway4 写成 gateway，导致路由未设置