经验 - Wizard Doc

最后修改人	孙荣利
最后修改时间	2026-10-03 15:36:26
创建人	孙荣利
创建时间	2026-10-03 15:23:10

该文档由孙荣利创建于 2026-10-03 15:23:10 ，孙荣利在 2026-10-03 15:36:26 修改了该文档。

[TOCM]

## 一、简介

```text
问题：Ubuntu 云服务器每次重启后，手动配置的 IP 会被自动改回（网卡配置失效）。
原因：Ubuntu 的 /etc/netplan/50-cloud-init.yaml 由 cloud-init 数据源自动生成，重启后被覆盖还原，导致静态 IP 配置无法持久化。
方案：禁用 cloud-init 的自动网络配置能力，改用 netplan 静态配置，配置完成后重启验证。
```

## 二、操作步骤

#### 1. 查看现有网络配置（官方说明）

```shell
cat /etc/netplan/50-cloud-init.yaml
```

文件头部官方注释翻译：本文件由云初始化数据源自动生成。你对本文件的所有修改，在服务器重启后全部失效、被覆盖还原。官方自带永久禁用方案，就是创建这个配置文件：`/etc/cloud/cloud.cfg.d/99-disable-network-config.cfg`，内容：`network: {config: disabled}`。

文件内容示例（当前生效的静态 IP 配置）：

```yaml
network:  # 网络配置根节点
    ethernets:  # 以太网接口定义
        ens33:  # 网卡名称（VMware 虚拟机 ens33 网卡）
            addresses:  # IP 地址列表
            - 192.168.51.76/24  # 静态 IP/掩码
            nameservers:  # DNS 配置
                addresses:  # DNS 服务器地址列表
                - 192.168.51.22  # 内网 DNS
                - 223.5.5.5  # 阿里公共 DNS
                - 223.6.6.6  # 阿里公共 DNS
                search: []  # DNS 搜索域（无）
            routes:  # 路由配置
            -   to: default  # 默认路由（0.0.0.0/0）
                via: 192.168.51.1  # 默认网关
    version: 2  # netplan 配置版本
```

#### 2. 禁用 cloud-init 自动配置网络

```shell
# 创建禁用 cloud-init 网络配置能力的文件（> /dev/null 静默不输出）
# 注意：官方推荐文件名为 99-disable-network-config.cfg，当前文件名同样生效（cloud-init 读取该目录下所有 .cfg 文件）
sudo tee /etc/cloud/cloud.cfg.d/99-disable-network.cfg >/dev/null <<EOF
network: {config: disabled}
EOF
```

#### 3. 清理 cloud-init 旧缓存

```shell
# 清理 cloud-init 缓存状态（含旧的网络配置缓存，避免残留干扰新配置）
sudo cloud-init clean
```

#### 4. 校验网络配置语法

```shell
# 预演应用：若配置有误或 SSH 断连，会在超时后自动回滚，相对安全
sudo netplan try
```

#### 5. 应用配置

```shell
# 正式应用 netplan 配置
sudo netplan apply
```

#### 6. 重启验证

```shell
sudo reboot
```

重启后确认 IP 保持静态配置、未被改回：

```shell
# 应显示 192.168.51.76/24
ip addr show ens33
```