简体中文 ▾ 主题 ▾ 最新版本 ▾ git-credential-store 上次更新于 2.43.0

名称

git-credential-store - 在磁盘上存储凭据的辅助工具

概要

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

描述

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

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

您可能不希望直接调用此命令；它旨在作为 Git 其他部分的凭据辅助工具使用。请参阅 gitcredentials[7] 或下方的 示例。

选项

--file=<路径>

使用 <路径> 来查找和存储凭据。该文件的文件系统权限将被设置为阻止系统上的其他用户读取，但它不会被加密或以其他方式保护。如果未指定，凭据将从 ~/.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:pass@example.com

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

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

GIT

Git[1] 套件的一部分

scroll-to-top