告别 gateway4 弃用警告：详解 Netplan 默认路由配置与 Ubuntu 网络升级实践

1. 为什么gateway4会被弃用？

最近在给Ubuntu服务器配置静态IP时，突然发现熟悉的gateway4参数开始报弃用警告。这个变化其实反映了Linux网络配置工具链的演进方向。Netplan作为Ubuntu的默认网络配置工具，从17.10版本引入至今，一直在朝着更灵活、更标准化的方向发展。

gateway4的弃用不是偶然的。这个参数原本是为了简化默认网关配置而设计的快捷方式，但它存在两个明显局限：首先它只能处理IPv4网关，对IPv6不友好；其次它隐含了"默认路由"的概念，却没有显式声明路由目标。新的routes配置方式则更加明确和强大，可以同时支持IPv4/IPv6，还能配置多条路由规则。

举个例子，假设你原来这样配置：

network: version: 2 ethernets: eth0: addresses: [192.168.1.100/24] gateway4: 192.168.1.1

现在需要改成：

network: version: 2 ethernets: eth0: addresses: [192.168.1.100/24] routes: - to: default via: 192.168.1.1

这种改变带来的好处是显而易见的。我最近在配置双栈网络时就深有体会，新的语法可以很自然地扩展：

routes: - to: default via: 192.168.1.1 - to: default via: fd00::1 metric: 100

2. 新旧配置对比与迁移指南

2.1 典型配置场景对比

让我们通过几个常见场景来看看新旧配置的区别。首先是单网卡基础配置：

旧版配置：

network: version: 2 ethernets: eth0: dhcp4: false addresses: [192.168.1.100/24] gateway4: 192.168.1.1 nameservers: addresses: [8.8.8.8, 8.8.4.4]

新版配置：

network: version: 2 ethernets: eth0: dhcp4: false addresses: [192.168.1.100/24] routes: - to: default via: 192.168.1.1 nameservers: addresses: [8.8.8.8, 8.8.4.4]

对于多网卡环境，新配置的优势更加明显。假设eth0连接内网，eth1连接外网：

network: version: 2 ethernets: eth0: addresses: [10.0.0.2/24] routes: - to: 10.0.0.0/24 via: 10.0.0.1 eth1: addresses: [192.168.1.100/24] routes: - to: default via: 192.168.1.1 metric: 100

2.2 分步迁移指南

迁移过程其实很简单，我总结为三个步骤：

1. 备份现有配置：

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

2. 编辑配置文件： 用你熟悉的编辑器打开配置文件，找到gateway4所在行，将其替换为routes语法。比如将：

gateway4: 192.168.1.1

改为：

routes: - to: default via: 192.168.1.1

3. 应用新配置：

sudo netplan apply

如果遇到问题，可以先用netplan try测试配置，这个命令会在应用前给你一个回滚的机会：

sudo netplan try --timeout 30

3. 验证与问题排查

3.1 配置验证方法

应用新配置后，我通常会做以下检查：

1. 检查路由表：

ip route show

应该能看到类似这样的默认路由：

default via 192.168.1.1 dev eth0 proto static

2. 测试网络连通性：

ping -c 4 8.8.8.8

3. 检查DNS解析：

nslookup example.com

3.2 常见问题排查

在实际迁移过程中，我遇到过几个典型问题：

问题1：配置格式错误症状：netplan apply时报YAML语法错误 解决方法：使用netplan generate检查配置有效性

sudo netplan generate

问题2：路由未生效症状：ip route show看不到默认路由 可能原因：

• 缩进错误（YAML对缩进敏感）
• 网卡名称写错
• 网关地址不可达

问题3：网络服务冲突症状：应用配置后网络断开 解决方法：检查是否有其他网络管理服务在运行

systemctl status NetworkManager systemctl status systemd-networkd

4. 高级配置技巧

4.1 多网关配置

新的routes语法支持更复杂的路由场景。比如配置主备网关：

routes: - to: default via: 192.168.1.1 metric: 100 - to: default via: 192.168.2.1 metric: 200

4.2 策略路由

对于需要策略路由的场景，可以这样配置：

routing-policy: - from: 192.168.1.100 table: 100 routes: - to: default via: 192.168.1.1 table: 100

4.3 多子网路由

如果需要访问其他子网，可以添加静态路由：

routes: - to: 10.0.0.0/24 via: 192.168.1.254 - to: default via: 192.168.1.1

这些高级配置在旧版gateway4语法中是无法实现的。我在部署Kubernetes集群时就充分利用了这些特性，为不同Pod网络配置了特定的路由规则。