Git 和 SSH：配置安全连接的分步指南 – wiki基地

作者： /

Git 和 SSH：配置安全连接的分步指南

在当今的软件开发世界中，Git 作为版本控制系统的重要性毋庸置疑。而大多数情况下，我们通过远程仓库（如 GitHub、GitLab、Bitbucket 等）来协作开发。为了安全地与这些远程仓库进行交互，SSH（Secure Shell）协议提供了一种加密的连接方式，避免了使用用户名和密码明文传输带来的安全风险。本文将深入探讨如何配置 Git 和 SSH，建立安全、可靠的连接。

一、理解 SSH 的工作原理

SSH 是一种网络协议，用于在不安全的网络中安全地进行远程登录和其他网络服务。它通过加密客户端和服务器之间的所有通信来防止窃听、连接劫持和其他攻击。

1. 密钥对

SSH 的核心是密钥对：一个公钥和一个私钥。

  • 公钥（Public Key）： 可以公开分享，用于加密数据。在 Git 的场景中，公钥会被添加到你的远程仓库账户（如 GitHub）中。
  • 私钥（Private Key）： 必须严格保密，用于解密数据。私钥存储在你的本地计算机上，Git 使用它来证明你的身份。

2. 认证过程

当你尝试通过 SSH 连接到远程仓库时，会发生以下认证过程：

  1. 连接请求： 你的 Git 客户端使用 SSH 协议向远程服务器发起连接请求。
  2. 服务器发送公钥： 服务器将其公钥发送给你的客户端。
  3. 客户端验证公钥： 客户端通常会检查服务器公钥的指纹，以确保连接的是正确的服务器，防止中间人攻击（Man-in-the-Middle Attack）。
  4. 客户端生成会话密钥： 客户端生成一个随机的会话密钥（Session Key），用于后续的加密通信。
  5. 客户端加密会话密钥： 客户端使用服务器的公钥加密会话密钥，并将其发送给服务器。
  6. 服务器解密会话密钥： 服务器使用其私钥解密会话密钥。
  7. 客户端发送身份验证信息：客户端使用你的私钥对一个挑战信息进行签名,证明你拥有对应的私钥.
  8. 服务器验证签名：服务器使用你先前上传的公钥来验证签名.如果验证成功,则身份验证成功.
  9. 建立安全连接： 双方现在都拥有相同的会话密钥，可以使用它来加密和解密后续的通信，建立安全的连接。

二、生成 SSH 密钥对

在配置 Git 使用 SSH 之前，你需要生成一个 SSH 密钥对。

1. 检查是否已存在密钥对

在生成新的密钥对之前，最好先检查一下你的系统中是否已经存在 SSH 密钥。打开终端（macOS 或 Linux）或 Git Bash（Windows），执行以下命令：

bash
ls -al ~/.ssh

如果输出显示 id_rsa 和 id_rsa.pub（或其他类似名称的文件，如 id_ed25519 和 id_ed25519.pub），则表示你已经拥有一个密钥对，可以跳过生成步骤。

2. 生成新的密钥对

如果需要生成新的密钥对，可以使用 ssh-keygen 命令。在终端或 Git Bash 中执行以下命令：

bash
ssh-keygen -t rsa -b 4096 -C "[email protected]"

  • -t rsa：指定密钥类型为 RSA。RSA 是一种广泛使用的非对称加密算法。
  • -b 4096：指定密钥长度为 4096 位。更长的密钥更安全，但生成速度也更慢。
  • -C "[email protected]"：添加一个注释，通常是你的电子邮件地址，方便识别密钥。

3. 设置密钥存储位置和密码（可选）

运行 ssh-keygen 命令后，系统会提示你：

  • Enter file in which to save the key (/Users/your_username/.ssh/id_rsa): 这是密钥的默认存储位置。通常直接按 Enter 键接受默认位置即可。
  • Enter passphrase (empty for no passphrase): 设置一个密码（passphrase）来保护你的私钥。强烈建议设置一个强密码，以防止私钥泄露后被他人使用。
  • Enter same passphrase again: 再次输入密码进行确认。

