参考来源与致谢
- 引用来源: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 对缩进敏感,必须使用空格且同一层级缩进一致,不要使用制表符。
破坏性操作提醒:修改网络配置可能导致服务器失联。执行前务必完成备份,并确保具备本地或带外恢复手段。
处理步骤 #
- 登录服务器,进入配置目录:
cd /etc/netplan - 查看现有文件:
ls常见文件名形如
50-cloud-init.yaml或01-netcfg.yaml。不同镜像命名不同,以实际文件为准。 - 确认网卡名称:
ip a记录目标接口名,例如
[网卡名称]。 - 备份现有配置:
sudo cp -a /etc/netplan /etc/netplan.bak - 编辑或新建配置文件。若需新建,使用
sudo配合文本编辑器创建,文件名建议按顺序命名,如01-netcfg.yaml。内容结构参考:network: version: 2 renderer: networkd ethernets: [网卡名称]: dhcp4: no addresses: - [服务器地址]/[前缀长度] gateway4: [网关地址] nameservers: addresses: - [DNS地址]注意:地址与前缀长度写在同一项中,不再单独写子网掩码;缩进层级必须一致。
- 保存文件后应用配置:
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 字段可能变化,例如网关字段的推荐写法,请以对应版本文档为准。
