Git
English ▾ 主題 ▾ 最新版本 ▾ 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 環境的驗證時，credential-store 會將該環境視為一個模式，與憑證檔案中的每個條目進行比對。如果協定、主機名稱和使用者名稱（如果我們已經有一個）相符，則會將密碼傳回給 Git。有關更多資訊，請參閱 gitcredentials[7] 中有關設定的討論。

GIT

屬於 git[1] 套件的一部分

scroll-to-top