Ubuntu 下最推荐的 Git 凭据存储方式：使用 libsecret 对接系统密钥环

在 Ubuntu 上进行 Git 操作时，频繁输入用户名和密码无疑会打断工作流，影响效率。更不推荐将密码明文保存在 .git-credentials 文件中。

本文将介绍一种安全且持久的方案：通过 libsecret 将 Git 凭据存储在系统的 GNOME Keyring 中。相比 cache 模式，它不会过期；相比 store 模式，它加密存储，更加安全。

配置过程不复杂，核心在于需要手动编译一个凭据助手（Ubuntu 默认未提供二进制文件）。下面一步步带你完成。

第一步：安装依赖并编译凭据助手

首先，在终端中安装必要的开发库，然后直接使用 make 编译 Git 源码中自带的 libsecret 模块。

# 1. 安装 libsecret 开发库
sudo apt install libsecret-1-0 libsecret-1-dev

# 2. 编译凭据助手
sudo make --directory=/usr/share/doc/git/contrib/credential/libsecret

执行完 sudo make 后，git-credential-libsecret 程序就会生成在 /usr/share/doc/git/contrib/credential/libsecret/ 目录下。

第二步：配置 Git 使用该凭据助手

编译完成后，通过 git config 将 Git 的凭据助手指向刚刚生成的程序。建议使用 --global 参数，使配置对当前用户的所有仓库生效。

1 2	git config --global credential.helper \ /usr/share/doc/git/contrib/credential/libsecret/git-credential-libsecret

该命令会将配置写入 ~/.gitconfig 文件。你也可以手动编辑该文件，效果相同。

第三步：触发存储并验证

配置好后，在任意一个 Git 仓库中执行一次需要认证的操作，比如 git pull 或 git push。

此时系统会弹出 GNOME 密钥环的对话框，提示你输入密码（或令牌）。这一步是正常的，也是将凭据写入系统密钥环的关键动作。

成功输入并验证后，你的凭据（用户名+密码或 Token）就会被 libsecret 安全地存储起来。之后再进行 git push、git pull 等操作，就无需再重复输入了。

进阶技巧：同一域名下使用多个账号

libsecret 默认以远程地址的域名（如 github.com）为键值存储凭据。如果你需要针对同一个域名使用不同账号（例如个人与工作账号），默认配置下凭据会相互覆盖。

解决方案是在仓库的远程地址中嵌入用户名，帮助 Git 区分不同的凭据条目：

# 仓库1 - 使用账号 A
git remote set-url origin https://用户名A@github.com/用户名A/仓库名.git

# 仓库2 - 使用账号 B
git remote set-url origin https://用户名B@github.com/用户名B/仓库名.git

修改远程地址后，libsecret 便会根据 用户名A 和 用户名B 区分并存储各自的凭据，互不干扰。

总结

方案	安全性	持久性	推荐度
`store` 明文存储	❌ 低	✅ 永久	❌ 不推荐
`cache` 临时缓存	✅ 中	❌ 有过期时间	⚠️ 临时可用
`libsecret` + 密钥环	✅ 高（加密）	✅ 永久	✅ 强烈推荐