GitHub 生成 SSH 密钥配置指南
配置 Git 信息
此项也可以省略
在 Git 命令行内输入以下代码:引号内的填写你注册 GitHub 时的用户名和电子邮件。
git config --global user.name "your name"
git config --global user.email "[email protected]"
- 注意
git config命令的--global参数,用了这个参数,表示你这台机器上所有的 Git 仓库都会使用这个配置,当然也可以对某个仓库指定不同的用户名和 Email 地址。
生成公钥
创建 SSH Key。在用户主目录下,看看有没有 .ssh 目录,如果有,再看看这个目录下有没有 id_rsa 和 id_rsa.pub 这两个文件,如果已经有了,可直接跳到下一步。如果没有,打开 Shell(Windows 下打开 Git Bash),创建 SSH Key:
ssh-keygen -t ed25519 -C "118109719+****@users.noreply.github.com" -f ~/.ssh/github-rsa
该命令的核心作用是为 GitHub 仓库生成一对基于 Ed25519 算法的 SSH 密钥对(公钥 + 私钥),并通过指定参数自定义密钥存储路径
-t rsa也行,转为使用 RSA 密钥交换算法-f ~/.ssh/表示生成的路径github-rsa: 生成公钥私钥对的文件名称-C:为密钥添加自定义注释(Comment),注释内容会附加在公钥文件的末尾;该注释的作用:标识密钥的用途 / 归属,方便后续管理(比如多账号 / 多平台密钥区分,避免混淆);此处注释用 GitHub 的 noreply 邮箱,是官方推荐做法(关联 GitHub 账号,便于识别该密钥归属),注释可自定义(如"github-key-for-my-project"),不影响密钥使用。- Windows 下指向
C:\Users\hp,hp表示当前的用户名,这里表示 SSH 文件存储的位置
如果不添加 -f ~/.ssh/github-rsa 则会默认生成文件
~/.ssh/id_rsa~/.ssh/id_rsa.pub
查看并复制公钥内容
公钥以 ssh-ed25519 开头,结尾是你设置的注释。
cat ~/.ssh/github-rsa.pub
直接在命令行内输入上面的代码,就会出现 key,右键复制 key。
回到 GitHub 添加 SSH 公钥
从 ssh-rsa 开始,复制好后回到网页。
- 打开 GitHub → 右上角头像 → Settings → 左侧 SSH and GPG keys → 点击 New SSH key
- 标题自定义(如
笔记本电脑),密钥类型选 Authentication key,粘贴复制的公钥内容,点击 Add SSH key 即可。
默认是没有 SSH key 的。
点击 New SSH key 后,会出现如下页面。
验证成功与否
为了验证是否成功,在 Git Bash 下输入:
ssh -T [email protected]
如果是第一次的会提示是否 continue,输入 yes 就会看到:
You've successfully authenticated, but GitHub does not provide shell access。
这就表示已成功连上 GitHub 了。
无法连接 GitHub
在生成公钥的文件 (~/.ssh/) 下方配置 config 文件。
config 中的内容为:
Host github.com
User git
IdentityFile ~/.ssh/github-rsa
进行验证
ssh -T [email protected]
成功

