从第三方安装 GitHub 应用

你可以直接从应用所有者处安装 GitHub 应用，以在你的个人帐户或组织中使用。

本文内容

关于安装 GitHub 应用

本文介绍如何直接从应用所有者处安装 GitHub 应用，而不是从 GitHub Marketplace 处安装。有关从 GitHub Marketplace 安装 GitHub 应用的详细信息，请参阅“为你的个人帐户从 GitHub Marketplace 安装 GitHub 应用”和“为你的组织从 GitHub Marketplace 安装 GitHub 应用”。有关安装你拥有的 GitHub 应用的详细信息，请参阅“安装你自己的 GitHub 应用”。

为了在你的存储库或组织中使用 GitHub 应用，你必须在你的组织或个人帐户上安装该应用。你可以在多个帐户上安装同一个 GitHub 应用。例如，如果你在你的个人帐户和几个你拥有的组织上安装该应用，你将能够在你的个人存储库、安装该应用的组织以及这些组织拥有的存储库上使用该应用。

当你安装应用时，你授予该应用访问其请求的组织和存储库资源的权限。在安装过程中，GitHub 将告诉你 GitHub 应用请求了哪些权限。有关 GitHub 应用可以使用这些权限发出的 REST API 请求的详细信息，请参阅“GitHub 应用所需的权限”。

当您安装应用程序时，您还可以选择授予 GitHub 应用程序访问哪些存储库。

在安装 GitHub 应用程序之前，您应该确保您信任 GitHub 应用程序的所有者。您还应该查看 GitHub 应用程序请求的权限，并确保您愿意授予这些权限。有关 GitHub 应用程序可以使用这些权限发出的 REST API 请求的更多信息，请参阅“GitHub 应用程序所需的权限”。

您可以安装的应用程序数量没有限制。

安装和授权之间的区别

在安装 GitHub 应用程序后，您可能还会被要求授权该应用程序。

当您在您的帐户或组织上安装 GitHub 应用程序时，您授予该应用程序访问其请求的组织和存储库资源的权限。您还可以指定该应用程序可以访问哪些存储库。在安装过程中，GitHub 应用程序将指示您授予哪些存储库和组织权限。有关不同权限使 GitHub 应用程序能够做什么的更多信息，请参阅“为 GitHub 应用程序选择权限”。

例如，您可能会授予 GitHub 应用程序读取存储库元数据和编写问题的权限，并且您可能会授予 GitHub 应用程序访问您所有存储库的权限。

Screenshot of the page to install a GitHub App. The app is requesting read access to metadata and write access to issues. The app can also request user authorization for read access to emails and write access to gists.

当您授权 GitHub 应用程序时，您根据该应用程序请求的帐户权限授予该应用程序访问您 GitHub 帐户的权限。在授权过程中，该应用程序将指示该应用程序可以在您的帐户上访问哪些资源。当您授权 GitHub 应用程序时，您还授予该应用程序代表您采取行动的权限。

例如，您可能会授予 GitHub 应用程序读取您的电子邮件地址和编写 gist 的权限。

Screenshot of the page to authorize a GitHub App. The app is requesting read access to email and write access to gists.

您可以在不授权应用程序的情况下安装 GitHub 应用程序。同样，您可以在不安装应用程序的情况下授权该应用程序。

有关授权 GitHub 应用程序的更多信息，请参阅“授权 GitHub 应用程序”。

安装 GitHub 应用程序的要求

任何人都可以在其个人帐户上安装 GitHub 应用程序。

组织所有者可以在其组织中安装 GitHub 应用。

属于组织所有仓库的管理员也可以在组织中安装 GitHub 应用，前提是他们仅授予该应用对其具有管理员权限的仓库的访问权限，并且该应用未请求任何组织权限或“仓库管理”权限。组织所有者可以阻止作为仓库管理员的外部协作者安装 GitHub 应用。

不是组织所有者或仓库管理员的组织成员仍然可以在安装过程中选择该组织。GitHub 不会安装该应用，而是会向组织所有者发送通知，请求组织所有者安装该应用。

组织中的“应用管理器”角色不会赋予某人组织中安装 GitHub 应用的能力。有关详细信息，请参阅“关于 GitHub 应用管理器”。

安装 GitHub 应用

在安装过程中，应用所有者会将你定向到一个 GitHub URL 以安装 GitHub 应用。该 URL 看起来类似于 https://github.com/apps/APP-NAME/installations/new，其中 APP-NAME 是 GitHub 应用的名称。

  1. 选择要安装 GitHub 应用的位置。你可以选择你的个人帐户或你成为其成员的组织。

  2. 如果该应用需要仓库权限，请选择所有仓库或仅选择仓库。该应用始终至少具有对 GitHub 上所有公共仓库的只读访问权限。

    如果该应用不需要仓库权限，则会省略这些选项。

  3. 如果你在上一步中选择了仅选择仓库，请在选择仓库下拉列表下选择你希望该应用访问的仓库。

    如果该应用创建任何仓库，则该应用将自动获得对这些仓库的访问权限。

  4. 查看该应用请求的权限。有关 GitHub 应用可以使用这些权限发出的 REST API 请求的详细信息，请参阅“GitHub 应用所需的权限”。

  5. 单击安装、安装并请求或请求。显示的按钮取决于你的组织所有者是否必须批准该应用请求的部分、全部或全部访问权限。有关详细信息，请参阅“安装 GitHub 应用的要求”。