它是什么
「为新创建的实例添加 SSH 密钥」不是把钥匙塞进云里,而是把“锁”放上去。SSH 用一对文件做非对称登录:公钥可公开,写到云端;私钥只留在自己电脑,像家门钥匙。本质就是把公钥那一整行写进实例元数据,或提前写进项目元数据让创建 VM 时继承;访客环境再同步到目标 Linux 用户的 ~/.ssh/authorized_keys。项目级影响项目内多数 VM,实例级只管这一台;若实例禁用项目级密钥,项目里那把不生效。公钥被看见,也反推不出私钥。
首次连接时,服务器先出示主机密钥,客户端让你确认主机指纹;核对后同意,客户端会把它记进 known_hosts。随后用户身份验证不靠密码:客户端用本地私钥给本次会话信息签名,云端用 authorized_keys 里的公钥验签,通过才放行。私钥不会上传;即使私钥设了口令,也只在本地解锁。
下面整段一起复制,在本地 macOS/Linux 终端或 WSL 执行;它只生成示例密钥,并打印公钥、指纹和从私钥推导出的公钥。一起复制是为了让变量不丢;输出公钥的那一行,才是后面能填到控制台的内容。示例不设私钥口令,是为了不弹交互。
mkdir -p "$HOME/.ssh"
chmod 700 "$HOME/.ssh"
KEY="$HOME/.ssh/gcpok_new_vm_ed25519_$(date +%Y%m%d%H%M%S)_$$"
ssh-keygen -t ed25519 -C "gcpok-new-vm" -f "$KEY" -N ""
chmod 600 "$KEY"
chmod 644 "$KEY.pub"
cat "$KEY.pub"
ssh-keygen -lf "$KEY.pub"
ssh-keygen -y -f "$KEY"
- 密钥:一对文件;
.pub结尾的是公钥,另一个是私钥。控制台只收公钥那一行,别把整台电脑上的私钥文件传上去。 - 用户名:常见格式
gcpok:ssh-ed25519 AAAA... gcpok-new-vm里冒号前的gcpok,表示云端把锁装到哪个 Linux 账号下,连接时也要用这个账号。 - 注释:公钥行末尾的备注,方便认钥匙,不参与验证,也不会自动变成用户名。
- 指纹:由公钥算出的短校验值,如
SHA256:...,用来核对是不是同一把公钥;不是密码,不能填到控制台。首次连接看到的主机指纹是服务器的,别和公钥指纹混在一起。
最容易踩的坑,是把没有 .pub、开头像 -----BEGIN OPENSSH PRIVATE KEY----- 的私钥粘进控制台,或把指纹当成密钥。前者等于把钥匙交给别人,应立即删除并重新生成;后者只会格式报错。记住:填公钥一行,必要时前面加“用户名:”,私钥永远留本地;真实环境建议给私钥设口令并保持权限 600。
解决什么问题
为新创建的实例添加 SSH 密钥,先解决的不是“怎么连”,而是“开机后谁安全进得去”。常见翻车是:IP 都出来了,才发现没设密码、没选密钥、用户名也记不清,只好开控制台救急,甚至删掉重建。提前放好公钥,像装修前配门钥匙,建好就能用本机私钥登录,少返工。
先在本机终端(macOS、Linux、WSL 或 Git Bash)跑这条,只看有没有可交给云平台的公钥:
cat ~/.ssh/id_ed25519.pub 2>/dev/null || echo "本机还没有 ed25519 公钥,先别急着建实例"
别粘到网页控制台,也别等连进服务器后才跑。密钥成对:公钥放实例,私钥留本机。为什么?弱密码怕扫描和暴力破解,123456 这类基本等于把门牌贴在锁上;密钥更长,还能关掉密码登录。脚本化部署、自动化运维也更顺:程序拿密钥连接,不用把密码写进脚本或等人手敲。
- 协作更清楚:每人一把公钥,加入就加、离开就删,不用把同一密码通知一圈。
- 交接审计更省事:备注写姓名、用途、日期,配合日志能说清“谁用哪把密钥进了哪台机器”。
常见坑:私钥别发群、传网盘、提交仓库,更别上传服务器;选错项目、区域或用户名,公钥放对也连不上;禁密码前先试通密钥,否则会锁门外。防火墙只管通不通,不生成登录方式,别把“端口开了”当“账号能用”。
怎么上手
-
为新创建的实例添加 SSH 密钥,先在本地准备一对钥匙:
.pub是公钥,可以交给 GCP;没有后缀的是私钥,只留自己电脑。密钥登录比密码更抗暴力猜解。先在 Cloud Shell、WSL 或 macOS/Linux 终端登录并选择项目;如果密钥名已存在,先备份或改名,别覆盖旧钥匙。示例为练习不设私钥口令,正式环境建议再加口令短语。mkdir -p "$HOME/.ssh" chmod 700 "$HOME/.ssh" KEY_FILE="$HOME/.ssh/gcp_vm_ed25519" if [ -e "$KEY_FILE" ]; then echo "密钥已存在:请先备份或改名"; else ssh-keygen -t ed25519 -C "myuser" -f "$KEY_FILE" -N "" -q; fi chmod 600 "$KEY_FILE" cat "$KEY_FILE.pub"上面命令把目录设为仅本人可进入、私钥设为仅本人可读写;权限太开放,SSH 会拒绝使用。最后输出的一整行就是公钥,别把私钥内容上传,也别漏掉开头的
ssh-ed25519。 -
接着选一种方式把公钥放进新 VM。走控制台:在“创建实例”的“安全性/安全”或“管理访问”区域找到“SSH 密钥”,粘贴刚才那一整行;若界面要求完整元数据,就写成
myuser:刚才那一整行公钥。走命令行:GCP 的公钥文件需要“用户名:公钥”一行,所以先生成,再在创建实例时指定这个文件。gcloud config get-value project USER_NAME="myuser" VM_NAME="vm-ssh-demo" ZONE="asia-east1-b" KEY_FILE="$HOME/.ssh/gcp_vm_ed25519" printf '%s:%sn' "$USER_NAME" "$(cat "$KEY_FILE.pub")" > "$KEY_FILE.gcp.pub" gcloud compute instances create "$VM_NAME" --zone="$ZONE" --image-family=debian-12 --image-project=debian-cloud --machine-type=e2-micro --metadata-from-file=ssh-keys="$KEY_FILE.gcp.pub"第一行显示当前项目,建错项目很常见。控制台也建议用上面的实例名、区域、用户名,后面测试命令就不用改。
-
登录前核对:元数据格式通常是
myuser:ssh-ed25519 AAAA... myuser,冒号前myuser才是登录用户名,不是邮箱或项目名;公钥必须是一行,重复用户名、贴私钥、自动换行都会失败。若项目启用 OS Login,手动元数据可能被忽略。确认实例有外部 IP,官方镜像默认监听 22 端口,自定义镜像要确认服务开着;防火墙规则要有入站tcp:22,来源最好只写自己公网 IP 加/32,别长期开放0.0.0.0/0。最后用 SSH 客户端测试登录:VM_NAME="vm-ssh-demo" USER_NAME="myuser" ZONE="asia-east1-b" KEY_FILE="$HOME/.ssh/gcp_vm_ed25519" gcloud compute firewall-rules list --format="table(name,direction,sourceRanges,allowed)" EXTERNAL_IP="$(gcloud compute instances describe "$VM_NAME" --zone="$ZONE" --format='get(networkInterfaces[0].accessConfigs[0].natIP)')" echo "外部 IP:$EXTERNAL_IP" if [ -z "$EXTERNAL_IP" ]; then echo "没有外部 IP,请先给实例分配外部 IP"; else ssh -i "$KEY_FILE" -o StrictHostKeyChecking=accept-new "$USER_NAME@$EXTERNAL_IP"; fi输出里要有入站
tcp:22;外部 IP 为空就是没公网地址。权限被拒多半查用户名和元数据格式;一直超时先查 22 端口、防火墙规则和外部 IP;首次接受主机指纹正常。
与替代方案对比
本文讲的是创建实例时顺手把 SSH 密钥填进去。你可能会嘀咕:晚点再加、点个按钮、甚至用密码不也能进吗?都能进,但省事程度和踩坑概率差挺多,挨个比一比,你就明白为啥推荐「开机前一步到位」了。
不管最后选哪种,先在自己电脑上备好一把钥匙。下面这句直接复制就能跑,会生成私钥并把公钥打印出来,创建实例时填的就是那一整串:
ssh-keygen -t ed25519 -f ~/.ssh/gcpok_key -C "gcpok" -N "" && cat ~/.ssh/gcpok_key.pub
为什么加 -N "":不给私钥再套一层口令,免得每次连接都弹窗追问,小白最容易被这个交互卡住,以为命令死机了。坑提醒:要复制的是 .pub 那串;没有 .pub 的 gcpok_key 是私钥,只留本机,千万别贴进网页输入框。
-
对比「创建后再补加」:创建时填好,机器一开机就能直接连,最省事。等跑起来再补,基本都是忘了填的救急:得先借控制台登进去,手动写
authorized_keys、改权限,或去元数据里补一条,步骤多一圈还容易改错。救急没问题,日常别当流程用。 -
对比控制台「SSH」按钮:点一下弹出网页终端,临时看眼日志真香。但它是平台每次临时替你发钥匙,不利于固定身份:写不进自动脚本,审计里也只看到「平台代登」,不好追到具体人。想固定身份,连之前先跑一下这句收权限、确认工具在:
chmod 600 ~/.ssh/gcpok_key && ssh -V为什么这么做:SSH 特别较真,私钥权限太开放会直接甩一句「Permissions are too open」拒绝登录;
ssh -V只打印版本,不会真去连谁,复制了安心跑。另一个坑:真正连接时-i后面跟的是私钥,用户名要和创建时填密钥那个一致,别顺手写成root。 -
对比 OS Login 与密码登录:团队一起管十几台机器时,OS Login 更适合统一授权——入职在 IAM 开一下,离职一键收回,不用挨台删公钥,审计还自带人名。而密码登录不推荐:好猜、常被暴力试,云上默认多半也关着。别为了「不用记密钥」去开密码,顺着创建时填公钥走最稳。
一句话记住:自己用、想一次搞定 → 创建时加;忘加了 → 补加救急;临时瞄一眼 → 点按钮;一群人管 → OS Login;密码 → 直接划掉。
最佳实践
先记住一条最朴素的规矩:一个人、一台电脑、一把钥匙。别图省事把同一个 id_rsa 发到群里让大家一起用。共用私钥就像全组配同一把家门钥匙,真出事了日志里只显示「这把钥匙进来了」,根本查不到是谁;而且只要有一个人离职,你就得把所有机器全换一遍。给自己单独生成一把,注释里写上名字和年份,以后一眼认得出:
ssh-keygen -t ed25519 -C "zhangsan@company-2026" -f ~/.ssh/gcp_zhangsan
ssh-keygen -lf ~/.ssh/gcp_zhangsan.pub
第二行吐出的那串 SHA256:xxxx 就是指纹,相当于钥匙编号,先别关窗口,待会儿要登记。⚠️ 小白最常踩的坑:以为「换电脑 / 人走了 = 把本地文件删掉」就完事了,其实云上还留着公钥,照样能登。所以只要换机、离职,或者哪怕只是怀疑私钥被截图发过,都立刻当泄露处理:先加新的,再删旧的,最后验证旧的上不去。
gcloud compute os-login ssh-keys list
gcloud compute os-login ssh-keys remove --key "$(cat ~/.ssh/gcp_zhangsan.pub)"
上面演示作废刚建的这把;真轮换时把路径换成旧钥匙即可,删完再跑一次 list 核对,别删完就走。
能不手动往 authorized_keys 里贴就别贴。优先开 OS Login + IAP:账号跟着公司 IAM 走,人一停用权限自动收回;IAM 只发「Compute OS Login」这类最小角色,别顺手勾个 Editor。再把 22 端口收窄,下面两行直接复制,用的是 IAP 固定网段,不用你查自己 IP:
gcloud compute project-info add-metadata --metadata enable-oslogin=TRUE
gcloud compute firewall-rules create allow-ssh-iap-only --allow tcp:22 --source-ranges 35.235.240.0/20 --target-tags allow-iap-ssh --direction INGRESS
记得给新实例打上 allow-iap-ssh 网络标签,否则规则不生效——这就是「我明明配了却没用」的头号原因。⚠️ 另一个坑:有人想「再加个我家 IP 更保险」,直接把来源改成自己的 /32,结果覆盖掉 IAP 网段,自己反而连不上了。要加就两个都写:
gcloud compute firewall-rules update allow-ssh-iap-only --source-ranges "35.235.240.0/20,$(curl -s ifconfig.me)/32"
最后做台账。别只写「小王的钥匙」,公钥长得都差不多,三个月后根本分不清哪串该删,连指纹一起记:
printf 'zhangsan | %s | %sn' "$(ssh-keygen -lf ~/.ssh/gcp_zhangsan.pub | awk '{print $2}')" "$(date +%F)" >> ~/ssh-key-inventory.txt
- 归属:张三 / 开发笔记本 / 上面命令自动记的日期
- 文件:
~/.ssh/gcp_zhangsan.pub,私钥绝不进表格、绝不进群 - 指纹:
ssh-keygen -lf的结果,已写进~/ssh-key-inventory.txt - 状态:在用 → 轮换后改「已作废」,并确认
list里真没了
把这份台账和上面几条 gcloud 命令一起存成新建实例模板,以后开机器直接套,不用凭记忆敲。每月对着 list 扫一遍,标了「已作废」却还挂着的公钥当场清掉。最怕的从来不是忘加新钥匙,而是旧钥匙静静躺在元数据里半年没人管——那就是一扇长期敞着的门。
常见问题(FAQ)
为新创建的实例添加 SSH 密钥后仍无法登录怎么办?
先查用户名、私钥权限、22 端口、防火墙规则,以及公钥格式和元数据是否生效。
公钥和私钥可以发给同事吗?
只可分发公钥,私钥留在本人设备,绝不通过聊天工具或代码仓库发送。
项目级密钥和实例级密钥选哪个?
少量测试可用实例级,团队统一管理优先 OS Login 或规范的项目级密钥。
创建 VM 时忘记添加密钥还能补救吗?
可以,通过实例元数据、OS Login、控制台 SSH 或串行控制台登录后补加。
需要把 22 端口开放给全网吗?
不建议,限制来源 IP,或用 IAP 与防火墙规则减少公网暴露面。
不想自己折腾 GCP?我们提供云平台代维护、上云迁移与账单代付服务,一对一技术支持。
