Git Credential Manager
Git Credential Manager contributors · 免费 Git 凭据助手,支持安全令牌存储,并可通过 OAuth 和多重身份验证登录常用仓库托管服务。
介绍
Git Credential Manager(GCM)是一款免费、开源的 Git 凭据助手,供需要向远程仓库进行身份验证的开发者使用。Git 在需要凭据时会调用它;它不是通用密码库,也不是完整的 Git 桌面客户端。
功能 • 可向 GitHub、GitHub Enterprise、Azure DevOps/Repos、Bitbucket 和 GitLab 进行身份验证,包括支持的多重身份验证和 OAuth 登录流程。 • 在 Git 操作之间重复使用有效凭据或令牌;在 Mac 上默认将凭据存储于 macOS 钥匙串。 • 在支持的情况下使用浏览器或设备代码登录;在受支持且已配置的设备上,将 Microsoft 身份验证与操作系统代理集成。 • 处理网络代理,并提供诊断命令,用于排查身份验证和凭据存储设置问题。
安装和使用
使用 brew install --cask git-credential-manager 安装 Mac 软件包,或打开与设备架构相符的官方 .pkg 安装程序并按提示操作。安装程序可能需要管理员权限。使用此凭据助手需要安装 Git。安装并配置后,照常使用 Git 工作流,并通过 HTTP(S) 仓库 URL 操作;Git 会调用 GCM,且可能打开登录提示。之后的操作会重复使用有效的已存储令牌。GCM 不会取代 SSH 密钥身份验证;使用 SSH 远程地址时,请单独配置 SSH。添加重复的凭据助手前,请检查助手配置。官方指南提供了 git-credential-manager configure,供需要配置的安装使用;还提供 git-credential-manager diagnose 用于故障排查。
要求与兼容性 对于 GCM 3.x,上游支持 macOS 14 Sonoma 或更高版本。提供 Apple Silicon 软件包;对 Intel Mac 的支持尽力而为。当前 Homebrew 元数据未体现这一上游最低操作系统版本要求,因此其空依赖对象不得被解读为支持较旧的 macOS。独立平台软件包已包含所需内容,无需单独安装 .NET。另一种 .NET 工具安装方式需要 .NET 10 SDK。不支持 Git 1.x;上游指出 Git 2.26.2 不兼容,且修复已在 Git 2.27.0 中发布。所引用的文档未提供固定的内存或已安装磁盘空间要求。Mac cask 未列出明确的 cask 冲突或额外公式依赖;较旧的 Java GCM/助手配置可能需要迁移,而不是并行配置。
Microsoft 代理和其他平台
在支持的情况下,默认启用 Microsoft 代理身份验证。在 Mac 上使用此功能需要 Intune Company Portal 和设备注册。这是该登录方式的要求,并非基本安装 GCM 或进行 GitHub 身份验证的要求。组织策略可能会提示注册设备;在个人设备上登录前,请查阅官方代理指南。您可以使用 git config --global credential.msauthUseBroker false 选择退出,并改用合适的非代理流程。GCM 3.x 还支持 Windows 10+、Windows Server 2016+,以及 .NET 10 支持的 Linux 发行版。Linux 需要明确配置凭据存储,并安装所选发行版的运行时依赖;Homebrew 的 Linux 版本列出了 ICU。官方 Windows x86 发布二进制文件已从 3.0.1 起移除。此 Mac 软件包不会安装 Windows 或 Linux 版本。
账户、费用和许可证 GCM 本身采用 MIT 许可证,免费使用,也不需要单独订阅 GCM。身份验证需要仓库托管服务接受的账户或凭据;托管服务、组织访问权限和云服务各有自己的权限、条款及可能产生的费用。网络登录需要网络连接。对于 Azure Repos,GCM 3.x 默认使用可刷新的 OAuth 令牌,同时仍会遵循明确设置的 PAT。
官方来源 https://github.com/git-ecosystem/git-credential-manager https://github.com/git-ecosystem/git-credential-manager/blob/v3.0.1/docs/install.md https://github.com/git-ecosystem/git-credential-manager/blob/v3.0.1/docs/credstores.md https://github.com/git-ecosystem/git-credential-manager/blob/v3.0.1/docs/msauth-broker.md https://github.com/git-ecosystem/git-credential-manager/releases/tag/v3.0.1 https://github.com/git-ecosystem/git-credential-manager/blob/v3.0.1/LICENSE Cask 详情来自当前 Homebrew 元数据。图片是官方文档中的示例,账户仅用于演示;代理界面取决于平台和设置。下载大小是 Apple Silicon 3.0.1 .pkg 资源文件的大小,并非安装后的磁盘占用。
新版本 3.0.1 更新内容 10月7日 · OpenNavo 编辑 · AI 翻译
- 补丁支持 Git authtype 功能协商。
- 升级要求 macOS 14+、Windows 10+ 以及 .NET 10 支持的 Linux。