使用SSH连接到GitHub

最新推荐文章于 2024-04-09 09:43:54 发布

MountGaoJiang

最新推荐文章于 2024-04-09 09:43:54 发布

阅读量826

点赞数

文章标签： github ssh

本文链接：https://blog.csdn.net/weixin_42895400/article/details/113178561

版权

使用SSH连接到GitHub

背景

从2021年8月13日开始，在对Git操作进行身份验证时，GitHub.com将不再接受帐户密码，并将要求使用基于令牌的身份验证，例如个人访问令牌（对于开发人员）或OAuth或GitHub App安装令牌（对于集成商）适用于GitHub.com上所有经过身份验证的Git操作。您也可以根据需要继续使用SSH密钥。

关于SSH协议

使用SSH协议，你可以连接到远程服务器和服务并进行身份验证。使用SSH密钥，你可以连接到GitHub，而无需在每次访问时都提供用户名和个人访问令牌。

在正式开始之前，强烈建议 Windows 用户使用 Git 程序包自带的 git bash 命令行工具进行操作。

1. 检查现有的SSH密钥

打开Git Bash。

输入ls -al ~/.ssh以查看是否存在现有的SSH密钥：

$ ls -al ~/.ssh
# Lists the files in your .ssh directory, if they exist

检查目录列表，以查看是否已经有公共SSH密钥。默认情况下，公共密钥的文件名是以下之一：
- id_rsa.pub
- id_ecdsa.pub
- id_ed25519.pub
如果你没有现有的公钥和私钥对，或者不希望使用任何可用于连接到GitHub的对，请生成一个新的SSH密钥。
如果你看到列出的现有公共和私有密钥对（例如id_rsa.pub和id_rsa），你希望将它们用于连接到GitHub，则可以将SSH密钥添加到ssh-agent

2. 生成新的SSH密钥

打开Git Bash。
复制粘贴以下文本，替换为你的GitHub电子邮件地址。
```
$ ssh-keygen -t ed25519 -C "your_email@example.com"
```
注意： 如果使用的旧系统不支持Ed25519算法，请使用：
```
$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
```
使用提供的电子邮件作为标签，这将创建一个新的ssh密钥。
```
> Generating public/private ed25519 key pair.
```
当提示你“输入要在其中保存密钥的文件”时，请按Enter。这接受默认文件位置。
```
> Enter a file in which to save the key (/c/Users/you/.ssh/id_ed25519):[Press enter]
```

在提示符下，键入一个安全密码。

> Enter passphrase (empty for no passphrase): [Type a passphrase]
> Enter same passphrase again: [Type passphrase again]

不建议设置密码，因为设置了密码，就需要输入密码，在CMD中需要重复输入密码。

修改安全密码（passphrase）
```
sh-keygen -f ~/.ssh/id_ed25519 -p
```

建议直接回车，重置密码为空，解决重复输入密码的问题。

3. 将SSH密钥添加到ssh-agent(有密码的情况下)

如果安装了GitHub Desktop，则可以使用它来克隆存储库，而不用处理SSH密钥。

确保ssh-agent正在运行。你可以使用“使用SSH密钥密码”中的“自动启动ssh-agent”说明，或手动启动它：
```
# start the ssh-agent in the background
$ eval `ssh-agent -s`
> Agent pid 59566
```
将SSH私钥添加到ssh-agent。如果你使用其他名称创建密钥，或者要添加具有其他名称的现有密钥，请使用私有密钥文件的名称替换命令中的id_ed25519。
```
$ ssh-add ~/.ssh/id_ed25519
```
将SSH密钥添加到你的GitHub帐户

4. 将SSH密钥添加到你的GitHub帐户

要配置GitHub帐户以使用新的（或现有的）SSH密钥，你还需要将其添加到GitHub帐户中。

将SSH公钥复制到剪贴板。

如果你的SSH公钥文件的名称与示例代码的名称不同，请修改文件名以匹配你当前的设置。复制密钥时，请勿添加任何换行符或空格。
```
$ clip < ~/.ssh/id_ed25519.pub
# Copies the contents of the id_ed25519.pub file to your clipboard
```
提示： 如果clip不起作用，则可以找到隐藏的.ssh文件夹，在你喜欢的文本编辑器中打开文件，然后将其复制到剪贴板。
登录到你的 GitHub 账号，在任何页面的右上角，点击你的个人资料照片，然后点击Settings。
在用户设置边栏中，点击SSH and GPG keys。
单击New SSH key。
在Title字段中，为新密钥添加一个描述性标签。例如，“your_computer_username”。
将你的密钥粘贴到“密钥”字段中。
单击Add SSH key。
如果出现确认密码的提示，请确认你的GitHub密码。
添加完成之后会有邮件通知。

5. 测试你的SSH连接

打开Git Bash。

输入以下内容：

$ ssh -T git@github.com
# Attempts to ssh to GitHub

你可能会看到这样的警告：

> The authenticity of host 'github.com (IP ADDRESS)' can't be established.
> RSA key fingerprint is SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8.
> Are you sure you want to continue connecting (yes/no)?

确认你看到的消息中的指纹与GitHub的RSA公钥指纹匹配。如果是这样，则键入yes：
```
> Hi username! You've successfully authenticated, but GitHub does not
> provide shell access.
```
验证结果消息包含您的用户名。

6. 将远程URL从HTTPS切换到SSH

打开Git Bash。
将当前工作目录更改为本地项目。

列出您现有的仓库信息，以获取要更改的仓库的名称。

$ git remote -v
> origin  https://github.com/USERNAME/REPOSITORY.git (fetch)
> origin  https://github.com/USERNAME/REPOSITORY.git (push)

使用git remote set-url命令将远程URL从HTTPS更改为SSH 。

$ git remote set-url origin git@github.com:USERNAME/REPOSITORY.git

验证远程URL是否已更改。

$ git remote -v
# Verify new remote URL
> origin  git@github.com:USERNAME/REPOSITORY.git (fetch)
> origin  git@github.com:USERNAME/REPOSITORY.git (push)

参考

MountGaoJiang

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
使用SSH连接到GitHub

使用SSH连接到GitHub背景从2021年8月13日开始，在对Git操作进行身份验证时，GitHub.com将不再接受帐户密码，并将要求使用基于令牌的身份验证，例如个人访问令牌（对于开发人员）或OAuth或GitHub App安装令牌（对于集成商）适用于GitHub.com上所有经过身份验证的Git操作。您也可以根据需要继续使用SSH密钥。关于SSH协议使用SSH协议，你可以连接到远程服务器和服务并进行身份验证。使用SSH密钥，你可以连接到GitHub，而无需在每次访问时都提供用户名和个人访问
复制链接

扫一扫