从 Ubuntu 到 Windows：如何在不同系统间共享 Git SSH 配置

背景说明

在现代软件开发中，许多开发者会同时在多个操作系统或环境中进行工作。例如，你可能在 Ubuntu 服务器上运行应用，而在本地 Windows 机器上进行代码开发和管理。在这种跨平台工作中，Git 是一个重要的工具，用于版本控制和代码管理。

然而，频繁地在推送（push）或拉取（fetch）代码时输入用户名和密码不仅繁琐，而且会影响开发效率。为了避免这种麻烦，使用 SSH 密钥进行身份验证是一个非常有效的解决方案。通过 SSH 密钥，你只需进行一次身份验证，以后每次操作都不再需要输入用户名和密码。

在上一篇博客中，我们详细介绍了如何在 Ubuntu 系统上生成 SSH 密钥，并将公钥上传到远程仓库（如 Gitee）。如果你还没有配置公钥，可以参考这篇博客：设置 Git 默认推送不需要输入账号和密码【Ubuntu、SSH】，学习如何生成并上传公钥。

通过该教程，你应该已经能够通过 SSH 协议在 Ubuntu 上顺利进行 Git 操作，而不再需要每次输入密码。那么，如何在 Windows 系统上配置 SSH，使得在 Windows 环境下也能享受 SSH 免密推送和拉取代码的便捷呢？

答案很简单：只需将私钥文件从 Ubuntu 系统复制到 Windows 系统，并配置正确的 SSH 配置文件即可。下面我们将详细介绍如何在 Windows 上设置 SSH 连接，并确保与 Gitee 等远程仓库的交互不再需要输入用户名和密码。

1. 确保已有的 SSH 公钥已上传到远程仓库

如前所述，如果你之前已经在 Ubuntu 系统上生成了 SSH 密钥，并且将公钥上传到 Gitee 或其他远程仓库，那么你只需要在 Windows 上配置正确的私钥文件即可。公钥的作用是在远程服务器上进行身份验证，因此你不需要在 Windows 上重新上传公钥。

2. 将私钥文件拷贝到 Windows 系统

1. 在 Ubuntu 上找到并拷贝私钥文件： 在 Ubuntu 上，私钥文件通常位于 ~/.ssh/id_rsa。如果你指定了自定义的私钥文件名（如 id_rsa_gitee），请确保将其复制到 Windows 上相应的目录。

2. 将私钥文件复制到 Windows 系统： 打开你的 Ubuntu 系统文件管理器，找到私钥文件（如 id_rsa_gitee），并将其复制到 Windows 系统中的 C:/Users/admin/.ssh/ 目录下。如果该目录不存在，可以手动创建 .ssh 文件夹。

   • 在 Windows 系统上，私钥文件的路径应为 C:/Users/admin/.ssh/id_rsa_gitee，这是默认的 SSH 配置路径。确保文件正确无误地复制过去。

3. 更新 SSH 配置文件

1. 编辑 SSH 配置文件： 在 Windows 上，SSH 配置文件存储在 C:/Users/admin/.ssh/config 中。通过 Git Bash 或 PowerShell 打开该目录，并查看是否存在 config 文件。如果文件不存在，可以手动创建。

2. 配置 SSH 使用私钥： 在 config 文件中添加以下配置：

   Host gitee.com
       HostName gitee.com
       User Leo
       IdentityFile C:/Users/admin/.ssh/id_rsa_gitee
       IdentitiesOnly yes
   

   • Host: 这是指远程主机的别名，gitee.com 会匹配 SSH 连接时的目标域名。
   • HostName: 实际的远程主机地址，通常是 gitee.com。
   • User: 你在远程仓库的用户名，例如 Leo。
   • IdentityFile: 指定 SSH 私钥的路径，即你在 Windows 系统上复制的 id_rsa_gitee 文件的路径。
   • IdentitiesOnly: 确保 SSH 客户端只使用指定的私钥文件进行身份验证，而不是尝试其他默认密钥。

   保存并关闭 config 文件。

4. 确保私钥文件权限正确

虽然 Windows 系统不像 Linux 系统那样严格控制文件权限，但为了确保 SSH 客户端能正确使用私钥文件，建议进行一些基本的权限设置。

1. 设置文件权限： 右键点击 id_rsa_gitee 文件，选择 “属性”。
2. 确保文件只对你自己可读，避免其他用户读取该文件。

5. 确认 SSH 配置是否生效

在 Git Bash 或 PowerShell 中，运行以下命令验证 SSH 配置是否生效：

ssh -T [email protected]

如果配置正确，你应该看到类似以下的信息：

Hi Leo! You've successfully authenticated, but GITEE.COM does not provide shell access.

如果看到上述消息，说明 SSH 配置生效，Git 可以通过 SSH 协议进行身份验证，免去输入密码的麻烦。

6. 更新远程仓库的 URL 为 SSH 地址

确保 Git 仓库使用 SSH 协议与远程仓库进行交互。如果你已经通过 HTTPS 克隆了仓库，首先需要将远程仓库的 URL 更改为 SSH 格式。

1. 查看当前远程仓库 URL：

   git remote -v
   

2. 将远程仓库 URL 更改为 SSH 地址：

   git remote set-url origin [email protected]:Leo_la/patent-knowledge-graph.git
   

   这样，Git 就会使用 SSH 协议与 Gitee 进行交互，后续所有的 git push 和 git pull 操作都将通过 SSH 进行，而不需要每次输入用户名和密码。

   如果你需要从 Gitee 克隆仓库，也可以使用如下命令：

   git clone [email protected]:Leo_la/patent-knowledge-graph.git
   

总结

通过以上步骤，你可以在 Windows 系统上成功配置 SSH 密钥，使得 Git 操作时无需每次输入用户名和密码。主要步骤包括：

1. 将 Ubuntu 系统中的私钥文件复制到 Windows 系统。
2. 更新 Windows 上的 SSH 配置文件，确保 Git 使用正确的私钥进行身份验证。
3. 验证 SSH 配置是否生效，确保能够成功通过 SSH 连接远程仓库。
4. 修改 Git 仓库的远程 URL 为 SSH 协议，确保后续操作通过 SSH 进行。

这样，你就可以在 Windows 上通过 SSH 协议顺利地进行代码的推送和拉取，免去每次输入密码的麻烦，提升工作效率并增强代码管理的安全性。如果你需要在多个机器或环境中工作，只需在相应的机器上配置 SSH 即可。