Linux cloud-init网络配置被覆盖怎么办?如何定位配置来源并验证修复结果

发布人:A5数据发布时间:2026-10-22 16:33阅读量:154

云主机启动后出现网卡配置被改回、静态 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 系及部分衍生系统NetworkManagerNetworkManager 连接配置;较旧系统也可能保留 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 地址:

三、定位 cloud-init 从哪里取得配置配图

检查对象核对内容常见异常线索
数据源或云平台网络信息网卡、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 能连通”为准。

五、验证修复是否持久配图

  1. 检查配置内容。 确认最终配置只保留预期的地址模式、接口、网关、路由和 DNS;检查 cloud-init 是否仍被配置为生成相冲突的内容。
  2. 检查解析和管理器状态。 Netplan 系统查看 netplan get 和 networkctl status,NetworkManager 系统查看 nmcli device status、nmcli connection show。确认配置确实由预期管理器接管。
  3. 验证地址和路由。 再次执行 ip -br addr、ip route。静态配置应显示预期地址和前缀,默认路由应指向正确网关;使用 DHCP 的环境则应确认租约和地址符合预期。
  4. 验证 DNS 与实际连通性。 检查 resolvectl status 或 /etc/resolv.conf,并按业务需要测试网关、目标 IP 和域名解析。IP 可达但域名失败,仍需继续排查 DNS。
  5. 在可恢复条件下重启复测。 确认云控制台或带外通道可用后,安排重启,再重复检查配置文件、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

相关推荐