在 GitHub 上使用 SSH 和 GPG

2022 年 5 月 20 日 星期五(已编辑)
/ , , ,
147
摘要
好久不见,快 1 年没更新了。今天闲的没事配置了一下 SSH 和 GPG ,顺便写个教程吧...
这篇文章上次修改于 2024 年 3 月 9 日 星期六,可能部分内容已经不适用,如有疑问可询问作者。

前言

为什么要配置 SSH

虽然大多数开发者将项目推送到 GitHub 或克隆到本地用的是 HTTPS,但是这有很多弊端,例如:

而 SSH 可以说是弥补是上述的缺点:

  • 使用 SSH 推送几乎不会出现 连接已重置连接超时 这些情况。

  • 使用 SSH 推送或克隆无需输入账号密码

为什么要配置 GPG

起因是因为我有时在 GitHub 上翻阅其他项目的提交记录时,都有 Verified 的标记 ,看起来很舒服


过程

好了,言归正传,下面教程正式开始。

配置 SSH

以 Linux 为例

打开终端

输入如下命令并按照提示输入密码[^1]

这会导致在使用 SSH 时需要输入密码。 如不想,请不输入密码,直接回车(不推荐),或使用 ssh-agent。

Windows 用户请在 Git Bash 中操作或在安装 Win32-OpenSSH 后在任意终端中操作。

ssh-keygen -t ed25519 -C "你的 GitHub 上设置的已验证的邮箱"

例如,我的邮箱是 wang3311835119@hotmail.com,那么我就输入:

ssh-keygen -t ed25519 -C "wang3311835119@hotmail.com"

复制公钥

输入如下命令,复制输出公钥内容。

cat ~/.ssh/id_ed25519.pub

添加 SSH 密钥

打开 SSH and GPG keys | GitHub

点击 New SSH key[^2]


粘贴复制的公钥内容到 Key 文本框中,点击 Add SSH key

之后会要求 Sudo 模式验证,完成相应步骤即可即可。


确保配置的有效性

输入如下命令进行测试[^3]

ssh -T git@github.com

出现如下类似内容即为配置成功。


配置 GPG

以 Linux 为例

打开终端

输入如下命令,回车[^4]

Windows 用户请在 Git Bash 中操作。

gpg --full-generate-key

设置算法

敲三次回车(使用默认值),然后再输入 y ,回车。


设置基本信息

输入你的 GitHub 的 用户名验证过的邮箱,确认无误后,输入 O,回车。


设置密码

输入想要设置的密码,确认。再次输入刚才设置的密码,确认。

这会导致在使用 GPG 签名提交时隔一段时间需要输入密码。 如不想,请不输入密码(不推荐),不断确定。

查看生成的 GPG 密钥

输入如下命令,复制红框中类似的密钥 ID

gpg --list-keys

查看生成的 GPG 密钥的公钥

输入如下命令

gpg --armor --export {你的密钥 ID}

复制输出的公钥 >以 -----BEGIN PGP PUBLIC KEY BLOCK----- 开头 以 -----END PGP PUBLIC KEY BLOCK----- 结尾

添加 GPG 密钥

打开 SSH and GPG keys | GitHub ,点击 New GPG key


粘贴复制的公钥内容到 Key 文本框中,点击 Add GPG key

之后会要求 Sudo 模式验证,完成相应步骤即可即可。


配置在 Git 中使用 GPG 密钥对提交进行签名

让 Git 知道签名所用的 GPG 密钥 ID[^5]

git config --global user.signingkey {你的密钥 ID}

在每次提交时,加上 -S 参数,表示此次提交需要用 GPG 密钥进行签名[^6]

git commit -S -m "..."

如果觉得每次都需加上 -S 麻烦,可以设置 Git 为每次的提交自动签名

git config --global commit.gpgsign true

可选步骤:信任 Github 的 GPG 密钥

导入 GitHub 的 GPG 密钥[^7]

curl https://github.com/web-flow.gpg | gpg --import

信任 GitHub 的密钥(用自己的密钥对其进行签名)

gpg --sign-key 4AEE18F83AFDEB23

提示 Really sign? (y/N) 时,请输入 y ,回车。

  • Loading...
  • Loading...
  • Loading...
  • Loading...
  • Loading...