Skip to main content

此版本的 GitHub Enterprise 将停止服务 2022-06-03. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

在 Git 中缓存 GitHub 凭据

如果您使用 HTTPS 克隆 GitHub Enterprise Server 存储库,我们建议您使用 GitHub CLI 或 Git Credential Manager (GCM) 来记住您的凭据。

提示:如果您使用 SSH 克隆 GitHub Enterprise Server 仓库,则可使用 SSH 密钥进行身份验证,而不是使用其他凭据。 有关设置 SSH 连接的信息,请参阅“生成 SSH 密钥”。

GitHub CLI

当您选择 HTTPS 作为 Git 操作的首选协议时,GitHub CLI 将自动为您存储 Git 凭据,并对询问您是否要使用 GitHub Enterprise Server 凭据向 Git 进行身份验证的提示回答“是”。

  1. 在 macOS、Windows 或 Linux 上安装 GitHub CLI。
  2. 在命令行中,输入 gh auth login,然后按照提示操作。
    • 当系统提示输入 Git 操作的首选协议时,请选择 HTTPS
    • 当系统询问您是否要使用 GitHub Enterprise Server 凭据向 Git 进行身份验证时,请输入 Y

有关使用 GitHub CLI 进行身份验证的详细信息,请参阅 gh auth login

Git Credential Manager

Git Credential Manager (GCM) 是安全存储凭据并通过 HTTPS 连接到 GitHub 的另一种方法。 使用 GCM,您不必手动创建和存储 PAT,因为 GCM 代表您管理身份验证,包括 2FA(双重身份验证)。

  1. 使用 Homebrew 安装 Git:

    $ brew install git
  2. 使用 Homebrew 安装 GCM:

    $ brew tap microsoft/git
    $ brew install --cask git-credential-manager-core

    对于 MacOS,您不需要运行 git config,因为 GCM 会自动为您配置 Git。

下次克隆需要身份验证的 HTTPS URL 时,Git 将提示您使用浏览器窗口登录。 如果您的帐户或组织需要双重身份验证,则您还需要完成 2FA 质询。

验证成功后,您的凭据存储在 macOS 密钥链中,每次克隆 HTTPS URL 时都会使用。 Git 不会要求您在命令行中再次键入凭据,除非您更改凭据。

  1. 安装 Windows 版 Git,其中包括 GCM。 更多信息请参阅其版本页面中的“Windows 版 Git”。

我们建议始终安装最新版本。 至少安装版本 2.29 或更高版本,这是第一个为 GitHub 提供 OAuth 支持的版本。

下次克隆需要身份验证的 HTTPS URL 时,Git 将提示您使用浏览器窗口登录。 如果您的帐户或组织需要双重身份验证,则您还需要完成 2FA 质询。

成功通过身份验证后,您的凭据将存储在 Windows 凭据管理器中,并且每次克隆 HTTPS URL 时都将使用。 Git 不会要求您在命令行中再次键入凭据,除非您更改凭据。


警告: 旧版本的 Windows 版 Git 附有 Windows 版 Git Credential Manager。 此旧产品不再受支持,并且无法通过 OAuth 连接到 GitHub。 我们建议您升级到最新版本的 Windows 版 Git

警告:如果在 Windows 凭据管理器中缓存了不正确或过期的凭据,Git 将无法访问 GitHub Enterprise Server。 若要重置缓存的凭据,以便 Git 提示您输入凭据,请在 Windows 控制面板中的“用户帐户”>“凭据管理器”下访问凭据管理器。 找到 GitHub Enterprise Server 条目并将其删除。

对于 Linux,安装 Git 和 GCM,然后配置 Git 使用 GCM。

  1. 从发行版的打包系统安装 Git。 说明将根据您运行的 Linux 的风格而有所不同。

  2. 安装 GCM。 请参阅 GCM 存储库中的说明,因为它们会因您运行的 Linux 风格而异。

  3. 配置 Git 使用 GCM 有几个支持商店,您可以从中选择,因此请参阅 GCM 文档来完成设置。 更多信息请参阅“GCM Linux”。

下次克隆需要身份验证的 HTTPS URL 时,Git 将提示您使用浏览器窗口登录。 如果您的帐户或组织需要双重身份验证,则您还需要完成 2FA 质询。

验证成功后,您的凭据存储在系统中,每次克隆 HTTPS URL 时都会使用。 Git 不会要求您在命令行中再次键入凭据,除非您更改凭据。

有关在 Linux 上存储凭据的更多选项,请参阅 Pro Git 中的凭据存储


如需详细信息或报告 GCM 问题,请参阅 Git Credential Manager 上的官方 GCM 文档。