错误：权限被拒绝（公钥）

“权限被拒绝”错误意味着服务器拒绝了你的连接。可能有多种原因，下面解释了最常见的原因。

平台导航

本文档

是否应该在 Git 中使用 sudo 命令或提升的权限？

你不应该在 Git 中使用 sudo 命令或提升的权限，例如管理员权限。

如果你有非常充分的理由必须使用 sudo，那么请确保你对每个命令都使用它。如果你生成 SSH 密钥时没有使用 sudo，然后尝试使用 sudo git push 之类的命令，你将不会使用你生成的相同密钥。

检查你是否连接到正确的服务器

要确保你连接到正确的域，你可以输入以下命令

Shell
ssh -vT [email protected]

你应该看到以下输出

> OpenSSH_8.1p1, LibreSSL 2.7.3
> debug1: Reading configuration data /Users/YOU/.ssh/config
> debug1: Reading configuration data /etc/ssh/ssh_config
> debug1: /etc/ssh/ssh_config line 47: Applying options for *
> debug1: Connecting to github.com port 22.

除非你覆盖设置以使用SSH over HTTPS，否则连接应该在端口 22 上建立。

始终使用“git”用户

所有连接，包括远程 URL 的连接，都必须以“git”用户身份建立。如果你尝试使用你的 GitHub 用户名连接，它将失败

$ ssh -T [email protected]
> Permission denied (publickey).

如果你的连接失败，并且你使用的是带有你的 GitHub 用户名的远程 URL，你可以更改远程 URL 以使用“git”用户。

你应该通过键入以下内容来验证你的连接

Shell
ssh -T [email protected]

你应该看到以下输出

> Hi USERNAME! You've successfully authenticated...

确保你有一个正在使用的密钥

  1. 打开 终端终端Git Bash。

  2. 验证您是否已生成私钥并将其加载到 SSH 中。

    # start the ssh-agent in the background
$ eval "$(ssh-agent -s)"
> Agent pid 59566
$ ssh-add -l -E sha256
> 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)

如果您安装了 GitHub Desktop，您可以使用它来克隆仓库，而无需处理 SSH 密钥。

  1. 如果您使用的是 Git Bash，请开启 ssh-agent

    # start the ssh-agent in the background
$ eval "$(ssh-agent -s)"
> Agent pid 59566

    如果您使用的是其他终端提示符，例如 Git for Windows，请开启 ssh-agent

    # start the ssh-agent in the background
$ eval $(ssh-agent -s)
> Agent pid 59566

    注意： 上面的 eval 命令在您的环境中手动启动 ssh-agent。如果 ssh-agent 已经作为后台系统服务运行，这些命令可能会失败。如果发生这种情况，我们建议您查看您环境的相关文档。

  2. 验证您是否已生成私钥并将其加载到 SSH 中。

    $ ssh-add -l -E sha256
> 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)

  1. 打开 终端终端Git Bash。

  2. 验证您是否已生成私钥并将其加载到 SSH 中。

    $ ssh-add -l -E sha256
> 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)

ssh-add 命令应该打印出一长串数字和字母。如果它没有打印任何内容，您将需要 生成新的 SSH 密钥 并将其与 GitHub 关联。

提示：在大多数系统上，默认的私钥 (~/.ssh/id_rsa 和 ~/.ssh/identity) 会自动添加到 SSH 身份验证代理。除非您在生成密钥时覆盖了文件名，否则您不需要运行 ssh-add path/to/key。

获取更多详细信息

您还可以尝试连接到 [email protected] 来检查密钥是否正在使用。

Shell
ssh -vT [email protected]

您将看到类似以下的输出

> ...
> debug1: identity file /Users/YOU/.ssh/id_rsa type -1
> debug1: identity file /Users/YOU/.ssh/id_rsa-cert type -1
> debug1: identity file /Users/YOU/.ssh/id_dsa type -1
> debug1: identity file /Users/YOU/.ssh/id_dsa-cert type -1
> ...
> debug1: Authentications that can continue: publickey
> debug1: Next authentication method: publickey
> debug1: Trying private key: /Users/YOU/.ssh/id_rsa
> debug1: Trying private key: /Users/YOU/.ssh/id_dsa
> debug1: No more authentication methods to try.
> Permission denied (publickey).

在此示例中，SSH 未找到任何密钥。

  • "identity file" 行末尾的 "-1" 表示 SSH 找不到要使用的文件。
  • "Trying private key" 行表示未找到文件。

如果存在文件，这些行将是 "1" 和 "Offering public key"，如以下输出所示

> ...
> debug1: identity file /Users/YOU/.ssh/id_rsa type 1
> ...
> debug1: Authentications that can continue: publickey
> debug1: Next authentication method: publickey
> debug1: Offering RSA public key: /Users/YOU/.ssh/id_rsa

验证公钥是否已附加到您的帐户

您必须向 GitHub 提供您的公钥以建立安全连接。

  1. 打开终端。

  2. 在后台启动 SSH 代理。

    $ eval "$(ssh-agent -s)"
> Agent pid 59566

  3. 找到并记下您的公钥指纹。

    $ ssh-add -l -E sha256
> 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)

  4. 在 GitHub 上任何页面的右上角，单击您的个人资料照片，然后单击设置。

  5. 在侧边栏的“访问”部分，点击 ** SSH 和 GPG 密钥**。

  6. 将 SSH 密钥列表与 `ssh-add` 命令的输出进行比较。

  1. 打开命令行。

  2. 在后台启动 SSH 代理。

    $ ssh-agent -s
> Agent pid 59566

  3. 找到并记下您的公钥指纹。

    $ ssh-add -l -E sha256
> 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)

  4. 在 GitHub 上任何页面的右上角，单击您的个人资料照片，然后单击设置。

  5. 在侧边栏的“访问”部分，点击 ** SSH 和 GPG 密钥**。

  6. 将 SSH 密钥列表与 `ssh-add` 命令的输出进行比较。

  1. 打开终端。

  2. 在后台启动 SSH 代理。

    $ eval "$(ssh-agent -s)"
> Agent pid 59566

  3. 找到并记下您的公钥指纹。如果您使用的是 OpenSSH 6.7 或更早版本

    $ ssh-add -l
> 2048 a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)

    如果您使用的是 OpenSSH 6.8 或更高版本

    $ ssh-add -l -E md5
> 2048 MD5:a0:dd:42:3c:5a:9d:e4:2a:21:52:4e:78:07:6e:c8:4d /Users/USERNAME/.ssh/id_rsa (RSA)

  4. 在 GitHub 上任何页面的右上角，单击您的个人资料照片，然后单击设置。

  5. 在侧边栏的“访问”部分，点击 ** SSH 和 GPG 密钥**。

  6. 将 SSH 密钥列表与 `ssh-add` 命令的输出进行比较。

如果您在 GitHub 上没有看到您的公钥，您需要 将您的 SSH 密钥添加到 GitHub 以将其与您的计算机关联。

**警告**：如果您在 GitHub 上看到一个不熟悉的 SSH 密钥，请立即将其删除并通过 GitHub 支持门户 联系我们以获取进一步的帮助。未识别的公钥可能表明存在潜在的安全问题。有关更多信息，请参阅“查看您的 SSH 密钥”。