簡體中文 ▾ 主題 ▾ 最新版本 ▾ 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:pass@example.com

檔案中不允許有其他型別的行(例如空行或註釋行),即使其中一些可能會被靜默忽略。請不要使用編輯器檢視或編輯該檔案。

當 Git 需要對特定 URL 上下文進行身份驗證時,credential-store 會將該上下文視為一個模式,以匹配憑證檔案中的每個條目。如果協議、主機名和使用者名稱(如果我們已經有一個)匹配,則密碼將返回給 Git。有關更多資訊,請參閱 gitcredentials[7] 中關於配置的討論。

GIT

Git[1] 套件的一部分