从第三方安装 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 应用的要求”。