English ▾ 主题 ▾ 最新版本 ▾ git-credential-store 上次更新于 2.43.0

名称

git-credential-store - 助手，用于将凭据存储在磁盘上

概要

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

描述

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

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

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

选项

--file=<path>

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

文件

如果未使用 --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:pass@example.com

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

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

GIT

属于 git[1] 套件的一部分

scroll-to-top