Debian Cloud 修改 IP 地址

约 1499 字大约 5 分钟

2026-08-26

概述

Debian Cloud 镜像通常使用 Netplan + Cloud-init 管理网络。Netplan 通过 /etc/netplan/*.yaml 定义网卡、静态 IP、默认网关、DNS 和路由，并将配置转换为系统实际的网络配置。

本文以 Debian 13 Cloud 双网卡主机为例，介绍静态 IP、默认网关、多网卡、配置优先级以及远程 SSH 环境下的安全应用与验证。

核心流程：

查看当前状态 → 修改 Netplan → 语法检查 → 临时应用 → 验证 → 正式应用

一、查看当前网络

修改前先确认网卡、IP 和路由：

ip -br addr
ip route

输出示例：

ens192    UP    10.0.0.8/24
ens224    UP    172.16.1.1/24

路由：

default via 10.0.0.1 dev ens192
10.0.0.0/24 dev ens192
172.16.1.0/24 dev ens224

其中 ens192 是主接口（负责外部网络访问，IP 10.0.0.8/24，网关 10.0.0.1），ens224 是辅助接口（内部/专用网络，IP 172.16.1.1/24）。

配置优先级：Netplan 按文件名字典序读取 /etc/netplan/*.yaml，因此 50-cloud-init.yaml 先于 99-custom.yaml 加载。将自定义配置放在较大编号的文件（如 99-custom.yaml）中，可使其位于 Cloud-init 默认配置之后。多个 YAML 文件不是简单的「后者覆盖前者」，而是按 Netplan 规则合并，最终配置以 netplan get 显示为准。

三、配置静态 IP

推荐使用 routes 配置默认路由，而非旧式 gateway4。gateway4 在新版 Netplan 中已不推荐，routes 对多路由和策略路由更统一。

双网卡配置示例：

network:
  version: 2

  ethernets:
    ens192:
      dhcp4: false
      dhcp6: false

      addresses:
        - 10.0.0.8/24

      routes:
        - to: default
          via: 10.0.0.1

      nameservers:
        addresses:
          - 10.0.0.2
          - 223.5.5.5

    ens224:
      dhcp4: false
      dhcp6: false

      addresses:
        - 172.16.1.1/24

创建或修改配置：

nano /etc/netplan/99-custom.yaml

提示

为何只配一个网关：ens192 是主网络接口，因此配置默认路由；ens224 只配置地址、不配置网关。因为 172.16.1.0/24 是 ens224 的直连网络，Linux 会自动生成对应直连路由。普通情况一台主机只需一个默认路由，除非明确使用策略路由或多出口，否则不要为辅助接口配置第二个默认网关。

核心原则：默认网关配置在负责外部网络访问的接口上；内部、管理或专用接口通常只配置 IP 和对应路由。

四、应用配置

修改后先检查语法：

netplan generate

无错误输出通常表示 YAML 与 Netplan 配置可正常生成。

警告

远程 SSH 环境下，不要在未验证的情况下直接正式应用，网络配置错误可能立即导致 SSH 断开。推荐先临时应用 netplan try，它会在未确认时自动回滚。确认以下项正常后再正式应用：

SSH 连接正常
网关可达
DNS 正常
外网访问正常

正式应用：

netplan apply

五、验证网络

查看最终 Netplan 配置：

netplan get

查看 IP：

ip -br addr

查看默认路由：

ip route show default

# 预期显示：default via 10.0.0.1 dev ens192

查看完整路由：

ip route

排查多网卡或路由异常时，直接查询目标地址的实际出口，比单纯 ping 更直观：

ip route get 223.5.5.5

输出示例：

223.5.5.5 via 10.0.0.1 dev ens192 src 10.0.0.8

可确认数据包实际从哪个接口和源地址发出。

六、连通性测试

建议按「网关 → DNS → 公网 IP → 域名」逐级测试。

测试网关：

ping -c 4 10.0.0.1

测试 DNS 服务器：

ping -c 4 10.0.0.2

测试公网：

ping -c 4 223.5.5.5

检查 DNS：

resolvectl status

若公网 IP 可访问但域名无法解析，重点检查 DNS 配置，而非继续排查默认网关。

七、YAML 注意事项

Netplan 使用 YAML，缩进必须正确，且只能使用空格，不要使用 Tab。

正确：

network:
  version: 2
  ethernets:
    ens192:
      dhcp4: false
      addresses:
        - 10.0.0.8/24

错误（缺少缩进）：

network:
version: 2
ethernets:
ens192:

修改后使用 netplan generate 检查配置。

八、Cloud-init 注意事项

Cloud 镜像通常由 Cloud-init 生成 /etc/netplan/50-cloud-init.yaml。自定义配置可放在 /etc/netplan/99-custom.yaml，再用 netplan get 检查最终配置。

警告

如果 Cloud-init 仍负责网络配置，后续重新初始化或再次运行 Cloud-init 时可能重新生成网络配置。长期运行的 Cloud VPS 应明确网络配置的唯一管理者，避免 Cloud-init、Netplan 或其他网络管理工具同时修改网络。

九、云服务器的特殊情况

不要假设云服务器网关一定是 x.x.x.1。云厂商可能使用 IP 1.2.3.4/32、网关 1.2.3.1，或要求额外配置网关路由。配置云服务器应以云厂商提供的参数为准：IPv4 地址、子网掩码/CIDR、默认网关、IPv6 地址及网关、DNS、静态路由、特殊路由要求。尤其是 /32 地址的云服务器，不能直接按普通 /24 局域网理解网关关系。

十、常用命令

用途	命令
查看网卡	`ip link`
查看 IP	`ip addr`
简洁查看 IP	`ip -br addr`
查看路由	`ip route`
查看默认网关	`ip route show default`
查询实际选路	`ip route get <IP>`
查看 DNS	`resolvectl status`
查看最终配置	`netplan get`
生成配置 / 语法检查	`netplan generate`
临时应用并支持回滚	`netplan try`
正式应用	`netplan apply`

十一、推荐操作流程

远程 Debian Cloud 修改 IP 时，推荐严格按以下顺序操作：

# 1. 查看当前网络
ip -br addr
ip route

# 2. 修改配置
nano /etc/netplan/99-custom.yaml

# 3. 检查最终配置
netplan get

# 4. 生成配置并检查语法
netplan generate

# 5. 临时应用，避免配置错误导致永久断网
netplan try

# 6. 验证网络
ip -br addr
ip route
ip route get 223.5.5.5
ping -c 4 10.0.0.1
ping -c 4 223.5.5.5

# 7. 确认无误后正式应用
netplan apply

提示

远程修改网络的关键不是直接 netplan apply，而是先 netplan generate 检查配置，再用 netplan try 临时验证，确认 SSH 和路由正常后再正式应用。

版权所有

许可证：署名 4.0 国际 (CC-BY-4.0)