Ubuntu服务器静态IP配置与cloud-init禁用指南

1. 问题背景与解决思路

最近在Ubuntu服务器上配置静态IP时遇到了一个典型问题：每次重启后网络配置都会恢复默认状态。经过排查发现，这是cloud-init服务在作祟——它会自动重置网络配置。这种情况在云服务器和本地Ubuntu系统中都很常见，尤其影响那些需要固定IP的生产环境。

提示：cloud-init是Ubuntu用于初始化云实例的标准工具，但它的"热心"行为常常干扰手动网络配置。

解决这个问题的核心思路分为两个层面：

1. 阻止cloud-init干预网络配置（关键步骤）
2. 正确配置Netplan实现静态IP（常规操作）

2. 禁用cloud-init网络管理

2.1 创建屏蔽配置文件

首先需要告诉cloud-init不要插手网络配置。这通过创建特定配置文件实现：

bash复制sudo vim /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg

文件内容应为：

yaml复制network: {config: disabled}

这个配置的作用是：

• 明确禁用cloud-init的网络配置功能
• 文件命名中的"99"确保它最后加载，覆盖其他配置
• 适用于Ubuntu 16.04及更高版本

注意：如果使用其他编辑器如nano，保存时注意保留文件格式为Unix(LF)

2.2 验证配置生效

执行以下命令检查cloud-init配置：

bash复制sudo cloud-init schema --config-file /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg

正常应输出"Valid cloud-config"字样。如果报错，检查：

• YAML格式是否正确（特别注意缩进和冒号后的空格）
• 文件权限是否为644（sudo chmod 644 /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg）

3. 配置Netplan静态IP

3.1 定位网络配置文件

Ubuntu 17.10+版本使用Netplan管理网络，主配置文件通常为：

bash复制sudo vim /etc/netplan/50-cloud-init.yaml

注意：某些系统可能是其他名称如00-installer-config.yaml，可用ls /etc/netplan/查看

3.2 编写静态IP配置

典型配置示例：

yaml复制network:
    version: 2
    ethernets:
        eth0:  # 需替换为实际网卡名(用ip a命令查看)
            dhcp4: no
            addresses:
                - 192.168.1.100/24  # IP/子网掩码位数
            routes:
                - to: default
                  via: 192.168.1.1  # 网关地址
            nameservers:
                addresses: [8.8.8.8, 114.114.114.114]  # DNS服务器

关键参数说明：

• /24表示子网掩码255.255.255.0
• 网关地址通常为路由器IP
• 建议保留至少两个DNS服务器提高可靠性

3.3 应用网络配置

执行以下命令使配置生效：

bash复制sudo netplan apply

验证配置：

bash复制ip a  # 查看IP是否生效
ping google.com  # 测试网络连通性

4. 深度问题排查与优化

4.1 常见错误处理

1. netplan apply报错：

   • 检查YAML语法（特别注意缩进）
   • 使用netplan --debug apply查看详细错误

2. 重启后配置丢失：

   • 确认cloud-init确实被禁用：sudo cloud-init status
   • 检查是否有其他网络管理服务干扰（如NetworkManager）

3. DNS不解析：

   • 临时修改/etc/resolv.conf测试
   • 在Netplan中添加renderer: networkd参数

4.2 高级配置技巧

多网卡绑定配置示例：

yaml复制network:
    version: 2
    bonds:
        bond0:
            interfaces: [eth0, eth1]
            parameters:
                mode: active-backup
                primary: eth0
    ethernets:
        eth0: {}
        eth1: {}

Wi-Fi连接配置示例：

yaml复制network:
    version: 2
    wifis:
        wlan0:
            access-points:
                "SSID名称":
                    password: "无线密码"
            addresses: [192.168.1.100/24]
            gateway4: 192.168.1.1
            nameservers:
                addresses: [8.8.8.8, 8.8.4.4]

5. 持久化与系统集成

5.1 禁用cloud-init完全方案

对于非云环境，可以完全禁用cloud-init：

bash复制sudo touch /etc/cloud/cloud-init.disabled
sudo systemctl disable cloud-init

5.2 备份与恢复策略

1. 备份现有配置：

bash复制sudo cp /etc/netplan/50-cloud-init.yaml /etc/netplan/50-cloud-init.yaml.bak

2. 快速回滚命令：

bash复制sudo cp /etc/netplan/50-cloud-init.yaml.bak /etc/netplan/50-cloud-init.yaml && sudo netplan apply

5.3 系统服务依赖关系

了解相关服务：

• systemctl status systemd-networkd - 核心网络服务
• systemctl status NetworkManager - 图形界面网络管理（服务器通常不需要）

优化建议：

bash复制sudo systemctl disable NetworkManager  # 纯服务器环境建议禁用
sudo systemctl enable systemd-networkd

经过这些配置后，Ubuntu服务器的网络配置将在重启后保持稳定。我在生产环境中验证过这个方法，最长稳定运行超过300天未出现网络配置重置问题。