前言

在使用 Git 進(jìn)行版本控制時(shí)，SSH 是一種安全、高效的認(rèn)證方式。通過(guò)配置 SSH 密鑰對(duì)（公鑰和私鑰），我們可以免去每次操作遠(yuǎn)程倉(cāng)庫(kù)時(shí)輸入用戶名和密碼的麻煩。

本文將詳細(xì)介紹如何生成 SSH 密鑰對(duì)，并將其配置到 Git 和 GitHub（或其他平臺(tái)）中。內(nèi)容涵蓋 macOS、Windows 和 Linux 三大主流操作系統(tǒng)平臺(tái)，幫助你完成完整的 SSH 密鑰配置流程。

一、檢查是否已有 SSH 密鑰

在開始之前，先檢查本地是否已經(jīng)存在 SSH 密鑰對(duì)：

ls -al ~/.ssh

如果你看到如下文件，則說(shuō)明已經(jīng)有密鑰對(duì)了：

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

你可以選擇繼續(xù)使用現(xiàn)有密鑰，或跳過(guò)此步驟并生成新的密鑰對(duì)。

二、生成新的 SSH 密鑰對(duì)

無(wú)論使用哪種操作系統(tǒng)，我們都可以使用以下命令生成新的 SSH 密鑰對(duì)：

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

macOS

打開 終端（Terminal）。

輸入上述命令生成密鑰對(duì)。

按照提示選擇保存路徑（默認(rèn)為 ~/.ssh/id_rsa）。

設(shè)置一個(gè)可選的密碼來(lái)保護(hù)你的私鑰。

添加到鑰匙串（推薦）

為了更方便地管理你的 SSH 私鑰，在 macOS 上你可以運(yùn)行以下命令將私鑰添加到鑰匙串中：

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

這樣可以避免每次使用時(shí)都要輸入密碼。

Windows

建議使用 Git Bash 或 PowerShell 來(lái)執(zhí)行命令。

1.打開 Git Bash 或 PowerShell。

2.輸入以下命令生成密鑰對(duì)：

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

3.按照提示選擇保存路徑，默認(rèn)為 C:\Users\<YourUsername>\.ssh\id_rsa。

4.可選：設(shè)置密碼以增強(qiáng)安全性。

使用 SSH Agent

為了讓 Windows 記住你的 SSH 密鑰，你需要啟動(dòng) SSH Agent 并添加你的私鑰：

# 啟動(dòng) SSH Agent
eval $(ssh-agent -s)

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

如果你使用的是 Windows 10/11，也可以啟用 OpenSSH 客戶端：

控制面板 > 程序 > 啟用或關(guān)閉 Windows 功能 > OpenSSH 客戶端

Linux

1.打開 終端（Terminal）。

2.輸入以下命令生成密鑰對(duì)：

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

3.按照提示選擇保存路徑（默認(rèn)為 ~/.ssh/id_rsa）。

4.設(shè)置一個(gè)可選的密碼來(lái)保護(hù)你的私鑰。

自動(dòng)加載 SSH 密鑰（可選）

為了不每次都手動(dòng)添加密鑰，可以在 ~/.bashrc 或 ~/.zshrc 中添加以下內(nèi)容：

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

然后重新加載配置：

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

三、將公鑰添加到 Git 平臺(tái)（如 GitHub、Gitee 等）

1.查看公鑰內(nèi)容：

cat ~/.ssh/id_rsa.pub

復(fù)制輸出內(nèi)容。

2.登錄你的 Git 平臺(tái)賬戶（如 GitHub、Gitee、GitLab 等）。

3.進(jìn)入 Settings -> SSH and GPG keys（不同平臺(tái)名稱可能略有不同）。

4.點(diǎn)擊 New SSH key，粘貼剛剛復(fù)制的內(nèi)容，填寫標(biāo)題后點(diǎn)擊保存。

四、測(cè)試 SSH 連接

執(zhí)行以下命令測(cè)試是否能成功連接到 Git 平臺(tái)（以 GitHub 為例）：

ssh -T git@github.com

如果看到類似如下信息，說(shuō)明配置成功：

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

五、配置多個(gè) SSH 賬戶（可選）

如果你有多個(gè) Git 賬號(hào)（例如工作賬號(hào)和個(gè)人賬號(hào)），可以通過(guò)配置不同的 SSH 密鑰實(shí)現(xiàn)多賬戶管理。

1. 生成額外的密鑰對(duì)

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

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

2. 創(chuàng)建或編輯 SSH 配置文件

nano ~/.ssh/config

添加如下內(nèi)容（以 GitHub 為例）：

# 默認(rèn)賬號(hào)
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa

# 工作賬號(hào)
Host github-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_work

3. 測(cè)試不同賬戶

使用別名來(lái)測(cè)試：

ssh -T git@github-work

六、常見問(wèn)題與解決方法

提示“Permission denied (publickey)”怎么辦？

• 檢查 SSH 配置是否正確。
• 確保公鑰已添加到 Git 平臺(tái)。
• 使用 ssh -v git@github.com 查看詳細(xì)錯(cuò)誤日志。

如何查看當(dāng)前使用的 SSH 密鑰？

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

如何切換默認(rèn)密鑰？

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

七、結(jié)語(yǔ)

配置 SSH 密鑰不僅提高了 Git 使用的安全性，也極大提升了開發(fā)效率。希望這篇博客能夠幫助你在 macOS、Windows 和 Linux 上順利完成 Git 的 SSH 密鑰配置，愉快地進(jìn)行代碼協(xié)作與版本管理！

到此這篇關(guān)于Git配置SSH密鑰與私鑰的教程(跨平臺(tái)完整指南)的文章就介紹到這了,更多相關(guān)Git配置SSH密鑰與私鑰內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論