<aside>
📖
关于这篇文章
这是一份 Windows / Linux 双平台的 SSH 密钥实战手册,从 Bitwarden 恢复到 ssh-agent 配置再到 Git 调用链全打通。目标是:换电脑 5 分钟回归工作环境。
适合谁读
- 重装系统 / 换电脑 / 拿到新机器,想最快恢复 SSH 工作环境的人
- 想把 GitHub / 服务器 SSH 走
ssh-agent + passphrase 双保险的人
- 在服务器上配 ssh-agent 被 systemd 折腾过、想要一个不依赖 systemd 也能用的方案的人
怎么读这篇文章
- 第一次配置 → 从 [① 准备私钥] 顺序做完
- 换电脑速查 → 直接跳到 [压缩流程]
- 某一步卡住 → 看 [排错速查] 的表格
- 想理解原理 → 看 [写在最前:先搞懂 SSH 的「方向」] 和 [最后的心智模型]
版权与声明
本文为个人实操笔记整理而成,仅供学习与参考。其中涉及的密钥管理 / 系统配置请结合自己的环境评估,并对自己的安全决策负责。
首发与转载
👉 这是我自己每次换电脑都要翻一遍的私人备忘录,索性公开成博客。 目标是:从一台空白机器开始,5 分钟内从 Bitwarden 把 SSH 密钥救回来,让 git push 不再每次问我 passphrase。Windows / Linux 双平台并行讲。
📑 这篇会讲什么
先让你大致知道这篇博客的结构,再决定要不要往下读:
- 🔹 心智模型:搞懂 SSH 的「方向」,理清密钥对到底归属谁
- 🔹 准备工作:适用场景 + 前置检查
- 🔹 五步操作:准备私钥 → 启 ssh-agent → 加进 agent → 让 Git 走对 ssh → 公钥贴 GitHub
- 🔹 验证全链路 + 平台特殊情况(Windows / Linux 各自的坑)
- 🔹 Bitwarden 条目模板:怎么存才能未来一键恢复
- 🔹 日常使用 + 排错速查表
- 🔹 压缩流程:5 步速查,回头翻只看这里就够了
- 🔹 最后的心智模型:把所有命令归到一条原则上
下面是可点击跳转的完整目录:
🧠 写在最前:先搞懂 SSH 的「方向」
说实话,我自己一开始也以为 SSH 是「服务器之间的通讯协议」,每台机器都生成一对密钥放着就好。后来踩坑多了才意识到——这个模型对了一半,错了另一半。
真正的模型:C/S,不对称
SSH 走的是 客户端-服务器(C/S)模型,两端角色不对等:
- 客户端 = 发起连接的那一方(比如你的笔记本想
git push)
- 服务器 = 被连接的那一方(比如 GitHub、云主机、跳板机)