git-credential-store

Имя

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, если оно существует, или $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] для получения дополнительной информации.

© 2005–2026 Linus Torvalds and others
Licensed under the GNU General Public License version 2.
https://git-scm.com/docs/git-credential-store