---
title: Ubuntu Server 18.04 静态 IP 配置：netplan 方法
description: Ubuntu Server 18.04 起改用 netplan 管理网络，静态 IP 不再写入 /etc/network/interfaces，而是编辑 /etc/netplan 下的 YAML 文件。本文面向企业 IT 运维，说明适用场景、准备与风险、配置步骤、验证方法、回退建议及常见问题，并强调缩进一致性与变更前备份。
url: "https://www.lanever.com/docs/ubuntu-server-18-04-%e9%9d%99%e6%80%81-ip-%e9%85%8d%e7%bd%ae%ef%bc%9anetplan-%e6%96%b9%e6%b3%95/"
updated: "2026-10-12"
category: Linux
---

# Ubuntu Server 18.04 静态 IP 配置：netplan 方法

> **参考来源与致谢**
>
>
>
> - **引用来源：**[How to configure a static IP address in Ubuntu Server 18.04](https://www.techrepublic.com/article/how-to-configure-a-static-ip-address-in-ubuntu-server-18-04/)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

Ubuntu Server 18.04 及采用 netplan 的后续版本中，需要为服务器网卡设置固定地址、网关与 DNS 时使用本方法。典型场景包括：物理机或虚拟机需要稳定地址供内部服务访问、DHCP 地址漂移影响监控与防火墙策略、多网卡服务器需分别指定地址。若系统仍使用 `/etc/network/interfaces`，说明未启用 netplan，应查阅对应版本官方文档确认。

## 准备与风险

- 确认可用的带外管理或本地控制台。远程 SSH 修改网络配置时，一旦地址错误会断开连接。
- 记录当前网络参数：接口名、地址、前缀长度、网关、DNS。
- 备份现有配置目录，例如将 `/etc/netplan` 整体复制到安全位置。
- 建议先在测试环境或快照/克隆机上验证，再在生产环境执行。
- YAML 对缩进敏感，必须使用空格且同一层级缩进一致，不要使用制表符。

> 破坏性操作提醒：修改网络配置可能导致服务器失联。执行前务必完成备份，并确保具备本地或带外恢复手段。

## 处理步骤

1. 登录服务器，进入配置目录：
   ```
   cd /etc/netplan
   ```
2. 查看现有文件：
   ```
   ls
   ```

   常见文件名形如 `50-cloud-init.yaml` 或 `01-netcfg.yaml`。不同镜像命名不同，以实际文件为准。
3. 确认网卡名称：
   ```
   ip a
   ```

   记录目标接口名，例如 `[网卡名称]`。
4. 备份现有配置：
   ```
   sudo cp -a /etc/netplan /etc/netplan.bak
   ```
5. 编辑或新建配置文件。若需新建，使用 `sudo` 配合文本编辑器创建，文件名建议按顺序命名，如 `01-netcfg.yaml`。内容结构参考：
   ```
   network:
    version: 2
    renderer: networkd
    ethernets:
    [网卡名称]:
    dhcp4: no
    addresses:
    - [服务器地址]/[前缀长度]
    gateway4: [网关地址]
    nameservers:
    addresses:
    - [DNS地址]
   ```

   注意：地址与前缀长度写在同一项中，不再单独写子网掩码；缩进层级必须一致。
6. 保存文件后应用配置：
   ```
   sudo netplan apply
   ```

   正常情况无输出。

## 验证方法

- 查看接口地址是否生效：
  ```
  ip a show [网卡名称]
  ```
- 检查默认路由：
  ```
  ip route
  ```
- 测试网关连通性：
  ```
  ping -c 4 [网关地址]
  ```
- 测试域名解析：
  ```
  getent hosts [内部主机名]
  ```
- 若配置未生效或报错，使用调试模式查看原因：
  ```
  sudo netplan --debug apply
  ```

## 回退建议

若应用后网络异常，优先通过本地或带外控制台操作。恢复备份目录中的原文件，再执行 `sudo netplan apply`。若无法进入系统，可在恢复模式或救援环境中挂载根分区，还原 `/etc/netplan` 内容。回退前不要删除备份，确认新配置稳定后再清理。

## 常见问题

- 配置不生效：多为缩进不一致、使用了制表符或层级错误。逐行核对空格数量。
- 地址写法错误：netplan 使用 `地址/前缀长度` 形式，不再使用 netmask 字段。
- 多网卡：为每个接口分别配置，可使用多个 YAML 文件，文件名保持顺序前缀。
- 与 cloud-init 冲突：部分镜像由 cloud-init 生成网络配置，直接修改可能被覆盖，需查阅对应版本官方文档确认处理方式。
- 版本差异：不同 Ubuntu 版本 netplan 字段可能变化，例如网关字段的推荐写法，请以对应版本文档为准。
