簡體中文 ▾ 主題 ▾ 最新版本 ▾ 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