从Windows机器SSH登录GCP Compute Engine上Kubernetes主节点方法问询

前置准备 #

• 确认K8s主节点对应的Compute Engine实例已开放22端口入方向访问，且你持有对应实例的SSH访问权限
• 若使用gcloud CLI方式登录，需提前在Windows设备上安装Google Cloud SDK，并完成初始化（执行gcloud init登录GCP账号、绑定对应项目和区域即可）
• 若使用手动SSH方式登录，需提前将本地生成的SSH公钥上传到GCP控制台「Compute Engine」-「元数据」的SSH密钥列表中

操作方法 #

方法1：通过gcloud CLI直接登录（推荐） #

• 打开Windows的PowerShell或命令提示符（CMD）
• 执行命令查看所有VM实例，获取K8s主节点的实例名称和所属可用区：gcloud compute instances list
• 执行登录命令，替换对应参数即可直接进入主节点shell：gcloud compute ssh <K8s主节点实例名> --zone <实例所属可用区>
• 首次登录时会自动完成本地密钥生成、实例侧密钥同步操作，无需手动配置密钥

方法2：手动使用SSH工具登录 #

步骤1：获取主节点公网IP

打开GCP控制台进入「Compute Engine」-「VM实例」页面，找到K8s主节点实例，复制其「外部IP」字段。

步骤2：Windows原生SSH登录（适配Win10 1809及以上、Win11版本）

• 打开PowerShell，执行如下命令登录：

  ssh <登录用户名>@<主节点公网IP>
  

• 若私钥存储在非默认路径，需指定私钥地址：

  ssh -i <本地私钥文件完整路径> <登录用户名>@<主节点公网IP>
  

• 按提示输入私钥密码（若有设置）即可完成登录

步骤3：PuTTY登录（适配旧版Windows系统）

• 打开PuTTY工具，在「Session」页的「Host Name」输入框填写主节点公网IP，端口保持默认22，连接类型选择SSH
• 左侧菜单依次进入「Connection」-「SSH」-「Auth」，在「Private key file for authentication」处选择转换为ppk格式的本地SSH私钥
• 点击「Open」，按提示输入登录用户名即可完成登录

常见问题排查 #

• 若连接超时：检查实例所属VPC的防火墙规则，确认22端口入方向已放行你本地设备的公网IP
• 若密钥验证失败：确认本地私钥和上传到GCP的公钥为配对密钥，且登录用户名和公钥绑定的用户名一致

内容的提问来源于stack exchange，提问作者Kevin Thomas