完成这些步骤后，ssh-keygen 会在你的 ~/.ssh 目录下生成两个文件：

  • id_rsa：私钥文件，必须妥善保管，不要泄露给任何人。
  • id_rsa.pub：公钥文件，可以公开分享，用于添加到远程仓库账户。

4. 启动 ssh-agent 并添加私钥 (可选,但强烈推荐)
为了避免每次连接到远程服务器时都输入密码,可以使用ssh-agent来管理私钥.
bash
eval "$(ssh-agent -s)" #启动 ssh-agent
ssh-add ~/.ssh/id_rsa #将私钥添加至 ssh-agent
如果设置了密码,则ssh-add会提示输入密码.

三、将 SSH 公钥添加到远程仓库

生成 SSH 密钥对后，你需要将公钥添加到你的远程仓库账户（如 GitHub、GitLab、Bitbucket 等）中。

1. 复制 SSH 公钥

首先，你需要复制你的公钥内容。可以使用以下命令（根据你的操作系统和密钥文件名进行调整）：

  • macOS:

    bash
    pbcopy < ~/.ssh/id_rsa.pub
    * Linux (xclip):

    bash
    xclip -sel clip < ~/.ssh/id_rsa.pub
    * Windows (Git Bash):

    bash
    cat ~/.ssh/id_rsa.pub | clip
    * 手动复制:
    使用文本编辑器打开~/.ssh/id_rsa.pub文件,然后复制全部内容.

这些命令会将公钥内容复制到你的剪贴板。

2. 添加公钥到远程仓库账户

以 GitHub 为例，添加 SSH 公钥的步骤如下：

  1. 登录 GitHub 账户。
  2. 点击右上角的头像，选择 “Settings”。
  3. 在左侧边栏中，选择 “SSH and GPG keys”。
  4. 点击 “New SSH key” 或 “Add SSH key” 按钮。
  5. 在 “Title” 字段中，为你的密钥输入一个描述性的名称（例如，”My Home Laptop”)。
  6. 在 “Key” 字段中，粘贴你之前复制的公钥内容。
  7. 点击 “Add SSH key” 按钮。

对于其他远程仓库（GitLab、Bitbucket 等），添加 SSH 公钥的步骤类似，只是界面和菜单选项可能略有不同。请参考相应平台的文档。

四、测试 SSH 连接

添加 SSH 公钥后，你可以测试一下是否能够成功连接到远程仓库。

在终端或 Git Bash 中执行以下命令（将 github.com 替换为你的远程仓库地址）：

bash
ssh -T [email protected]

如果一切配置正确，你应该会看到类似以下的消息：

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

这条消息表明你已经成功通过 SSH 认证，但 GitHub 不提供 shell 访问（这是正常的，你只需要通过 Git 进行代码操作）。

如果遇到连接问题，请仔细检查以下几点：

  • 私钥权限： 确保你的私钥文件（id_rsa）的权限设置为只有你自己可以读取（通常是 600）。可以使用 chmod 600 ~/.ssh/id_rsa 命令来设置权限。
  • 公钥是否正确复制： 确保你复制的是完整的公钥内容，没有遗漏或多余的字符。
  • 远程仓库账户设置： 确保你已将公钥正确添加到远程仓库账户的 SSH 密钥设置中。
  • 网络连接： 确保你的网络连接正常，可以访问远程仓库。
  • 防火墙设置: 确保防火墙没有阻止SSH连接(通常是22端口).

五、配置 Git 使用 SSH

现在，你已经成功设置了 SSH 连接，接下来需要配置 Git 使用 SSH 来克隆、拉取和推送代码。

1. 克隆仓库时使用 SSH URL

当你克隆一个仓库时，可以选择使用 HTTPS URL 或 SSH URL。要使用 SSH，你需要使用 SSH URL。

在 GitHub 上，你可以找到仓库的 SSH URL。通常在仓库页面的 “Code” 按钮下，选择 “SSH” 选项卡，就可以看到 SSH URL。

