Linux cloud-init网络配置被覆盖怎么办?如何定位配置来源并验证修复结果
云主机启动后出现网卡配置被改回、静态 IP 变成 DHCP、默认路由或 DNS 丢失,常见原因是 cloud-init 在启动阶段重新读取数据源或本地配置,并生成了网络配置。要定位覆盖来源,不能只改一份网卡文件:需要先确认系统实际使用的网络管理方式,再检查 cloud-init 的输入、生成结果和启动日志,最后通过重启及网络状态验证修复是否持久。
排查时先不要删除 cloud-init 状态目录,也不要直接重启网络服务。远程操作前应确保有云控制台、串口或其他带外登录方式;网络配置一旦错误,SSH 连接可能中断。
一、先确认现象和当前网络状态
先记录故障时看到的实际情况:是 IP 地址变化、路由不通、DNS 解析失败,还是配置文件在重启后恢复。不同症状对应的检查重点不同。比如 IP 正确但域名无法解析,更可能是 DNS 配置问题;默认路由缺失则应重点检查网关和路由配置。
用只读命令采集当前状态:
ip -br link
ip -br addr
ip route
ip -6 route
重点核对网卡名称、链路状态、地址前缀和默认路由。若预期使用静态地址,但输出显示由 DHCP 获取的地址,说明当前生效配置与预期不一致;如果网卡没有地址,问题可能发生在配置未应用、接口未匹配或链路未就绪阶段。
查看 DNS 状态时,先根据系统所用服务选择命令:
cat /etc/resolv.conf
在使用 systemd-resolved 的系统上,还可以执行:
resolvectl status
如果 /etc/resolv.conf 是指向其他文件的符号链接,先确认它由哪个服务管理,不要直接覆盖它。手工修改后被恢复,通常说明应检查上游网络管理器或云初始化配置。
再检查 cloud-init 是否已完成,以及系统版本:
cloud-init --version
cloud-init status --long
cat /etc/os-release
status 显示完成只能说明 cloud-init 的相关阶段已结束,不代表网络配置符合预期。若显示运行中、错误或未完成,应结合启动日志判断,不要在初始化过程中重复运行初始化命令。
二、由外到内确认谁在管理网卡
1. 查找系统实际使用的网络管理器
先检查可能存在的网络配置文件和服务:
ls -l /etc/netplan 2>/dev/null
ls -l /etc/NetworkManager/system-connections 2>/dev/null
ls -l /etc/sysconfig/network-scripts 2>/dev/null
systemctl is-active NetworkManager systemd-networkd networking 2>/dev/null
这些路径和服务并非每个发行版都会同时存在。常见情况如下:
| 系统或配置形态 | 常见网络管理方式 | 需要进一步检查的位置 |
|---|---|---|
| Ubuntu 等使用 Netplan 的系统 | Netplan 配合 NetworkManager 或 systemd-networkd | /etc/netplan/,以及对应 renderer 的状态 |
| RHEL 系及部分衍生系统 | NetworkManager | NetworkManager 连接配置;较旧系统也可能保留 ifcfg 文件 |
| Debian 等采用传统网络配置的系统 | ifupdown 或 NetworkManager | /etc/network/interfaces、相关配置片段或 NetworkManager 配置 |
仅凭文件存在不能判断它当前生效。例如,目录里有 Netplan 配置,不一定代表实际由 systemd-networkd 管理;旧的 ifcfg 文件也可能已不再被当前版本读取。应继续查看服务状态和管理器报告。
Netplan 系统可以用以下命令检查解析后的配置和设备状态:
sudo netplan get
networkctl status
如果系统没有 networkctl,或设备由 NetworkManager 管理,可改查:
nmcli device status
nmcli connection show
命令的输出用于识别当前设备、连接配置和管理器;不要在此阶段执行 netplan apply、重启 NetworkManager 或断开连接。它们可能立即改变远程主机的网络状态。
2. 确认配置文件是否由 cloud-init 生成
Netplan 系统中,/etc/netplan/50-cloud-init.yaml 是常见的 cloud-init 生成文件名,但文件名本身不是定论。查看文件内容和开头注释:
sudo sed -n '1,200p' /etc/netplan/*.yaml
如果文件注释提示由 cloud-init 生成,或内容与云平台提供的地址、网关、DNS 一致,可将其视为重要线索;仍需通过日志确认生成时间和来源。不要直接编辑生成文件后就认为问题已经解决,cloud-init 后续启动可能再次生成它。
其他发行版的生成路径和文件命名会随 cloud-init 版本、数据源及网络渲染器变化。可检查 NetworkManager 连接配置、传统网络配置文件及其修改时间,但不要因文件名包含 cloud-init 就删除或覆盖它。先备份,并查清它是否仍被当前网络管理器使用。
三、定位 cloud-init 从哪里取得配置
cloud-init 的网络配置通常来自云平台数据源、系统中的 cloud-init 配置,或系统自身的回退机制。数据源和不同 cloud-init 版本的处理顺序、可用字段可能不同,因此要把“输入配置”和“渲染后的文件”分开核对。
1. 检查 cloud-init 配置片段
查看配置文件及其顺序:
sudo find /etc/cloud -maxdepth 2 -type f -print
sudo grep -RniE 'network:|config:|datasource|disable_network' \
/etc/cloud/cloud.cfg /etc/cloud/cloud.cfg.d 2>/dev/null
重点关注:
- 是否有
network: { config: disabled }或等价的禁用设置。 - 多个
cloud.cfg.d文件是否分别定义了网络配置或数据源选项。 - 是否存在较早文件设定静态网络、较晚文件又改为 DHCP 的情况。
- 是否有自定义脚本在启动时修改网络配置。
cloud-init 配置通常以 YAML 解析,缩进或键名错误可能导致配置未按预期生效。仅靠 grep 只能发现文本线索,不能证明配置有效;还需要检查日志和最终渲染结果。
2. 查看数据源线索和启动日志
先检查 cloud-init 的主要日志:
sudo grep -Ei 'datasource|network|render|netplan|networkmanager|warning|error' \
/var/log/cloud-init.log /var/log/cloud-init-output.log 2>/dev/null
系统日志也可能记录网络管理器加载配置的结果:
sudo journalctl -b --no-pager | grep -Ei \
'cloud-init|netplan|NetworkManager|systemd-networkd|network'
日志中的数据源名称、网络配置生成记录、渲染器信息以及警告,能帮助判断问题发生在哪一层。例如,日志显示 cloud-init 识别到数据源并写入网络配置,而生成文件里的地址与预期不同,优先检查数据源提供的网络信息;如果生成文件正确,但管理器报告接口未匹配,则应检查网卡名称、匹配条件或 renderer。
不同版本的日志文字并不完全相同。找不到某个关键词,不代表 cloud-init 没有处理网络配置;应结合生成文件、文件时间和启动日志的上下文判断。
3. 对照数据源、生成文件与运行状态
将三处信息逐项对照,不要只比较 IP 地址:

| 检查对象 | 核对内容 | 常见异常线索 |
|---|---|---|
| 数据源或云平台网络信息 | 网卡、MAC、地址、前缀、网关、DNS | 控制台修改未同步,或实例使用了旧的网络信息 |
| cloud-init 生成文件 | 地址模式、接口匹配、路由、DNS | 内容与预期不一致,或多份配置互相冲突 |
| 实际运行状态 | 网卡地址、默认路由、解析器状态 | 文件正确但未被加载,或运行时被其他服务再次修改 |
如果有权限查看实例元数据或云平台网络设置,应优先使用平台控制台、受支持的实例信息接口或供应商文档确认数据源内容。不要为了排查而将完整元数据、cloud-init 日志或配置文件直接公开,其中可能含有主机标识、内部地址或其他敏感信息。
对于需要长期运行网站、业务后台或数据库的场景,A5数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器,涵盖不同CPU、内存与存储配置,并提供因地区和产品系列而异的网络线路选择。多地区资源与多样化硬件可为不同部署位置和业务负载提供基础,让网络配置与实际服务器环境相匹配。
四、根据排查结果选择低风险修复方式
情况一:云平台提供的网络信息不符合预期
如果生成文件与数据源内容一致,但数据源里的地址、网关或 DNS 错误,应先确认云平台侧的网卡绑定、子网和网络配置。此时修改本机生成文件通常只能暂时生效,下次启动仍可能被数据源配置覆盖。
修正平台侧配置后,重新检查实例获取到的数据源信息和 cloud-init 日志,再判断是否需要重启。不要在尚未确认网关、前缀和接口对应关系时直接改默认路由。
情况二:本机 cloud-init 配置与平台配置发生冲突
先确定希望由谁负责网络配置:继续由 cloud-init 根据数据源生成,还是由系统网络管理器固定管理。
如果要禁用 cloud-init 对网络的配置,常见做法是在 cloud-init 配置中设置:
network:
config: disabled
一些系统使用类似下面的文件名保存该设置:
/etc/cloud/cloud.cfg.d/99-disable-network-config.cfg
这只表示 cloud-init 不再负责生成网络配置,不会自动替你创建一份可用的静态网络配置。实施前必须确认 Netplan、NetworkManager 或系统使用的其他网络管理器已经有一份正确且持久的配置,否则重启后可能失去网络。
如果要继续使用 cloud-init,则应修正实际提供网络信息的来源或相关 cloud-init 配置,不要同时留下多份相互矛盾的定义。修改前备份目标文件,例如:
sudo cp -a /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg \
/etc/cloud/cloud.cfg.d/99-disable-network-config.cfg.bak
只有目标文件确实存在时才执行备份;若不存在,不要照搬命令创建或覆盖其他文件。编辑配置后,先检查 YAML 缩进和最终网络配置,再安排可通过控制台恢复的维护窗口。
情况三:生成配置正确,但网络管理器没有按预期加载
先检查配置语法、网卡名称、MAC 匹配条件和 renderer 是否与实际管理器一致。Netplan 系统可先查看解析结果:
sudo netplan get
若解析结果与文件不符,检查 YAML 缩进、重复配置和文件之间的合并关系。解析结果正确但设备状态异常,则检查 NetworkManager 或 systemd-networkd 的设备和日志,不要同时让多个管理器管理同一块网卡。
在远程主机上,应用网络配置属于可能中断连接的操作。应先备份相关配置,确认控制台可用,并优先选择维护窗口。若使用 Netplan,可在确认配置无误后使用:
sudo netplan try
该命令会尝试应用配置并要求确认;若无法确认,配置通常会按工具机制回退,但不应把回退机制当作带外访问的替代品。确认网络正常后再完成提交。其他管理器应采用该系统对应的受支持流程,不要直接套用 Netplan 命令。
情况四:配置文件重启后再次变化
这通常意味着仍有启动阶段生成配置,或者另一个服务、脚本在后续阶段修改文件。对比文件修改时间与日志时间,并检查 cloud-init 日志、系统启动服务和自定义启动脚本。不要用文件只读权限阻止覆盖:这可能让初始化失败,也可能掩盖真正的配置来源。

五、验证修复是否持久
修复验证应同时覆盖文件、管理器和运行状态,不能只以“当前 SSH 能连通”为准。

- 检查配置内容。 确认最终配置只保留预期的地址模式、接口、网关、路由和 DNS;检查 cloud-init 是否仍被配置为生成相冲突的内容。
- 检查解析和管理器状态。 Netplan 系统查看
netplan get和networkctl status,NetworkManager 系统查看nmcli device status、nmcli connection show。确认配置确实由预期管理器接管。 - 验证地址和路由。 再次执行
ip -br addr、ip route。静态配置应显示预期地址和前缀,默认路由应指向正确网关;使用 DHCP 的环境则应确认租约和地址符合预期。 - 验证 DNS 与实际连通性。 检查
resolvectl status或/etc/resolv.conf,并按业务需要测试网关、目标 IP 和域名解析。IP 可达但域名失败,仍需继续排查 DNS。 - 在可恢复条件下重启复测。 确认云控制台或带外通道可用后,安排重启,再重复检查配置文件、cloud-init 状态、地址、路由和 DNS。只有重启后配置没有被改回,才能说明覆盖问题已得到持久修复。
如需重新运行 cloud-init,先确认必要性和影响范围。cloud-init clean 会清理实例初始化状态,可能导致下次启动重新执行初始化流程,不应作为常规“刷新网络配置”命令。执行前应备份配置和重要状态,确认实例可通过控制台恢复,并查阅当前版本的命令说明;回滚方式取决于清理了哪些状态,不能假设重启即可恢复原状。
六、常见误判与持续观察
- 只改生成文件。 如果数据源或 cloud-init 仍提供旧值,重启后可能再次覆盖。应继续追到输入来源。
- 把 DNS 故障当成网卡故障。 先看地址、路由、解析器状态,再分层测试 IP 连通性和域名解析。
- 文件存在就认为配置生效。 必须确认当前网络管理器是否读取该文件,以及设备是否匹配。
- 多个配置同时管理同一接口。 Netplan、NetworkManager、传统配置和自定义脚本可能形成冲突,应确认实际生效链路。
- 在 SSH 会话中直接重启网络。 配置错误可能立即切断连接;先备份并准备带外恢复方式。
完成重启复测后,还应观察至少一次后续维护重启或实例迁移后的网络状态。若配置再次变化,记录变化时间、被改写的文件及同一时段的 cloud-init 和网络管理器日志,再沿“数据源—本机配置—生成文件—运行状态”的顺序复查。这样才能判断是修复未持久化,还是启动流程中仍有其他配置来源参与。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5112.html



