在 Ubuntu 上使用 Git Credential Manager（GCM）实现认证

1.1 下载最新的 .deb 包#

访问 GCM 的 Releases 页面，找到最新版本的 .deb 包。通常文件名为 gcm-linux-x64-{version}.deb。

1.2 安装 .deb 包#

记得更换为实际的路径。

1
sudo apt install ./path/to/gcm-linux-x64-{version}.deb

2.1 配置 credential.helper#

将 GCM 设置为 Git 的凭证助手：

1
git config --global credential.helper manager

2.2 配置 credential.credentialStore 为 secretservice#

GCM 在 Linux 上支持多种凭证存储方式，包括 secretservice（基于 freedesktop.org Secret Service API）、gpg（基于 GPG 加密）以及 cache（内存缓存）等。其中 secretservice 使用 libsecret 库通过 D-Bus 与 GNOME Keyring 或 KDE Wallet 等桌面凭证管理器交互，在 Ubuntu 上由 Seahorse（GNOME Keyring）提供支持。

执行以下命令将凭证存储设置为 secretservice：

1
git config --global credential.credentialStore secretservice

也可以通过环境变量方式配置：export GCM_CREDENTIAL_STORE=secretservice。

2.3 确保依赖已安装#

secretservice 存储方式需要 libsecret 库的支持。在 Ubuntu 上通常已经预装，如果没有，可以手动安装：

1
sudo apt update
2
sudo apt install libsecret-1-0 libsecret-1-dev

2.4 重启系统#

配置完成后，建议重启系统以确保所有更改生效。如果不重启，可能会遇到一些奇怪的错误。

1
sudo reboot

3.1 首次认证流程#

当你首次执行需要认证的 Git 操作（如 git clone 访问私有仓库、git push 等）时，GCM 会自动启动系统的默认浏览器，打开托管平台（如 GitHub）的授权页面。

例如，执行：

1
git clone https://github.com/your-username/private-repo.git

GCM 会弹出一个窗口，提示你使用浏览器登录。在浏览器中完成登录和授权后，凭证会被安全地存储在 GNOME Keyring 中，后续操作将自动使用已存储的凭证，无需再次输入。

3.2 查看已存储的凭证#

Ubuntu 用户可以通过 Seahorse（“密码与密钥”应用）查看 GCM 存储的凭证：

1. 打开 Seahorse 应用（在应用菜单中搜索“密码与密钥”或 seahorse）
2. 在左侧面板中找到“Login”密钥环
3. 查找类似 git:https://github.com/ 的条目

3.3 更新或删除凭证#

如果需要更新凭证（例如更换了 GitHub 密码或 Personal Access Token），可以通过 Seahorse 删除旧凭证，然后在下一次 Git 操作时重新通过浏览器认证即可：

1. 打开 Seahorse
2. 在“登录”密钥环中找到对应的 Git 凭证条目
3. 右键删除
4. 下次执行 git push 或 git clone 时，GCM 会再次打开浏览器进行认证