例如，一个 SSH URL 可能如下所示：

[email protected]:username/repository.git

使用 SSH URL 克隆仓库的命令如下：

bash
git clone [email protected]:username/repository.git

2. 修改已克隆仓库的远程 URL

如果你已经使用 HTTPS URL 克隆了一个仓库，也可以将其远程 URL 修改为 SSH URL。

首先，使用 git remote -v 命令查看当前的远程 URL：

bash
git remote -v

输出可能如下所示：

origin https://github.com/username/repository.git (fetch)
origin https://github.com/username/repository.git (push)

要将远程 URL 修改为 SSH URL，可以使用 git remote set-url 命令：

bash
git remote set-url origin [email protected]:username/repository.git

现在，再次运行 git remote -v，你应该会看到远程 URL 已经更新为 SSH URL。

3. 使用多个 SSH 密钥 (高级)

在某些情况下，你可能需要使用多个 SSH 密钥，例如，一个用于个人项目，一个用于工作项目。

要使用多个 SSH 密钥，你可以创建多个密钥对，并将它们添加到不同的远程仓库账户。然后，你可以通过 SSH 配置文件（~/.ssh/config）来指定 Git 在连接到不同服务器时使用哪个密钥。

以下是一个示例 SSH 配置文件：

“`
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_rsa_personal

Host gitlab.com
HostName gitlab.com
User git
IdentityFile ~/.ssh/id_rsa_work
“`

在这个配置文件中：

  • Host：指定一个别名，用于标识不同的服务器。
  • HostName：指定服务器的实际主机名。
  • User：指定连接到服务器时使用的用户名（通常是 git）。
  • IdentityFile：指定要使用的私钥文件。

通过这个配置文件，当你连接到 github.com 时，Git 会自动使用 ~/.ssh/id_rsa_personal 私钥；当你连接到 gitlab.com 时，Git 会自动使用 ~/.ssh/id_rsa_work 私钥。
你可以通过ssh -F ~/.ssh/config -T github_alias测试连接.

六、常见问题排查

  1. Permission denied (publickey)

    这个错误通常表示 SSH 认证失败。请检查以下几点：

    • 你的私钥是否正确生成并存储在 ~/.ssh 目录下。
    • 你的公钥是否已正确添加到远程仓库账户的 SSH 密钥设置中。
    • 你的私钥文件的权限是否设置为只有你自己可以读取（chmod 600 ~/.ssh/id_rsa）。
    • 如果使用了密码,是否使用了ssh-agent并添加了私钥.

  2. Could not resolve hostname

    这个错误表示无法解析远程仓库的主机名。请检查以下几点：

    • 你的网络连接是否正常。
    • 你输入的远程仓库 URL 是否正确。
    • 你的 DNS 设置是否正确。

  3. Connection timed out

    这个错误表示连接超时。请检查以下几点：

    • 你的网络连接是否正常。
    • 远程仓库服务器是否可用。
    • 你的防火墙是否阻止了 SSH 连接（通常是 22 端口）。

  4. Agent admitted failure to sign using the key

    这个错误通常发生在使用 ssh-agent 时，表示 ssh-agent 无法使用你的私钥进行签名。请检查以下几点：
    * 是否已启动ssh-agent(eval "$(ssh-agent -s)")
    * 是否已将私钥添加至ssh-agent(ssh-add ~/.ssh/id_rsa)
    * 私钥密码是否正确.

七、总结

通过配置 Git 和 SSH，你可以建立安全、可靠的连接，与远程仓库进行协作开发。本文详细介绍了 SSH 的工作原理、生成密钥对、将公钥添加到远程仓库、测试连接、配置 Git 使用 SSH 以及常见问题排查等步骤。希望这篇文章能够帮助你更好地理解和使用 Git 和 SSH，提高你的开发效率和安全性。 记住，安全始终是第一位的，务必妥善保管你的私钥，并设置一个强密码来保护它。

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部