Git配置SSH密钥与私钥的教程(跨平台完整指南)

前言

在使用 git 进行版本控制时，ssh 是一种安全、高效的认证方式。通过配置 ssh 密钥对（公钥和私钥），我们可以免去每次操作远程仓库时输入用户名和密码的麻烦。

本文将详细介绍如何生成 ssh 密钥对，并将其配置到 git 和 github（或其他平台）中。内容涵盖 macos、windows 和 linux 三大主流操作系统平台，帮助你完成完整的 ssh 密钥配置流程。

一、检查是否已有 ssh 密钥

在开始之前，先检查本地是否已经存在 ssh 密钥对：

ls -al ~/.ssh

如果你看到如下文件，则说明已经有密钥对了：

• id_rsa（私钥）
• id_rsa.pub（公钥）

你可以选择继续使用现有密钥，或跳过此步骤并生成新的密钥对。

二、生成新的 ssh 密钥对

无论使用哪种操作系统，我们都可以使用以下命令生成新的 ssh 密钥对：

ssh-keygen -t rsa -b 4096 -c "your_email@example.com"

macos

打开 终端（terminal）。

输入上述命令生成密钥对。

按照提示选择保存路径（默认为 ~/.ssh/id_rsa）。

设置一个可选的密码来保护你的私钥。

添加到钥匙串（推荐）

为了更方便地管理你的 ssh 私钥，在 macos 上你可以运行以下命令将私钥添加到钥匙串中：

ssh-add --apple-use-keychain ~/.ssh/id_rsa

这样可以避免每次使用时都要输入密码。

windows

建议使用 git bash 或 powershell 来执行命令。

1.打开 git bash 或 powershell。

2.输入以下命令生成密钥对：

ssh-keygen -t rsa -b 4096 -c "your_email@example.com"

3.按照提示选择保存路径，默认为 c:\users\<yourusername>\.ssh\id_rsa。

4.可选：设置密码以增强安全性。

使用 ssh agent

为了让 windows 记住你的 ssh 密钥，你需要启动 ssh agent 并添加你的私钥：

# 启动 ssh agent
eval $(ssh-agent -s)

# 添加私钥
ssh-add ~/.ssh/id_rsa

如果你使用的是 windows 10/11，也可以启用 openssh 客户端：

控制面板 > 程序 > 启用或关闭 windows 功能 > openssh 客户端

linux

1.打开 终端（terminal）。

2.输入以下命令生成密钥对：

ssh-keygen -t rsa -b 4096 -c "your_email@example.com"

3.按照提示选择保存路径（默认为 ~/.ssh/id_rsa）。

4.设置一个可选的密码来保护你的私钥。

自动加载 ssh 密钥（可选）

为了不每次都手动添加密钥，可以在 ~/.bashrc 或 ~/.zshrc 中添加以下内容：

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_rsa

然后重新加载配置：

source ~/.bashrc   # 或 source ~/.zshrc

三、将公钥添加到 git 平台（如 github、gitee 等）

1.查看公钥内容：

cat ~/.ssh/id_rsa.pub

复制输出内容。

2.登录你的 git 平台账户（如 github、gitee、gitlab 等）。

3.进入 settings -> ssh and gpg keys（不同平台名称可能略有不同）。

4.点击 new ssh key，粘贴刚刚复制的内容，填写标题后点击保存。

四、测试 ssh 连接

执行以下命令测试是否能成功连接到 git 平台（以 github 为例）：

ssh -t git@github.com

如果看到类似如下信息，说明配置成功：

hi username! you've successfully authenticated, but github does not provide shell access.

五、配置多个 ssh 账户（可选）

如果你有多个 git 账号（例如工作账号和个人账号），可以通过配置不同的 ssh 密钥实现多账户管理。

1. 生成额外的密钥对

例如生成用于工作的密钥：

ssh-keygen -t rsa -b 4096 -c "work_email@example.com" -f ~/.ssh/id_rsa_work

2. 创建或编辑 ssh 配置文件

nano ~/.ssh/config

添加如下内容（以 github 为例）：

# 默认账号
host github.com
    hostname github.com
    user git
    identityfile ~/.ssh/id_rsa

# 工作账号
host github-work
    hostname github.com
    user git
    identityfile ~/.ssh/id_rsa_work

3. 测试不同账户

使用别名来测试：

ssh -t git@github-work

六、常见问题与解决方法

提示“permission denied (publickey)”怎么办？

• 检查 ssh 配置是否正确。
• 确保公钥已添加到 git 平台。
• 使用 ssh -v git@github.com 查看详细错误日志。

如何查看当前使用的 ssh 密钥？

ssh -i ~/.ssh/id_rsa.pub -v git@github.com

如何切换默认密钥？

修改 ~/.ssh/config 文件中的 identityfile 指向即可。

七、结语

配置 ssh 密钥不仅提高了 git 使用的安全性，也极大提升了开发效率。希望这篇博客能够帮助你在 macos、windows 和 linux 上顺利完成 git 的 ssh 密钥配置，愉快地进行代码协作与版本管理！

到此这篇关于git配置ssh密钥与私钥的教程(跨平台完整指南)的文章就介绍到这了,更多相关git配置ssh密钥与私钥内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！