Git
英语 ▾ 主题 ▾ 最新版本 ▾ git-credential-store 最后更新于 2.43.0

名称

git-credential-store - 在磁盘上存储凭据的助手

概要

git config credential.helper 'store [<options>]'

描述

注意
 使用此助手将在磁盘上存储您的密码，不加密，仅受文件系统权限保护。如果这不是可以接受的安全权衡，请尝试 git-credential-cache[1]，或找到一个与您的操作系统提供的安全存储集成的助手。

此命令将凭据无限期地存储在磁盘上，以便将来 Git 程序使用。

您可能不想直接调用此命令；它旨在作为其他 git 部分的凭据助手使用。请参阅 gitcredentials[7] 或下面的 示例。

选项

--file=<path>

使用 <path> 来查找和存储凭据。该文件的文件系统权限将被设置为阻止系统上的其他用户读取它，但它不会被加密或以其他方式保护。如果未指定，则将从 ~/.git-credentials 和 $XDG_CONFIG_HOME/git/credentials 中查找凭据，并将凭据写入 ~/.git-credentials（如果存在），或者写入 $XDG_CONFIG_HOME/git/credentials（如果存在且前者不存在）。另请参见 文件。

文件

如果未通过 --file 显式设置，则有两个文件，git-credential-store 将按优先级顺序在其中搜索凭据

~/.git-credentials

用户特定的凭据文件。

$XDG_CONFIG_HOME/git/credentials

第二个用户特定的凭据文件。如果 $XDG_CONFIG_HOME 未设置或为空，则将使用 $HOME/.config/git/credentials。如果 ~/.git-credentials 也包含匹配的凭据，则不会使用此文件中存储的任何凭据。如果您有时使用不支持它的旧版 Git，最好不要创建此文件。

对于凭据查找，将按上述顺序读取文件，找到的第一个匹配凭据优先于在列表中更靠后的文件中找到的凭据。

凭据存储默认情况下将写入列表中的第一个现有文件。如果这些文件都不存在，将创建并写入 ~/.git-credentials。

擦除凭据时，将从所有文件中擦除匹配的凭据。

示例

此助手的目的是减少您必须输入用户名或密码的次数。例如

$ git config credential.helper store
$ git push http://example.com/repo.git
Username: <type your username>
Password: <type your password>

[several days later]
$ git push http://example.com/repo.git
[your credentials are used automatically]

存储格式

.git-credentials 文件以纯文本格式存储。每个凭据都存储在它自己的一行上，作为类似 URL 的内容

https://user:[email protected]

文件中不允许使用其他类型的行（例如空行或注释行），即使某些行可能会被静默忽略。请勿使用编辑器查看或编辑该文件。

当 Git 需要针对特定 URL 上下文进行身份验证时，credential-store 将把该上下文视为与凭据文件中的每个条目匹配的模式。如果协议、主机名和用户名（如果我们已经有一个）匹配，则密码将返回给 Git。有关更多信息，请参阅 gitcredentials[7] 中关于配置的讨论。

GIT

git[1] 套件的一部分

scroll-to-top