Skip to main content

新增 SSH 密钥到 GitHub 帐户

若要在 你的 GitHub Enterprise Server 实例 上配置帐户以使用新的(或现有)SSH 密钥,还需要将密钥添加到帐户。

Platform navigation

Tool navigation

关于向帐户添加 SSH 密钥

可以使用 SSH(安全外壳协议)在 GitHub 上的存储库中访问和写入数据。 通过 SSH 进行连接时,使用本地计算机上的私钥文件进行身份验证。有关详细信息,请参阅“关于 SSH”。

还可以使用 SSH 对提交和标记进行签名。 有关提交签名的详细信息,请参阅“关于提交签名验证”。

生成 SSH 密钥对后,必须将公钥添加到 你的 GitHub Enterprise Server 实例,才能为帐户启用 SSH 访问。

先决条件

在向 你的 GitHub Enterprise Server 实例 上的帐户添加新的 SSH 密钥之前,请完成以下步骤。

  1. 检查现有 SSH 密钥。 有关详细信息,请参阅“检查现有 SSH 密钥”。
  2. 生成新的 SSH 密钥,并将其添加到计算机的 SSH 代理。 有关详细信息,请参阅“生成新的 SSH 密钥并将其添加到 ssh-agent”。

向你的帐户添加新的 SSH 密钥

可以添加 SSH 密钥并将其用于身份验证或提交签名,或同时用于这两个目的。 如果要使用相同的 SSH 密钥进行身份验证和签名,则需要将其上传两次。

向 你的 GitHub Enterprise Server 实例 上的帐户添加新 SSH 身份验证密钥后,可以重新配置任何本地存储库以使用 SSH。 有关详细信息,请参阅“Managing remote repositories”。

Note

若要详细了解 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 --type {authentication|signing}

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

gh ssh-key add KEY-FILE --title "personal laptop"

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

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