此版本的 GitHub Enterprise 将停止服务 2022-02-16. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

新增 SSH 密钥到 GitHub 帐户

To configure your account on your GitHub Enterprise Server instance to use your new (or existing) SSH key, you'll also need to add the key to your account.

Before adding a new SSH key to your account on your GitHub Enterprise Server instance, you should have:

After adding a new SSH key to your account on your GitHub Enterprise Server instance, you can reconfigure any local repositories to use SSH. 更多信息请参阅“将远程 URL 从 HTTPS 转换为 SSH”。

Note: GitHub is improving security by dropping older, insecure key types.

DSA keys (ssh-dss) are no longer supported. Existing keys will continue to function through March 15, 2022. You cannot add new DSA keys to your user account on your GitHub Enterprise Server instance.

RSA keys (ssh-rsa) with a valid_after before November 2, 2021 may continue to use any signature algorithm. RSA keys generated after that date must use a SHA-2 signature algorithm. Some older clients may need to be upgraded in order to use SHA-2 signatures.

  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. 在用户设置侧边栏中,单击 SSH and GPG keys(SSH 和 GPG 密钥)身份验证密钥

  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 Enterprise Server 密码。 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. 在用户设置侧边栏中,单击 SSH and GPG keys(SSH 和 GPG 密钥)身份验证密钥

  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 Enterprise Server 密码。 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. 在用户设置侧边栏中,单击 SSH and GPG keys(SSH 和 GPG 密钥)身份验证密钥

  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 Enterprise Server 密码。 Sudo 模式对话框

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

Before you can use the GitHub CLI to add an SSH key to your account, you must authenticate to the GitHub CLI. For more information, see gh auth login in the GitHub CLI documentation.

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

gh ssh-key add key-file

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

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

If you generated your SSH key by following the instructions in "Generating a new SSH key", you can add the key to your account with this command.

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

此文档对您有帮助吗?

隐私政策

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或者, 了解如何参与。