macos github ssh密匙配置指南

原创于 2025-10-28 21:30:35 发布 · 779 阅读

19 ·

CC 4.0 BY-SA版权

文章标签：

#macos #github #ssh

第一步：检查电脑是否已存在SSH Keys

github官方文档：https://docs.github.com/en/authentication/connecting-to-github-with-ssh/checking-for-existing-ssh-keys

命令行输入：

ls -al ~/.ssh
# 列出所有.ssh下的文件，如果存在的话
# 如果看到像 id_rsa、id_ecdsa、id_ed25519 这样的文件（通常成对出现，.pub 是公钥），说明你已有密钥

第二步：生成新的SSH Key

github官方文档：https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent

在终端中执行以下命令来创建新密钥

ssh-keygen -t ed25519 -C "your_email@example.com"
# 命令参数说明：
# ed25519：指定密钥类型为更安全、更快速的 Ed25519。
# "your_email@example.com"：使用你github账户的主要(primary)邮箱

执行过程

当系统提示 Enter file in which to save the key 时，直接按 Enter 使用默认路径。
```
> Enter a file in which to save the key (/Users/YOU/.ssh/id_ed25519): [按enter]
```
当系统提示 Enter passphrase 时，你可以设置一个安全密码。这能进一步提升安全性，但如果你希望每次使用密钥时无需输入密码，也可以直接按 Enter 留空

> Enter passphrase (empty for no passphrase): [输入一个密码][直接按enter表示空密码]
> Enter same passphrase again: [再输入一遍]

第三步：将 SSH 密钥添加到 SSH 代理

管理密钥的 ssh-agent 可以让你在每次使用密钥时无需重复输入密码，推荐将密钥添加进去。

启动 ssh-agent：

# 终端执行
eval "$(ssh-agent -s)"
# 输出类似于 Agent pid 59566 则表示启动成功

如果你使用的是macOS Sierra 10.12.2或更高版本，需要执行以下操作：
- 首先检查~/.ssh/config文件是否存在
```
open ~/.ssh/config
# 若返回 "The file /Users/YOU/.ssh/config does not exist."
# 说明文件不存在
```
- 文件不存在，创建文件
```
touch ~/.ssh/config
```
- 打开刚刚创建的文件~/.ssh/config。看个人喜好选用编辑器打开，这里以vscode打开为例：
```
code ~/.ssh/config
```
- 将以下内容添加到config文件中。
  
  注意：路径一定要与你刚刚生成的SSH Key文件的路径相匹配
  
  注意：如果你没有为SSH Key创建密码，请省去UseKeychain yes这一行
  
  注意：如果你收到Bad configuration option: usekeychain错误。请添加一行IgnoreUnknown UseKeychain
```
Host github.com
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_ed25519
```

将你的 SSH 私钥添加到 ssh-agent：

终端执行以下命令

# MacOS Monterey (12.0) 更高版本用户执行以下命令，更低版本解决方案官方文档有答案
ssh-add --apple-use-keychain ~/.ssh/id_ed25519
# 会要求你输入密码，若之前没设置密码，直接按enter

第四步：将 SSH 公钥添加到GitHub 账户

这是最关键的一步，让 GitHub 能够识别你的电脑。

复制你的 SSH 公钥内容。

# 使用终端命令直接复制
pbcopy < ~/.ssh/id_ed25519.pub

在 GitHub 网站中添加密钥：
- 登录 GitHub，点击右上角头像，进入 Settings（设置）。
- 在左侧边栏中，点击 SSH and GPG keys（SSH 和 GPG 密钥）。
- 点击绿色的 New SSH key（新建 SSH 密钥）按钮。
- 在 “Title”（标题）中，为你的密钥起个易于识别的名字（例如 “my_mac_book_pro”）。
- 在 “Key”（密钥）方框中，粘贴你刚刚复制的公钥内容。
- 最后，点击 Add SSH key（添加 SSH 密钥）完成。

第五步：测试 SSH 连接

验证一下是否配置成功

在终端中输入以下命令：

ssh -T git@github.com

你可能会看到类似如下的安全警告，这是正常的，输入 yes 并按 Enter 即可。

ED25519 key fingerprint is HAB111:abcdefghijklmnopqrstuywxyz.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])? [输入yes，按enter]

如果配置成功，将会返回以下欢迎消息：

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