CAUTION
此说明仅适用于MacOS设备。
GitHub的SSH密钥指纹
当尝试使用SSH
克隆Github仓库时,你可能会遇到这样的错误:
$ git clone git@github.com:username/repo.git
Cloning into 'repo'...
The authenticity of host 'github.com (ip)' can't be established.
RSA key fingerprint is SHA256:nThbg6kXU...ARLviKw6E5SY8.
Are you sure you want to continue connecting (yes/no)?
这是因为你缺少公钥指纹, 该密钥可用于验证与Github远程服务器的连接。
你可以将以下ssh密钥条目添加到你的~/.ssh/known_hosts
文件中,以避免手动验证GitHub主机。
# 在VSCode中打开文件
$ code ~/.ssh/known_hosts
将以下内容粘贴到文件中:
github.com ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOMqqnkVzrm0SdG6UOoqKLsabgH5C9okWi0dh2l9GKJl
github.com ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBEmKSENjQEezOmxkZMy7opKgwFB9nkt5YRrYMjNuG5N87uRgg6CLrbo5wAdT/y6v0mKV0U2w0WZ2YB/++Tpockg=
github.com ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQCj7ndNxQowgcQnjshcLrqPEiiphnt+VTTvDP6mHBL9j1aNUkY4Ue1gvwnGLVlOhGeYrnZaMgRK6+PKCUXaDbC7qtbW8gIkhL7aGCsOr/C56SJMy/BCZfxd1nWzAOxSDPgVsmerOBYfNqltV9/hWCqBywINIR+5dIg6JTJ72pcEpEjcYgXkE2YEFXV1JHnsKgbLWNlhScqb2UmyRkQyytRLtL+38TGxkxCflmO+5Z8CSSNY7GidjMIZ7Q4zMjA2n1nGrlTDkzwDCsw+wqFPGQA179cnfGWOWRVruj16z6XyvxvjJwbz0wQZ75XK5tKSb7FNyeIEs4TT4jk+S4dhPeAUC5y+bDYirYgM4GC7uEnztnZyaVWQ7B381AK4Qdrwt51ZqExKbQpTUNn+EjqoTwvqNj4kqx5QUCI0ThS/YkOxJCXmPUWZbhjpCg56i+2aB6CmK2JGhn57K5mj0MNdBXA4/WnwH6XoPWJzK5Nyu2zB3nAZp+S5hpQs+p1vN1/wsjk=
这是来自Github文档的默认SSH密钥指纹。
生成SSH密钥
接下来,当尝试克隆仓库时,你可能会遇到这样的错误:
Permission denied (publickey)
这是因为你缺少SSH密钥,你可以按照以下步骤生成一个新的:
- 打开终端并运行以下命令:
ssh-keygen -t ed25519 -C "<YOUR_EMAIL_ON_GITHUB>@gmail.com"
系统可能会要求你输入密码短语,如下所示:
> Enter passphrase (empty for no passphrase): [Type a passphrase]
> Enter same passphrase again: [Type passphrase again]
输入一个简单的密码短语并且不要忘记它,因为稍后你会需要它。
- 启动SSH代理:
$ eval "$(ssh-agent -s)"
> Agent pid 59566
然后创建~/.ssh/config
文件(或更新现有文件):
$ touch ~/.ssh/config # 如果文件不存在则创建
在文件中添加以下内容:
Host github.com
AddKeysToAgent yes
UseKeychain yes
IdentityFile ~/.ssh/id_ed25519
然后将你的SSH私钥添加到ssh-agent并将密码短语存储在钥匙串中:
$ ssh-add --apple-use-keychain ~/.ssh/id_ed25519
- 将新的SSH密钥添加到你的GitHub账户:
# 将SSH密钥复制到剪贴板
$ pbcopy < ~/.ssh/id_ed25519.pub
打开你的Github账户并导航到你的**SSH和GPG密钥**页面设置,然后创建一个新的SSH密钥。

现在你已经准备好了!尝试使用SSH克隆Github仓库以确保一切正常工作。
愉快地保障安全!