Linux ssh-keygen 命令:创建密钥对、查看指纹与恢复公钥
ssh-keygen 用于生成 SSH 认证密钥对、查看公钥指纹,以及从已有私钥重新导出公钥。私钥留在自己控制的设备上,服务器只登记公钥;创建前选择未使用的文件名,避免覆盖仍在使用的密钥。
公钥认证时,客户端用私钥对包含会话信息的认证数据签名,服务器用已授权的公钥验证;它不是把私钥交给服务器,也不是用公钥“解密密码”。公钥文件通常在私钥文件名后加 .pub,但文件内容才是判断依据,改扩展名不会改变密钥类型。
基本语法与生成前的准备
ssh-keygen [option]
先用 ssh -V 核对配套 OpenSSH 版本,并阅读本机 man ssh-keygen。本篇明确指定 Ed25519;是否可用于目标服务器,仍取决于客户端、服务器及当地系统的算法策略,不要仅凭密钥生成成功就判断一定能登录。
确认 ~/.ssh/ 已存在且由自己控制,检查计划使用的私钥文件和同名 .pub 是否已经存在。已有文件应先确认用途、保留受控备份,并换一个新名称创建;遇到覆盖提示时不要习惯性确认。示例 work 只是用途标签,user@example.com 是说明性注释。
口令短语(passphrase)用于保护保存的私钥,与远程账号登录密码不同。为日常使用的私钥设置足够强、可妥善保管的口令短语;不要把它直接写进命令行或 shell 历史。它不能替代文件权限、设备安全和备份,也不会在私钥泄露后自动撤销服务器授权。
生成、查看与恢复公钥
创建 Ed25519 密钥对。在客户端执行,明确指定新路径:
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_work -C 'user@example.com'
按提示输入并再次确认口令短语;输入时通常不会回显字符。完成后预期得到私钥 id_ed25519_work 和公钥 id_ed25519_work.pub。不要把整段终端输出或密钥内容上传到不受控的网页来“检查是否正确”。
查看公钥指纹。确认将要登记的公钥身份:
ssh-keygen -lf ~/.ssh/id_ed25519_work.pub
-l 显示指纹,-f 选择文件,组合写成 -lf。默认使用 SHA256;与另一处结果比较时要使用相同算法及完整指纹,不能只比较文件名、注释或开头几个字符。
从私钥重新导出公钥。如果丢失的只是 .pub,而原私钥仍可读取,可执行:
ssh-keygen -y -f ~/.ssh/id_ed25519_work
-y 将对应公钥输出到标准输出,不会自动创建 .pub 文件。加密私钥需要原口令短语;确认输出内容及目标文件不存在后,可用重定向保存到一个新的公钥文件。重定向会先创建或截断目标,切勿将输出目标误写成私钥路径。
重新导出的公钥应与原来的密钥主体和指纹一致;注释可能不同或不存在,不影响同一个公钥的身份。这个操作不能从公钥反推私钥,也无法恢复已经丢失的私钥或忘记的口令短语。
怎样读懂指纹并确认登记对象
生成后再检查一次准备交给服务器的实际公钥文件,而不是只看生成命令中的路径:
ssh-keygen -lf ~/.ssh/id_ed25519_work.pub
下面仅展示格式,省略号并非可用于比对的真实指纹:
256 SHA256:... user@example.com (ED25519)
256 是工具显示的该密钥位数,不代表与其他算法同位数就有相同安全强度;括号内是类型。SHA256: 后面是公钥数据的摘要标识,注释用于辨识用途,不参与公钥授权判断,也不是受验证的邮箱身份。
重新生成密钥会得到新的密钥材料和指纹,即使沿用同一文件名与注释也不同。相反,仅改注释不会换掉公钥。指纹用于识别密钥,并不能独自证明持有人身份或服务器已接受授权;需要通过可信渠道比对预期值。
本地行为检查:2026-11-05 在 Windows Git 配套 OpenSSH 10.3p1 中,用专用、未注册到服务器的临时测试密钥验证生成、SHA256 指纹、公钥导出和注释修改;以公钥二进制数据独立计算摘要比对。测试使用无口令的一次性密钥以便非交互运行,没有测试 Linux 登录、服务器登记或交互式口令保护,不是日常私钥设置示例。
常用选项与权限检查
| 选项 | 作用与条件 |
|---|---|
-t TYPE |
选择生成类型,例如 ed25519;需符合两端策略。 |
-f FILE |
指定读取或保存路径,具体角色取决于当前操作。 |
-C COMMENT |
设置识别注释,不是验证邮箱或服务器账号。 |
-l |
显示指纹,可配合 -E sha256 明确选择摘要算法。 |
-y |
读取私钥,把对应公钥输出到标准输出。 |
-p |
修改已有私钥的口令短语,不重新生成密钥对。 |
修改口令可用 ssh-keygen -p -f ~/.ssh/id_ed25519_work,按提示输入旧口令和新口令。它不会更换公钥,因此正常更改口令不需要重新登记同一公钥;新生成密钥替换旧密钥则需要更新授权。
常见 Linux 客户端设置为 ~/.ssh 仅允许本人访问,私钥只允许本人读写,例如目录 700、私钥 600;先核对所有者与目标路径再处理。Windows 的访问控制规则不同,不能把 Git 环境中的模式显示当作 Linux 权限已验证。
登记与更换密钥的检查顺序
- 创建新文件名的密钥对,保存受控备份和用途记录,检查公钥指纹。私钥及口令短语不发送给服务器管理员或上传网页;公钥本身也可能包含用途等元信息。
- 按管理员约定,将完整公钥登记到正确账号的授权机制。OpenSSH 常用 ~/.ssh/authorized_keys,但服务器配置、文件权限和账号策略可能不同;仅把 .pub 随意复制到服务器某目录并不等于授权。
- 保留现有有效会话,在新会话里明确选择新私钥测试,例如
ssh -i ~/.ssh/id_ed25519_work alice@server.example.com。仍需核对服务器主机指纹,且代理或其他身份配置可能让客户端使用其他密钥,必要时检查实际认证身份。 - 确认新密钥能够执行所需操作并保留恢复入口后,再按计划撤销旧公钥。若私钥已泄露,应撤销旧授权并检查使用情况;只改本地口令不能使对方手中的旧副本失效。
用户认证密钥与服务器主机密钥承担不同角色,相关说明见 SSH 登录与服务器指纹检查。上传备份时也要避免把私钥混入公开资料,文件传送方向可参见 scp 上传、下载与覆盖检查。
忘记口令短语时,ssh-keygen 没有把它恢复出来的功能;若没有其他可用身份或恢复入口,应联系管理员重新登记新公钥。不要覆盖原文件后才尝试找回访问方式。
常见问题
服务器应登记哪个文件?
登记公钥内容,通常来自 .pub 文件,并确认它属于预期账号和密钥。没有扩展名的对应私钥通常留在客户端;文件名可任意更改,最终必须辨认实际内容。
官方文档
生成、指纹与公钥导出见 OpenSSH ssh-keygen 手册,授权文件要求见 sshd 的 authorized_keys 说明,签名认证过程参见 RFC 4252 第 7 节。




