从 GitHub Marketplace 为您的组织安装 GitHub 应用

关于 GitHub Marketplace

本文适用于从 GitHub Marketplace 安装和购买 GitHub 应用。有关从 GitHub Marketplace 以外的来源安装 GitHub 应用的更多信息，请参阅“从第三方安装 GitHub 应用”。

如果您在组织帐户上安装了 GitHub 应用，并且选择了付费计划，您将在组织的当前账单日期使用组织的现有付款方式支付应用订阅费用。

如果您选择带有免费试用期的付费计划，您可以在试用期内随时取消，无需付费，但您将自动失去对该应用的访问权限。您的付费订阅将在 14 天试用期结束时开始。有关更多信息，请参阅“关于 GitHub Marketplace 的账单”。

有关从 GitHub Marketplace 安装 OAuth 应用而不是 GitHub 应用的更多信息，请参阅“在您的组织中安装 OAuth 应用”。

关于安装 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 Marketplace，请在 GitHub.com 的左上角选择，然后单击 Marketplace.
浏览到您要安装的应用，然后单击应用名称。
在应用页面上的“定价和设置”下，单击您要使用的定价计划。
单击**免费安装**、**使用 GitHub 购买**或**免费试用 14 天**。
为应用选择一个安装组织。根据您组织的服务条款，此过程略有不同。
- 如果您已授予 GitHub 收集您组织的姓名和地址信息的权限，请在“账单信息”部分选择**切换账单帐户** 下拉菜单，然后单击您要安装应用的组织。
- 否则，在“查看您的订单”下，选择**帐户**下拉菜单，然后单击您要安装应用的组织。
如果您选择了付费计划，请查看您的付款方式。
- 要更改组织中已有的付款方式，请单击**编辑**，然后填写表格以添加新的付款方式。
- 如果组织没有付款方式，请单击**添加付款方式**，然后填写表格以添加信用卡或 PayPal 帐户。
单击**完成订单并开始安装**。
如果应用需要访问仓库，请选择**所有仓库**或**仅选择仓库**。

如果应用创建了任何仓库，应用将自动获得对这些仓库的访问权限。
如果您选择授予应用对部分仓库而不是所有仓库的访问权限，请键入您要授予应用访问权限的每个仓库的名称，然后单击仓库名称以选择它。
查看应用的访问权限，然后单击**安装**。