文档目录

问题说明

为云主机添加 SSH 密钥后,密钥未写入系统,无法使用该密钥免密登录。

现象

  • 云主机已添加 SSH 密钥,但使用对应私钥无法免密登录。
  • 云主机内未生成或更新与该密钥对应的授权配置。

适用环境

  • 产品:ZCF
  • 版本:4.x-4.8.38
  • 组件:Cloud
  • 涉及对象:支持 cloud-init 的 Linux 云主机、SSH 密钥。

可能原因

云主机内的 cloud-init 服务未正常启动,导致 SSH 密钥注入任务未能完成。

排查步骤

  1. 记录云主机 UUID、使用的镜像、SSH 密钥名称、创建或添加密钥的时间,以及登录失败时的报错信息。
  2. 登录云主机控制台,检查 cloud-init 服务是否正常运行,并查看其日志中是否存在启动或密钥写入失败信息。
  3. 确认云主机内 SSH 服务运行正常,并检查目标用户的授权配置是否包含预期的公钥。
  4. 若 cloud-init 服务异常,或未能确认密钥写入结果,收集服务状态、相关日志和云主机信息,联系技术支持进一步排查。

补充信息

  • 本文适用于由 cloud-init 完成 SSH 密钥注入的镜像;不使用 cloud-init 的镜像需按照其自身的初始化方式处理。
  • 若无法确认 cloud-init 的具体失败原因或适用操作,应联系技术支持进一步评估后再执行修复。
云主机 SSH 密钥注入未生效 | 故障排查 · KB | ZStack 资源中心