Skip to main content

新增 SSH 密钥到 GitHub 帐户

要在 GitHub.com 上配置帐户以使用新的(或现有的)SSH 密钥,还需要将密钥添加到帐户。

在将新的 SSH 密钥添加到 GitHub.com 上的帐户之前,您应该具有:

在向您在 GitHub.com 上的帐户添加新 SSH 密钥后,您可以重新配置任何本地存储库以使用 SSH。 更多信息请参阅“将远程 URL 从 HTTPS 转换为 SSH”。

注意: GitHub 在 2022 年 3 月 15 日通过删除较旧的不安全密钥类型提高了安全性。

从该日期起,不再支持 DSA 密钥 (ssh-dss)。 您无法将新 DSA 密钥添加到您在 GitHub.com 上的个人帐户。

在 2021 年 11 月 2 日之前 valid_after 的 RSA 密钥 (ssh-rsa) 可以继续使用任何签名算法。 在该日期之后生成的 RSA 密钥必须使用 SHA-2 签名算法。 某些较旧的客户端可能需要升级才能使用 SHA-2 签名。

  1. 将 SSH 公钥复制到剪贴板。

    如果您的 SSH 公钥文件与示例代码不同,请修改文件名以匹配您当前的设置。 在复制密钥时,请勿添加任何新行或空格。

    $ pbcopy < ~/.ssh/id_ed25519.pub
    # Copies the contents of the id_ed25519.pub file to your clipboard

    提示:如果 pbcopy 不可用,可找到隐藏的 .ssh 文件夹,在常用的文本编辑器中打开该文件,并将其复制到剪贴板。

  2. 在任何页面的右上角,单击您的个人资料照片,然后单击 Settings(设置)

    用户栏中的 Settings 图标

  3. In the "Access" section of the sidebar, click SSH and GPG keys.

  4. 单击 New SSH key(新 SSH 密钥)Add SSH key(添加 SSH 密钥)SSH 密钥按钮

  5. 在 "Title"(标题)字段中,为新密钥添加描述性标签。 例如,如果您使用的是个人 Mac,此密钥名称可能是 "Personal MacBook Air"。

  6. 将密钥粘贴到 "Key"(密钥)字段。 密钥字段

  7. 单击 Add SSH key(添加 SSH 密钥)添加密钥按钮

  8. 如有提示,请确认您的 GitHub 密码。 Sudo 模式对话框

  1. 将 SSH 公钥复制到剪贴板。

    如果您的 SSH 公钥文件与示例代码不同,请修改文件名以匹配您当前的设置。 在复制密钥时,请勿添加任何新行或空格。

    $ clip < ~/.ssh/id_ed25519.pub
    # Copies the contents of the id_ed25519.pub file to your clipboard

    提示:如果 clip 不可用,可找到隐藏的 .ssh 文件夹,在常用的文本编辑器中打开该文件,并将其复制到剪贴板。

  2. 在任何页面的右上角,单击您的个人资料照片,然后单击 Settings(设置)

    用户栏中的 Settings 图标

  3. In the "Access" section of the sidebar, click SSH and GPG keys.

  4. 单击 New SSH key(新 SSH 密钥)Add SSH key(添加 SSH 密钥)SSH 密钥按钮

  5. 在 "Title"(标题)字段中,为新密钥添加描述性标签。 例如,如果您使用的是个人 Mac,此密钥名称可能是 "Personal MacBook Air"。

  6. 将密钥粘贴到 "Key"(密钥)字段。 密钥字段

  7. 单击 Add SSH key(添加 SSH 密钥)添加密钥按钮

  8. 如有提示,请确认您的 GitHub 密码。 Sudo 模式对话框

  1. 将 SSH 公钥复制到剪贴板。

    如果您的 SSH 公钥文件与示例代码不同,请修改文件名以匹配您当前的设置。 在复制密钥时,请勿添加任何新行或空格。

    $ cat ~/.ssh/id_ed25519.pub
    # Then select and copy the contents of the id_ed25519.pub file
    # displayed in the terminal to your clipboard

    提示:或者,您也可以找到隐藏的 .ssh 文件夹,在常用的文本编辑器中打开该文件,并将其复制到剪贴板。

  2. 在任何页面的右上角,单击您的个人资料照片,然后单击 Settings(设置)

    用户栏中的 Settings 图标

  3. In the "Access" section of the sidebar, click SSH and GPG keys.

  4. 单击 New SSH key(新 SSH 密钥)Add SSH key(添加 SSH 密钥)SSH 密钥按钮

  5. 在 "Title"(标题)字段中,为新密钥添加描述性标签。 例如,如果您使用的是个人 Mac,此密钥名称可能是 "Personal MacBook Air"。

  6. 将密钥粘贴到 "Key"(密钥)字段。 密钥字段

  7. 单击 Add SSH key(添加 SSH 密钥)添加密钥按钮

  8. 如有提示,请确认您的 GitHub 密码。 Sudo 模式对话框

要了解有关 GitHub CLI 的更多信息,请参阅“关于 GitHub CLI”。

在使用 GitHub CLI 将 SSH 密钥添加到帐户之前,必须向 GitHub CLI 进行身份验证。 更多信息请参阅 GitHub CLI 文档中的 gh auth login

要将 SSH 密钥添加到您的 GitHub 帐户,请使用 ssh-key add 子命令,指定您公钥。

gh ssh-key add key-file

要包括新密钥的标题,请使用 -t--title 标记。

gh ssh-key add key-file --title "personal laptop"

如果按照“生成新的 SSH 密钥”中的说明生成了 SSH 密钥,则可以使用此命令将密钥添加到您的帐户。

gh ssh-key add ~/.ssh/id_ed25519.pub

延伸阅读