欢迎光临

GCP SSH 提示 Permission denied (publickey):OS Login 与元数据密钥排查

Permission denied (publickey) 表示已经进入 SSH 认证阶段。此时应核对身份和公钥来源,而不是不断放行 22 端口。Google Cloud 中首先要分清:这台 VM 使用 OS Login,还是项目/实例元数据 SSH 密钥。

1. 先确认连的是哪台机器、哪个身份

在本地安装并登录 gcloud 后,使用显式项目、区域和实例名做一次诊断。下方 PROJECT_ID、ZONE、VM_NAME 均需替换。不要把浏览器 SSH 使用的身份直接等同于本地终端当前账号。

1
2
gcloud auth list
gcloud compute ssh VM_NAME --project=PROJECT_ID --zone=ZONE --troubleshoot

保留报错类别;若诊断转为 IAP 权限或连接超时,应处理对应网络入口。不要将 publickey 与 IAP 的访问拒绝合并成一个原因。gcloud compute ssh 可能创建或更新登录密钥,执行前确认当前身份和目标项目。

2. 判断 OS Login 是否生效

在实例详情的元数据和项目公共元数据中检查 enable-oslogin,并考虑组织策略。读取下面两处输出进行比较,不能只看实例元数据为空就判断 OS Login 关闭。

1
2
gcloud compute instances describe VM_NAME --project=PROJECT_ID --zone=ZONE --format='json(metadata,serviceAccounts)'
gcloud compute project-info describe --project=PROJECT_ID --format='json(commonInstanceMetadata)'
认证方式 公钥和用户名来源 重点检查
OS Login Google 身份关联的 OS Login profile IAM 登录权限、POSIX 用户名、密钥有效期
元数据 SSH 密钥 实例或项目 ssh-keys 元数据 实例是否屏蔽项目密钥、用户名、guest agent

OS Login 生效时,不应继续只往元数据 ssh-keys 中添加密钥期待恢复。OS Login 的 POSIX 用户名可能与邮箱前缀、你原来创建的用户不同。

3. OS Login 分支

1
2
gcloud compute os-login describe-profile
gcloud compute os-login ssh-keys list

核对 profile 中的 POSIX 用户名和密钥有效期。请求管理员按需求授予 roles/compute.osLogin;只有需要管理员登录权限时才考虑 roles/compute.osAdminLogin。若 VM 附加了服务账号,还需按官方要求核对相应服务账号使用权限;组织外用户另有组织层面的条件。不要为排错直接授予项目 Owner。

若使用 OS Login 两步验证,检查该登录方式的附加要求。修复后优先用显式项目与区域的 gcloud compute ssh 重试;直接 ssh 时必须使用 profile 中对应的 Linux 用户名及匹配私钥。

4. 元数据密钥分支

检查实例的 block-project-ssh-keys,确定项目级密钥是否会被忽略;再核对 ssh-keys 条目的用户名与公钥。浏览器 SSH 的临时密钥可能过期,本地已有文件也可能不是这次实例使用的密钥。更改元数据时保留现有其他键和值,避免用单个条目覆盖整个列表。

1
ssh -vvv -o IdentitiesOnly=yes -i ~/.ssh/google_compute_engine USER@203.0.113.10

通过受信任控制台检查 google-guest-agent 状态、磁盘空间和账户目录权限。元数据正确但 guest agent 无法运行,可能使密钥无法写入。不要随意删除 guest agent 或将受管理的 authorized_keys 当成唯一事实来源。

5. 完成标准与回退

新终端以预期用户登录,运行 whoami 确认身份;需要 sudo 时单独验证权限。删除仅用于排查的临时密钥和不必要授权。若修改了 OS Login 开关,应恢复原认证设计并验证原有管理员仍可访问,避免为了修一个用户而切换整台实例的认证模式。

资料核对日期:2026-11-15。本文依据官方文档整理,并提供编辑设计的诊断顺序;未声称在各服务商账户完成现场实测。命令面向具备相应权限的 Linux/OpenSSH 环境,Windows 命令另行标明;示例地址、用户名、设备名均需按实际环境替换。

参考资料

继续排查

【本站文章皆为原创,未经允许不得转载】:汤不热吧 » GCP SSH 提示 Permission denied (publickey):OS Login 与元数据密钥排查
分享到: 更多 (0)