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 命令另行标明;示例地址、用户名、设备名均需按实际环境替换。
汤不热吧