Ubuntu服务器网络配置避坑指南：netplan中yaml文件优先级全解析
当你第一次在Ubuntu服务器上配置网络时，可能会遇到这样的困惑：明明修改了网络配置文件，重启后却发现配置没有生效。这种情况往往与netplan配置文件的加载顺序有关。作为现代Ubuntu系统的默认网络配置工具，netplan通过YAML文件管理网络接口，但多个配置文件之间的优先级规则却让不少运维人员踩坑。
1. netplan配置文件加载机制深度剖析
netplan的设计哲学是简单而强大，它通过读取/etc/netplan/目录下的YAML文件来配置网络。但这里有个关键细节：netplan会按照字典顺序加载这些文件。这意味着文件名决定了配置的加载顺序，进而影响最终生效的网络参数。
举个例子，假设目录中有两个文件：
- 01-netcfg.yaml
- 50-cloud-init.yaml
netplan会先加载01-netcfg.yaml，再加载50-cloud-init.yaml。这种顺序加载机制带来了一个重要的行为特征：后加载的文件会覆盖先加载文件中相同的配置项。
# 01-netcfg.yaml示例
network:
version: 2
ethernets:
eth0:
dhcp4: no
addresses: [192.168.1.100/24]
gateway4: 192.168.1.1
# 50-cloud-init.yaml示例
network:
version: 2
ethernets:
eth0:
dhcp4: yes
在这个案例中，最终生效的配置将是：
- dhcp4: yes（来自50-cloud-init.yaml）
- addresses: [192.168.1.100/24]（保留自01-netcfg.yaml）
- gateway4: 192.168.1.1（保留自01-netcfg.yaml）
注意：netplan的合并是字段级别的，而不是整个配置块的替换。只有明确指定的字段会被覆盖，未指定的字段会保留之前的值。
2. 实战中的优先级控制策略
理解了加载机制后，我们需要掌握几种实用的优先级控制方法：
2.1 文件命名的最佳实践
要让自定义配置优先生效，关键在于文件名。以下是几种有效的命名方案：
-
前缀数字法：使用较小的数字前缀，如00-、01-
- 00-custom-config.yaml
- 01-network.yaml
-
字母优先法：使用字母顺序上靠前的名称
- a-network.yaml
- b-backup.yaml
-
系统保留法：了解系统默认文件的命名规则
- cloud-init通常使用50-cloud-init.yaml
- 网络管理器可能使用01-network-manager-all.yaml
2.2 配置覆盖的精细控制
有时我们既想保留部分默认配置，又想覆盖特定参数。这时需要理解netplan的合并规则：
# 自定义配置示例（10-custom.yaml）
network:
version: 2
ethernets:
eth0:
dhcp4: no
nameservers:
addresses: [8.8.8.8, 8.8.4.4]
当这个文件与默认配置合并时，dhcp4会被直接覆盖，而nameservers.addresses会与默认的DNS服务器列表合并。
3. 彻底解决cloud-init的干扰问题
cloud-init作为Ubuntu云镜像的标准组件，经常会在系统启动时重置网络配置。要完全掌控网络配置，我们有几种解决方案：
3.1 禁用cloud-init网络配置
这是最彻底的解决方案，步骤如下：
创建禁用配置文件：
sudo nano /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg
添加以下内容：
network:
config: disabled
删除现有的cloud-init网络配置：
sudo rm /etc/netplan/50-cloud-init.yaml
3.2 选择性覆盖cloud-init配置
如果仍需保留cloud-init的其他功能，可以采用优先级更高的netplan文件：
创建00-persistent-config.yaml：
network:
version: 2
renderer: networkd
ethernets:
eth0:
dhcp4: false
addresses: [192.168.1.100/24]
应用配置：
sudo netplan apply
4. 高级技巧与疑难排解
4.1 调试netplan配置
当配置不按预期工作时，可以使用以下命令调试：
# 生成所有配置（不应用）
sudo netplan generate
# 调试特定接口
sudo netplan –debug apply
# 查看生成的底层配置
ls -l /run/systemd/network/
4.2 多网卡复杂配置示例
对于多网卡服务器，配置可能更复杂。下面是一个典型的多网卡配置：
# 00-multi-nic.yaml
network:
version: 2
renderer: networkd
ethernets:
eth0:
dhcp4: no
addresses: [192.168.1.100/24]
gateway4: 192.168.1.1
nameservers:
addresses: [8.8.8.8, 8.8.4.4]
eth1:
dhcp4: no
addresses: [10.0.0.100/24]
routes:
– to: 10.1.0.0/16
via: 10.0.0.1
4.3 常见问题解决方案
问题1：配置修改后网络不生效
解决方案：
问题2：DHCP和静态IP冲突
解决方案：
问题3：VLAN配置不生效
解决方案：
network:
version: 2
vlans:
vlan100:
id: 100
link: eth0
addresses: [192.168.100.100/24]
掌握netplan的优先级规则后，你会发现Ubuntu服务器网络配置变得可预测且可靠。关键在于三点：理解加载顺序、合理命名文件、必要时禁用干扰源。在实际运维中，我习惯使用00-前缀的文件名，并彻底禁用cloud-init的网络功能，这样能确保配置完全按照预期工作。
