手动配置IPv4地址后设置无法保存，常见原因是什么？

Question

手动配置IPv4地址后设置无法保存，常见原因包括：① 网络管理服务冲突（如NetworkManager与netplan/systemd-networkd共存导致配置被覆盖）；② 配置文件语法错误或权限不足（如`/etc/netplan/*.yaml`缩进错误、未执行`sudo netplan apply`）；③ DHCP客户端仍在后台运行（如dhcpcd、dhclient未禁用，重启后自动覆盖静态配置）；④ 图形界面网络管理器（如GNOME Settings、KDE NetworkManager）优先级高于底层配置，其GUI设置会覆盖手动修改；⑤ 虚拟机或云平台（如VMware、AWS）启用DHCP强制策略，或存在cloud-init在启动时重写网络配置。排查建议：检查`journalctl -u systemd-networkd --no-pager -n 50`日志，确认配置生效时机；使用`ip a`和`nmcli dev show`对比实际IP与预期；禁用无关网络服务并统一配置入口。根本原则：确保单一网络管理源，且配置持久化机制（如netplan apply、ifupdown reload）已正确触发。

Answer 1

```html

一、现象层：静态IP配置“看似成功”却重启失效

执行 sudo ip addr add 192.168.1.100/24 dev eth0 && sudo ip link set eth0 up 后，ip a 显示地址已存在，但系统重启或网络服务重载后消失。该现象非命令失败，而是持久化机制未触发——本质是配置未写入声明式管理模型，仅停留在运行时内核态。

二、服务层：多网络管理器共存引发的“配置竞态”

服务名	默认启用场景	冲突表现	诊断命令
NetworkManager	桌面版Ubuntu/Debian（GNOME/KDE）	覆盖 netplan 渲染的 systemd-networkd 配置	systemctl is-active NetworkManager
systemd-networkd	Server版Ubuntu 18.04+、CoreOS	忽略 /etc/network/interfaces，但被 NM 降级禁用	systemctl is-active systemd-networkd

关键原则：二者不可并行接管同一物理接口。验证方式：nmcli dev status 中若某接口显示 unmanaged，说明已被其他服务声明接管。

三、配置层：Netplan YAML 的“隐形语法雷区”

以下为典型错误示例（缩进、空格、键名大小写均敏感）：

# ❌ 错误：使用 Tab 缩进、gateway4 拼写错误、缺少 renderer
network:
  version: 2
  ethernets:
    eth0:
      dhcp4: false
      addresses: ["192.168.1.100/24"]
      gatway4: 192.168.1.1  # ← 拼写错误！应为 gateway4
      nameservers:
          addresses: [8.8.8.8]

✅ 正确做法：用 yamllint -d "{extends: [core], rules: {indentation: {spaces: 2}}}" /etc/netplan/*.yaml 静态校验；且必须执行 sudo netplan apply --debug 查看渲染生成的 /run/systemd/network/ 下真实 unit 文件。

四、进程层：DHCP 守护进程的“幽灵覆盖”

即使禁用 DHCP，残留进程仍可劫持接口：

• ps aux | grep -E "(dhclient|dhcpcd)" → 发现 dhclient -sf /usr/lib/NetworkManager/nm-dhcp-helper eth0
• sudo systemctl stop dhcpcd.service dhclient.service（如存在）
• 永久禁用：sudo systemctl disable dhcpcd dhclient 并检查 /etc/dhcp/dhclient.conf 是否含 request subnet-mask, routers; 等强制请求项

五、平台层：云环境与虚拟化的“策略覆盖”

graph TD
  A[系统启动] --> B{cloud-init 是否启用？}
  B -->|是| C[读取 /var/lib/cloud/instance/network-config]
  C --> D[覆盖 /etc/netplan/*.yaml]
  B -->|否| E[执行 netplan apply]
  D --> F[最终生效配置 = cloud-init 输出]
  E --> F
  F --> G[对比 ip a vs nmcli dev show]

在 AWS EC2 或 VMware Cloud Director 中，需检查：sudo cloud-init status --long；若活跃，应修改 /etc/cloud/cloud.cfg.d/99-disable-network.cfg 添加 network: {config: disabled}，再 sudo cloud-init clean --reboot。

六、验证层：交叉比对法确认真实配置源

执行以下三命令并比对输出一致性：

1. ip -br addr show eth0 → 内核实际地址
2. nmcli dev show eth0 | grep IP4.ADDRESS → NetworkManager 视图
3. sudo networkctl status eth0 → systemd-networkd 管理状态

若三者不一致，说明存在多源管理；此时必须通过 sudo networkctl unmanage eth0 或 nmcli dev set eth0 managed no 显式解除某一方管辖权。

七、根治层：单一权威模型落地 checklist

• ✅ 卸载冗余服务：sudo apt purge ifupdown network-manager（Server 场景）
• ✅ 统一 renderer：renderer: networkd 或 renderer: NetworkManager 二选一
• ✅ 权限加固：sudo chmod 600 /etc/netplan/*.yaml 防 GUI 工具静默覆盖
• ✅ 启动时验证：sudo systemctl edit systemd-networkd-wait-online.service 加入 ExecStartPre=/usr/bin/netplan apply

```