Rongrong姐1. 问题现象与背景分析
最近在Ubuntu 22.04.5系统中遇到一个典型问题：手动配置的网络参数（包括静态IP、DNS等）在系统重启后会被自动重置。这个问题特别影响服务器环境和需要固定IP的开发机使用。经过排查，发现罪魁祸首是cloud-init服务及其配置文件50-cloud-init.yaml。
cloud-init是Ubuntu用于云环境初始化的标准工具，它会自动处理网络配置。但在物理机或常规虚拟机环境中，这个"自动化"反而成了麻烦。每次重启，cloud-init都会读取自己的配置文件覆盖手动修改，导致网络设置"回滚"。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 根本原因解析
2.1 cloud-init的工作机制
cloud-init在系统启动时按以下顺序执行：
- 检测网络配置源（通常为/etc/netplan/50-cloud-init.yaml）
- 应用配置生成网络规则
- 如果检测到云平台metadata服务，会动态更新配置
关键问题在于：即使在没有云环境的本地机器上，50-cloud-init.yaml这个文件也会被优先加载，而手动修改的配置（如99-config.yaml）会被其覆盖。
2.2 配置文件优先级
Ubuntu 22.04使用Netplan管理网络，配置读取顺序为：
code复制50-cloud-init.yaml → 其他自定义配置（如99-config.yaml）
后加载的配置本应覆盖前者，但cloud-init的机制会强制重置为初始状态。
3. 永久解决方案
3.1 方法一：禁用cloud-init网络配置（推荐）
- 编辑cloud-init配置：
bash复制sudo nano /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg
- 添加以下内容：
yaml复制network: {config: disabled}
- 清理已生成的配置：
bash复制sudo rm /etc/netplan/50-cloud-init.yaml
- 创建自定义配置：
bash复制sudo nano /etc/netplan/99-static.yaml
示例静态IP配置：
yaml复制network:
version: 2
renderer: networkd
ethernets:
ens33:
addresses: [192.168.1.100/24]
gateway4: 192.168.1.1
nameservers:
addresses: [8.8.8.8, 1.1.1.1]
- 应用配置：
bash复制sudo netplan apply
3.2 方法二：修改cloud-init默认配置
- 备份原始配置：
bash复制sudo cp /etc/cloud/cloud.cfg /etc/cloud/cloud.cfg.bak
- 修改配置：
bash复制sudo nano /etc/cloud/cloud.cfg
找到network部分，修改为：
yaml复制network:
config: disabled
4. 验证与测试
执行以下命令验证配置持久性：
bash复制# 查看当前IP
ip a
# 测试网络连通性
ping -c 4 google.com
# 重启后验证
sudo reboot
# 再次检查IP配置
ip a
5. 高级场景处理
5.1 多网卡绑定配置
对于需要绑定多个网卡的情况，配置示例：
yaml复制network:
version: 2
bonds:
bond0:
interfaces: [ens33, ens34]
parameters:
mode: 802.3ad
lacp-rate: fast
addresses: [192.168.1.100/24]
gateway4: 192.168.1.1
5.2 DHCP保留地址配置
如果需要通过DHCP获取固定IP：
yaml复制network:
version: 2
ethernets:
ens33:
dhcp4: true
dhcp-identifier: mac
6. 疑难排查指南
6.1 常见错误排查
-
配置未生效：
- 检查YAML格式（特别注意缩进）
- 使用
netplan --debug apply查看详细错误
-
网络服务冲突：
bash复制sudo systemctl stop systemd-networkd sudo systemctl disable NetworkManager -
DNS解析失败：
bash复制sudo rm /etc/resolv.conf sudo ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf
6.2 日志分析技巧
查看cloud-init日志：
bash复制journalctl -u cloud-init -b
检查netplan应用日志：
bash复制journalctl -u systemd-networkd -b
7. 系统服务管理建议
对于服务器环境，建议固定以下服务状态：
bash复制sudo systemctl enable systemd-networkd
sudo systemctl disable cloud-init-network
sudo systemctl mask cloud-init.service
8. 配置备份与版本控制
建议将网络配置纳入版本管理：
bash复制sudo cp /etc/netplan/99-static.yaml ~/config-backup/
git init ~/config-backup
git -C ~/config-backup add .
git -C ~/config-backup commit -m "Network config backup"
9. 不同环境适配方案
9.1 物理服务器配置
建议完全禁用cloud-init：
bash复制sudo touch /etc/cloud/cloud-init.disabled
sudo apt purge cloud-init
9.2 虚拟机环境配置
对于VMware/VirtualBox：
yaml复制network:
version: 2
ethernets:
ens33:
dhcp4: no
addresses: [192.168.1.100/24]
gateway4: 192.168.1.1
nameservers:
addresses: [8.8.8.8]
9.3 WSL2特殊处理
WSL2需要额外配置：
bash复制sudo nano /etc/wsl.conf
添加：
ini复制[network]
generateResolvConf = false
10. 性能优化参数
对于高负载服务器，建议调整内核参数：
bash复制# 编辑sysctl配置
sudo nano /etc/sysctl.d/99-network.conf
添加：
conf复制net.core.rmem_max=4194304
net.core.wmem_max=4194304
net.ipv4.tcp_keepalive_time=60
net.ipv4.tcp_fin_timeout=30