Git Credential Manager 对接 GitLab从 gitlab.com 到自建实例的 OAuth 与令牌认证配置指南【免费下载链接】git-credential-managerSecure, cross-platform Git credential storage with authentication to GitHub, Azure Repos, and other popular Git hosting services.项目地址: https://gitcode.com/GitHub_Trending/gi/git-credential-manager本文以 Git Credential Manager下称 GCM的 GitLab 支持为主题完整讲解 GCM 如何开箱即用地对接gitlab.com以及针对gitlab.example.com这类自建实例从创建 OAuth 应用、写入 Git 配置到验证与清理的完整流程。读完本文你将掌握 GCM 在 GitLab 场景下的 OAuth 浏览器认证、Personal Access TokenPAT与用户名/密码认证的配置方法并能从源码层面理解其认证模式检测与令牌刷新机制。GitLab 支持总览gitlab.com 开箱即用GCM 对gitlab.com提供开箱即用的支持无需任何额外配置即可使用。其核心依据在于 GitLabHostProvider.cs当远程仓库的 URI 主机名与GitLabConstants.GitLabDotCom即https://gitlab.com一致时IsSupported直接返回true。同时 GCM 内置了一个由gitlab.com/gitcredentialmanager团队维护的公开 OAuth 客户端 ID见 GitLabConstants.cs因此浏览器 OAuth 认证在 gitlab.com 上无需用户自建应用即可工作。对于非 gitlab.com 的实例GCM 通过以下三种方式识别目标主机是否为 GitLab 实例GitLabHostProvider.cs主机名满足GitLab[.subdomain].domain.tld形式域名以gitlab.开头且至少有三段服务器返回的WWW-Authenticate头中包含realmGitLab服务器响应头中带有X-Gitlab-Feature-Category例如https://salsa.debian.org/apt-team/apt.git即通过此特征被识别见 GitLabHostProvider.cs。对应地GitLabHostProviderTests.cs 中的IsSupported测试用例验证了gitlab.com、gitlab.example.com均被识别而github.com、github.example.com不会被误判为 GitLab。在自建实例上使用创建 OAuth 应用并配置要让 GCM 在自建实例例如https://gitlab.example.com上工作需要先注册一个 OAuth 应用再通过 Git 配置把客户端凭据告知 GCM。以下步骤对应 docs/gitlab.md 的完整流程第一步创建 OAuth 应用在 GitLab 的“应用”管理页面创建一个 OAuth 应用。创建时需要注意应用可以注册在用户级、群组级或实例级级别越高适用面越广指定一个名称重定向 URI 必须填写http://127.0.0.1/——这是 GCM 本地回环接收授权码的标准地址见 GitLabConstants.cs 中的OAuthRedirectUri取消勾选 “Confidential”机密选项——GCM 在获取 token 时不使用 client secretGitLabOAuth2Client.cs 中GetClientSecret默认返回null勾选read_repository和write_repository两个 scope——这与 GitLabHostProvider.cs 中声明的GitLabOAuthScopes完全一致是 GCM 发起授权请求时实际携带的 scope。第二步配置客户端 ID 与 Secret将创建成功后得到的 Application ID 和 Secret 写入全局 Git 配置。注意配置键是credential.url.gitLabDevClientId与credential.url.gitLabDevClientSecret其中url是 GitLab 实例的 URL 前缀git config --global credential.https://gitlab.example.com.gitLabDevClientId APPLICATION_ID git config --global credential.https://gitlab.example.com.gitLabDevClientSecret APPLICATION_SECRET第三步可选强制浏览器认证如果希望跳过认证模式选择菜单、直接使用浏览器 OAuth 认证可以显式指定认证模式git config --global credential.https://gitlab.example.com.gitLabAuthModes browser第四步显式指定 provider为了让 GCM 可靠地将该域名识别为 GitLab 实例建议显式声明 providergit config --global credential.https://gitlab.example.com.provider gitlab在部分场景下例如主机名不符合gitlab.xxx约定、服务器未返回可识别的响应头这一步是必需的。第五步验证配置使用--get-urlmatch检查 Git 实际为https://gitlab.example.com生效的配置git config --global --get-urlmatch credential https://gitlab.example.com该命令会输出所有匹配该 URL 的credential.*配置项用于确认上述键值均已正确写入。清理配置当不再需要这些配置时逐项取消即可git config --global --unset-all credential.https://gitlab.example.com.gitLabDevClientId git config --global --unset-all credential.https://gitlab.example.com.gitLabDevClientSecret git config --global --unset-all credential.https://gitlab.example.com.provider注意--unset-all会删除该键的全部取值包括多个 scope 下的同名键因此只会影响gitlab.example.com这一个 host 的配置。热门实例的现成配置以下配置由社区成员 hickford 提供docs/gitlab.md可直接复制使用。它们对应各大开源社区的 GitLab 实例均已注册好公开的 OAuth 应用ID 与 Secret 可直接写入# https://gitlab.freedesktop.org/ git config --global credential.https://gitlab.freedesktop.org.gitLabDevClientId 6503d8c5a27187628440d44e0352833a2b49bce540c546c22a3378c8f5b74d45 git config --global credential.https://gitlab.freedesktop.org.gitLabDevClientSecret 2ae9343a034ff1baadaef1e7ce3197776b00746a02ddf0323bb34aca8bff6dc1 # https://gitlab.gnome.org/ git config --global credential.https://gitlab.gnome.org.gitLabDevClientId adf21361d32eddc87bf6baf8366f242dfe07a7d4335b46e8e101303364ccc470 git config --global credential.https://gitlab.gnome.org.gitLabDevClientSecret cdca4678f64e5b0be9febc0d5e7aab0d81d27696d7adb1cf8022ccefd0a58fc0 # https://invent.kde.org/ git config --global credential.https://invent.kde.org.gitLabDevClientId cd7cb4342c7cd83d8c2fcc22c87320f88d0bde14984432ffca07ee24d0bf0699 git config --global credential.https://invent.kde.org.gitLabDevClientSecret 9cc8440b280c792ac429b3615ae1c8e0702e6b2479056f899d314f05afd94211 # https://salsa.debian.org/ git config --global credential.https://salsa.debian.org.gitLabDevClientId 213f5fd32c6a14a0328048c0a77cc12c19138cc165ab957fb83d0add74656f89 git config --global credential.https://salsa.debian.org.gitLabDevClientSecret 3616b974b59451ecf553f951cb7b8e6e3c91c6d84dd3247dcb0183dac93c2a26 # https://gitlab.haskell.org/ git config --global credential.https://gitlab.haskell.org.gitLabDevClientId 57de5eaab72b3dc447fca8c19cea39527a08e82da5377c2d10a8ebb30b08fa5f git config --global credential.https://gitlab.haskell.org.gitLabDevClientSecret 5170a480da8fb7341e0daac94223d4fff549c702efb2f8873d950bb2b88e434f # https://code.videolan.org/ git config --global credential.https://code.videolan.org.gitLabDevClientId f35c379241cc20bf9dffecb47990491b62757db4fb96080cddf2461eacb40375 git config --global credential.https://code.videolan.org.gitLabDevClientSecret 631558ec973c5ef65b78db9f41103f8247dc68d979c86f051c0fe4389e1995e8配置完成后首次执行git clone/git push时 GCM 会自动拉起浏览器完成 GitLab 授权。认证模式选择终端菜单与偏好配置GCM 对 GitLab 提供三种认证模式定义在 GitLabAuthentication.cs 的AuthenticationModes枚举中模式说明Basic用户名/密码认证BrowserOAuth 浏览器认证需要图形会话用于拉起默认浏览器PatPersonal Access TokenPAT认证当多种模式同时可用且未强制指定时GCM 会在终端弹出交互菜单其默认输出形式如下docs/gitlab.mdSelect an authentication method for https://gitlab.com/: 1. Web browser (default) 2. Personal access token 3. Username/password option (enter for default):直接回车默认选择第一项Web browser输入对应序号可选择其他模式。该菜单的构建逻辑位于 GitLabAuthentication.cs菜单项按browser → pat → basic顺序添加默认选中第一项。通过 gitLabAuthModes 固定认证模式如果希望跳过菜单直接使用某一种认证模式可设置credential.gitLabAuthModesgit config --global credential.gitLabAuthModes browser该键支持以逗号分隔多个值如browser,basic。完整的取值说明见 docs/configuration.md值认证模式未设置自动检测browser浏览器 OAuth 认证需要 GUIbasic用户名/密码认证patPersonal Access Token 认证对应的环境变量形式为GCM_GITLAB_AUTHMODESdocs/environment.md# macOS/Linux export GCM_GITLAB_AUTHMODESbrowser:: Windows SET GCM_GITLAB_AUTHMODESbrowser注意由于 GitLab 目前不支持 OAuth device authorization见下文“注意事项”GitLab 场景下没有device模式可选这一点与 GitHub 的oauth/device模式不同。认证模式的自动检测逻辑从源码看GCM 对“哪些认证模式可用”有一套自动检测逻辑GitLabHostProvider.csgitlab.com直接返回AuthenticationModes.All三种模式全部可用见 GitLabConstants.cs自建实例默认假设 PAT 一定可用modes AuthenticationModes.Pat如果检测到已配置非 gitlab.com 内置的 OAuth 客户端 IDgitLabDevClientId则追加Browser模式否则会向终端输出 “warning: missing OAuth configuration for …” 提示用户名/密码Basic被默认假定可用。这一行为同样有对应测试覆盖GitLabHostProviderTests.cs。此外在进入认证流程前GitLabAuthentication.GetAuthenticationAsync 还会做两项预处理若当前会话无法启动浏览器则移除Browser模式若系统禁用交互GCM_INTERACTIVEnever则直接抛出异常拒绝提示。GUI 提示开启且处于桌面会话时优先走 Avalonia UI 或自定义 helper否则回退到终端 TTY 交互。认证流程与令牌刷新机制源码级原理理解 GCM 在 GitLab 上的完整凭据生命周期有助于排查认证问题。整个流程由 GitLabHostProvider.cs 的GetCredentialAsync驱动优先读取已存凭据按服务名从系统凭据存储中读取若凭据的用户名是oauth2则调用 GitLab 的/oauth/token/info接口校验 access token 是否过期收到401 Unauthorized即视为过期见 GitLabHostProvider.cs过期则删除尝试刷新若无有效 access token从单独的 refresh token 服务主机名形如oauth-refresh-token.host读取刷新令牌调用/oauth/token换取新 tokenGitLabHostProvider.cs兜底生成刷新失败或无刷新令牌时调用GenerateCredentialAsync进入交互式认证——浏览器模式走完整 OAuth 授权码流程PAT/Basic 模式则直接使用用户输入预存令牌OAuth 模式下GCM 会在返回凭据前将 access token 与 refresh token 分别写入两个独立的凭据条目GitLabHostProvider.cs从而让后续 push 无需重新交互。值得注意的实现细节OAuth 生成的凭据用户名固定为oauth2GitLabHostProvider.cs因为 GitLab 的 HTTPS 访问规则要求以oauth2作为用户名、access token 作为密码来认证。浏览器认证与刷新均通过 GitLabOAuth2Client.cs 完成其中授权端点为/oauth/authorize、令牌端点为/oauth/tokenGitLabConstants.cs。开发调试用的环境变量GCM 为 GitLab 模块提供了一套带GCM_DEV_前缀的开发环境变量优先级高于 Git 配置GitLabOAuth2Client.cs、GitLabConstants.cs环境变量对应 Git 配置键说明GCM_DEV_GITLAB_CLIENTIDgitLabDevClientIdOAuth 应用客户端 IDGCM_DEV_GITLAB_CLIENTSECRETgitLabDevClientSecretOAuth 应用客户端 Secret可选GCM_DEV_GITLAB_REDIRECTURIgitLabDevRedirectUri授权码回调 URI默认http://127.0.0.1/GCM_GITLAB_AUTHMODESgitLabAuthModes认证模式白名单GCM_GITLAB_HELPERgitLabHelper自定义认证 helper 命令由于gitLabDevClientId/gitLabDevClientSecret等键名为开发用途命名在自建实例场景中也被复用为正式配置入口。注意事项受限于 GitLab 服务的已知问题GCM 对 GitLab 的“加强版”支持依赖 GitLab 官方服务的功能演进存在以下已知限制docs/gitlab.md不支持 OAuth device authorization在没有浏览器的机器如无头服务器、CI 环境上无法使用设备码流程完成 OAuth 认证此时应改用 PAT 认证无法将 GCM 预配置为实例级 OAuth 应用管理员无法通过服务端设置一步到位地为整个实例的用户开通 GCM 认证仍需各用户自行配置用户名/密码选项在服务器端禁用时仍会被提供由于查询password_authentication_enabled_for_git需要登录态参见 GitLabHostProvider.cs 的注释GCM 无法获知服务器是否已禁用密码登录因此仍会向用户展示该选项。上述限制均源自 GitLab 服务端的开放 issue需要 GitLab 侧演进才能解决GCM 侧无法单独规避。总结GCM 的 GitLab 支持分为两条路径gitlab.com无需配置开箱即用自建实例则需要注册 OAuth 应用并写入gitLabDevClientId/gitLabDevClientSecret配置。通过gitLabAuthModes或GCM_GITLAB_AUTHMODES可以固定浏览器 OAuth、PAT 或用户名/密码三种认证模式OAuth 令牌会在后台自动校验并刷新刷新令牌与访问令牌分开存储于系统凭据库。配合本文给出的热门实例现成配置你可以快速在各类 GitLab 托管平台上启用安全、免密交互的 Git 凭据管理。【免费下载链接】git-credential-managerSecure, cross-platform Git credential storage with authentication to GitHub, Azure Repos, and other popular Git hosting services.项目地址: https://gitcode.com/GitHub_Trending/gi/git-credential-manager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Git Credential Manager 对接 GitLab：从 gitlab.com 到自建实例的 OAuth 与令牌认证配置指南
Git Credential Manager 对接 GitLab从 gitlab.com 到自建实例的 OAuth 与令牌认证配置指南【免费下载链接】git-credential-managerSecure, cross-platform Git credential storage with authentication to GitHub, Azure Repos, and other popular Git hosting services.项目地址: https://gitcode.com/GitHub_Trending/gi/git-credential-manager本文以 Git Credential Manager下称 GCM的 GitLab 支持为主题完整讲解 GCM 如何开箱即用地对接gitlab.com以及针对gitlab.example.com这类自建实例从创建 OAuth 应用、写入 Git 配置到验证与清理的完整流程。读完本文你将掌握 GCM 在 GitLab 场景下的 OAuth 浏览器认证、Personal Access TokenPAT与用户名/密码认证的配置方法并能从源码层面理解其认证模式检测与令牌刷新机制。GitLab 支持总览gitlab.com 开箱即用GCM 对gitlab.com提供开箱即用的支持无需任何额外配置即可使用。其核心依据在于 GitLabHostProvider.cs当远程仓库的 URI 主机名与GitLabConstants.GitLabDotCom即https://gitlab.com一致时IsSupported直接返回true。同时 GCM 内置了一个由gitlab.com/gitcredentialmanager团队维护的公开 OAuth 客户端 ID见 GitLabConstants.cs因此浏览器 OAuth 认证在 gitlab.com 上无需用户自建应用即可工作。对于非 gitlab.com 的实例GCM 通过以下三种方式识别目标主机是否为 GitLab 实例GitLabHostProvider.cs主机名满足GitLab[.subdomain].domain.tld形式域名以gitlab.开头且至少有三段服务器返回的WWW-Authenticate头中包含realmGitLab服务器响应头中带有X-Gitlab-Feature-Category例如https://salsa.debian.org/apt-team/apt.git即通过此特征被识别见 GitLabHostProvider.cs。对应地GitLabHostProviderTests.cs 中的IsSupported测试用例验证了gitlab.com、gitlab.example.com均被识别而github.com、github.example.com不会被误判为 GitLab。在自建实例上使用创建 OAuth 应用并配置要让 GCM 在自建实例例如https://gitlab.example.com上工作需要先注册一个 OAuth 应用再通过 Git 配置把客户端凭据告知 GCM。以下步骤对应 docs/gitlab.md 的完整流程第一步创建 OAuth 应用在 GitLab 的“应用”管理页面创建一个 OAuth 应用。创建时需要注意应用可以注册在用户级、群组级或实例级级别越高适用面越广指定一个名称重定向 URI 必须填写http://127.0.0.1/——这是 GCM 本地回环接收授权码的标准地址见 GitLabConstants.cs 中的OAuthRedirectUri取消勾选 “Confidential”机密选项——GCM 在获取 token 时不使用 client secretGitLabOAuth2Client.cs 中GetClientSecret默认返回null勾选read_repository和write_repository两个 scope——这与 GitLabHostProvider.cs 中声明的GitLabOAuthScopes完全一致是 GCM 发起授权请求时实际携带的 scope。第二步配置客户端 ID 与 Secret将创建成功后得到的 Application ID 和 Secret 写入全局 Git 配置。注意配置键是credential.url.gitLabDevClientId与credential.url.gitLabDevClientSecret其中url是 GitLab 实例的 URL 前缀git config --global credential.https://gitlab.example.com.gitLabDevClientId APPLICATION_ID git config --global credential.https://gitlab.example.com.gitLabDevClientSecret APPLICATION_SECRET第三步可选强制浏览器认证如果希望跳过认证模式选择菜单、直接使用浏览器 OAuth 认证可以显式指定认证模式git config --global credential.https://gitlab.example.com.gitLabAuthModes browser第四步显式指定 provider为了让 GCM 可靠地将该域名识别为 GitLab 实例建议显式声明 providergit config --global credential.https://gitlab.example.com.provider gitlab在部分场景下例如主机名不符合gitlab.xxx约定、服务器未返回可识别的响应头这一步是必需的。第五步验证配置使用--get-urlmatch检查 Git 实际为https://gitlab.example.com生效的配置git config --global --get-urlmatch credential https://gitlab.example.com该命令会输出所有匹配该 URL 的credential.*配置项用于确认上述键值均已正确写入。清理配置当不再需要这些配置时逐项取消即可git config --global --unset-all credential.https://gitlab.example.com.gitLabDevClientId git config --global --unset-all credential.https://gitlab.example.com.gitLabDevClientSecret git config --global --unset-all credential.https://gitlab.example.com.provider注意--unset-all会删除该键的全部取值包括多个 scope 下的同名键因此只会影响gitlab.example.com这一个 host 的配置。热门实例的现成配置以下配置由社区成员 hickford 提供docs/gitlab.md可直接复制使用。它们对应各大开源社区的 GitLab 实例均已注册好公开的 OAuth 应用ID 与 Secret 可直接写入# https://gitlab.freedesktop.org/ git config --global credential.https://gitlab.freedesktop.org.gitLabDevClientId 6503d8c5a27187628440d44e0352833a2b49bce540c546c22a3378c8f5b74d45 git config --global credential.https://gitlab.freedesktop.org.gitLabDevClientSecret 2ae9343a034ff1baadaef1e7ce3197776b00746a02ddf0323bb34aca8bff6dc1 # https://gitlab.gnome.org/ git config --global credential.https://gitlab.gnome.org.gitLabDevClientId adf21361d32eddc87bf6baf8366f242dfe07a7d4335b46e8e101303364ccc470 git config --global credential.https://gitlab.gnome.org.gitLabDevClientSecret cdca4678f64e5b0be9febc0d5e7aab0d81d27696d7adb1cf8022ccefd0a58fc0 # https://invent.kde.org/ git config --global credential.https://invent.kde.org.gitLabDevClientId cd7cb4342c7cd83d8c2fcc22c87320f88d0bde14984432ffca07ee24d0bf0699 git config --global credential.https://invent.kde.org.gitLabDevClientSecret 9cc8440b280c792ac429b3615ae1c8e0702e6b2479056f899d314f05afd94211 # https://salsa.debian.org/ git config --global credential.https://salsa.debian.org.gitLabDevClientId 213f5fd32c6a14a0328048c0a77cc12c19138cc165ab957fb83d0add74656f89 git config --global credential.https://salsa.debian.org.gitLabDevClientSecret 3616b974b59451ecf553f951cb7b8e6e3c91c6d84dd3247dcb0183dac93c2a26 # https://gitlab.haskell.org/ git config --global credential.https://gitlab.haskell.org.gitLabDevClientId 57de5eaab72b3dc447fca8c19cea39527a08e82da5377c2d10a8ebb30b08fa5f git config --global credential.https://gitlab.haskell.org.gitLabDevClientSecret 5170a480da8fb7341e0daac94223d4fff549c702efb2f8873d950bb2b88e434f # https://code.videolan.org/ git config --global credential.https://code.videolan.org.gitLabDevClientId f35c379241cc20bf9dffecb47990491b62757db4fb96080cddf2461eacb40375 git config --global credential.https://code.videolan.org.gitLabDevClientSecret 631558ec973c5ef65b78db9f41103f8247dc68d979c86f051c0fe4389e1995e8配置完成后首次执行git clone/git push时 GCM 会自动拉起浏览器完成 GitLab 授权。认证模式选择终端菜单与偏好配置GCM 对 GitLab 提供三种认证模式定义在 GitLabAuthentication.cs 的AuthenticationModes枚举中模式说明Basic用户名/密码认证BrowserOAuth 浏览器认证需要图形会话用于拉起默认浏览器PatPersonal Access TokenPAT认证当多种模式同时可用且未强制指定时GCM 会在终端弹出交互菜单其默认输出形式如下docs/gitlab.mdSelect an authentication method for https://gitlab.com/: 1. Web browser (default) 2. Personal access token 3. Username/password option (enter for default):直接回车默认选择第一项Web browser输入对应序号可选择其他模式。该菜单的构建逻辑位于 GitLabAuthentication.cs菜单项按browser → pat → basic顺序添加默认选中第一项。通过 gitLabAuthModes 固定认证模式如果希望跳过菜单直接使用某一种认证模式可设置credential.gitLabAuthModesgit config --global credential.gitLabAuthModes browser该键支持以逗号分隔多个值如browser,basic。完整的取值说明见 docs/configuration.md值认证模式未设置自动检测browser浏览器 OAuth 认证需要 GUIbasic用户名/密码认证patPersonal Access Token 认证对应的环境变量形式为GCM_GITLAB_AUTHMODESdocs/environment.md# macOS/Linux export GCM_GITLAB_AUTHMODESbrowser:: Windows SET GCM_GITLAB_AUTHMODESbrowser注意由于 GitLab 目前不支持 OAuth device authorization见下文“注意事项”GitLab 场景下没有device模式可选这一点与 GitHub 的oauth/device模式不同。认证模式的自动检测逻辑从源码看GCM 对“哪些认证模式可用”有一套自动检测逻辑GitLabHostProvider.csgitlab.com直接返回AuthenticationModes.All三种模式全部可用见 GitLabConstants.cs自建实例默认假设 PAT 一定可用modes AuthenticationModes.Pat如果检测到已配置非 gitlab.com 内置的 OAuth 客户端 IDgitLabDevClientId则追加Browser模式否则会向终端输出 “warning: missing OAuth configuration for …” 提示用户名/密码Basic被默认假定可用。这一行为同样有对应测试覆盖GitLabHostProviderTests.cs。此外在进入认证流程前GitLabAuthentication.GetAuthenticationAsync 还会做两项预处理若当前会话无法启动浏览器则移除Browser模式若系统禁用交互GCM_INTERACTIVEnever则直接抛出异常拒绝提示。GUI 提示开启且处于桌面会话时优先走 Avalonia UI 或自定义 helper否则回退到终端 TTY 交互。认证流程与令牌刷新机制源码级原理理解 GCM 在 GitLab 上的完整凭据生命周期有助于排查认证问题。整个流程由 GitLabHostProvider.cs 的GetCredentialAsync驱动优先读取已存凭据按服务名从系统凭据存储中读取若凭据的用户名是oauth2则调用 GitLab 的/oauth/token/info接口校验 access token 是否过期收到401 Unauthorized即视为过期见 GitLabHostProvider.cs过期则删除尝试刷新若无有效 access token从单独的 refresh token 服务主机名形如oauth-refresh-token.host读取刷新令牌调用/oauth/token换取新 tokenGitLabHostProvider.cs兜底生成刷新失败或无刷新令牌时调用GenerateCredentialAsync进入交互式认证——浏览器模式走完整 OAuth 授权码流程PAT/Basic 模式则直接使用用户输入预存令牌OAuth 模式下GCM 会在返回凭据前将 access token 与 refresh token 分别写入两个独立的凭据条目GitLabHostProvider.cs从而让后续 push 无需重新交互。值得注意的实现细节OAuth 生成的凭据用户名固定为oauth2GitLabHostProvider.cs因为 GitLab 的 HTTPS 访问规则要求以oauth2作为用户名、access token 作为密码来认证。浏览器认证与刷新均通过 GitLabOAuth2Client.cs 完成其中授权端点为/oauth/authorize、令牌端点为/oauth/tokenGitLabConstants.cs。开发调试用的环境变量GCM 为 GitLab 模块提供了一套带GCM_DEV_前缀的开发环境变量优先级高于 Git 配置GitLabOAuth2Client.cs、GitLabConstants.cs环境变量对应 Git 配置键说明GCM_DEV_GITLAB_CLIENTIDgitLabDevClientIdOAuth 应用客户端 IDGCM_DEV_GITLAB_CLIENTSECRETgitLabDevClientSecretOAuth 应用客户端 Secret可选GCM_DEV_GITLAB_REDIRECTURIgitLabDevRedirectUri授权码回调 URI默认http://127.0.0.1/GCM_GITLAB_AUTHMODESgitLabAuthModes认证模式白名单GCM_GITLAB_HELPERgitLabHelper自定义认证 helper 命令由于gitLabDevClientId/gitLabDevClientSecret等键名为开发用途命名在自建实例场景中也被复用为正式配置入口。注意事项受限于 GitLab 服务的已知问题GCM 对 GitLab 的“加强版”支持依赖 GitLab 官方服务的功能演进存在以下已知限制docs/gitlab.md不支持 OAuth device authorization在没有浏览器的机器如无头服务器、CI 环境上无法使用设备码流程完成 OAuth 认证此时应改用 PAT 认证无法将 GCM 预配置为实例级 OAuth 应用管理员无法通过服务端设置一步到位地为整个实例的用户开通 GCM 认证仍需各用户自行配置用户名/密码选项在服务器端禁用时仍会被提供由于查询password_authentication_enabled_for_git需要登录态参见 GitLabHostProvider.cs 的注释GCM 无法获知服务器是否已禁用密码登录因此仍会向用户展示该选项。上述限制均源自 GitLab 服务端的开放 issue需要 GitLab 侧演进才能解决GCM 侧无法单独规避。总结GCM 的 GitLab 支持分为两条路径gitlab.com无需配置开箱即用自建实例则需要注册 OAuth 应用并写入gitLabDevClientId/gitLabDevClientSecret配置。通过gitLabAuthModes或GCM_GITLAB_AUTHMODES可以固定浏览器 OAuth、PAT 或用户名/密码三种认证模式OAuth 令牌会在后台自动校验并刷新刷新令牌与访问令牌分开存储于系统凭据库。配合本文给出的热门实例现成配置你可以快速在各类 GitLab 托管平台上启用安全、免密交互的 Git 凭据管理。【免费下载链接】git-credential-managerSecure, cross-platform Git credential storage with authentication to GitHub, Azure Repos, and other popular Git hosting services.项目地址: https://gitcode.com/GitHub_Trending/gi/git-credential-manager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考