'\" t
.\"     Title: git-credential-store
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-29
.\"    Manual: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-CREDENTIAL\-STORE" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
git-credential-store \- ابزار کمکی برای ذخیره اطلاعات هویتی روی دیسک
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
git config credential\&.helper \*(Aqstore [<options>]\*(Aq
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.sp
استفاده از این ابزار کمکی، گذرواژه‌های شما را به صورت رمزگذاری‌نشده و فقط با محافظت مجوزهای سیستم فایل روی دیسک ذخیره می‌کند\&. اگر این یک مصالحه امنیتی قابل قبول برای شما نیست، \fBgit-credential-cache\fR(1) را امتحان کنید، یا ابزار کمکی دیگری بیابید که با فضای ذخیره‌سازی امن ارائه‌شده توسط سیستم‌عامل شما یکپارچه شود\&.
.sp .5v
.RE
.sp
این دستور، اطلاعات هویتی را برای استفاده در آینده توسط برنامه‌های گیت، به صورت نامحدود روی دیسک ذخیره می‌کند\&.
.sp
احتمالاً نمی‌خواهید این دستور را مستقیماً اجرا کنید؛ این دستور برای استفاده به عنوان یک ابزار کمکی اطلاعات هویتی توسط سایر بخش‌های گیت در نظر گرفته شده است\&. به \fBgitcredentials\fR(7) یا بخش \fBمثال‌ها (EXAMPLES)\fR در ادامه مراجعه کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-\-file=<path>
.RS 4
از
\fI<path>\fR
برای جستجو و ذخیره اطلاعات هویتی استفاده می‌کند\&. مجوزهای سیستم فایل این پرونده طوری تنظیم می‌شود که از خواندن آن توسط سایر کاربران سیستم جلوگیری شود، اما رمزگذاری نخواهد شد و به شکل دیگری محافظت نمی‌شود\&. در صورت عدم تعیین، اطلاعات هویتی در
\fB~/\&.git\-credentials\fR
و
\fB$XDG_CONFIG_HOME/git/credentials\fR
جستجو می‌شوند، و اطلاعات هویتی در
\fB~/\&.git\-credentials\fR
(در صورت وجود) یا در
\fB$XDG_CONFIG_HOME/git/credentials\fR
(اگر وجود داشته باشد و فایل اولی موجود نباشد) نوشته خواهند شد\&. همچنین بخش
\(lqفایل‌ها (FILES)\(rq را ببینید\&.
.RE
.SH "فایل‌ها (FILES)"
.sp
اگر با \fB\-\-file\fR صریحاً مشخص نشده باشد، دو فایل وجود دارد که git\-credential\-store به ترتیب اولویت برای یافتن اطلاعات هویتی در آن‌ها جستجو می‌کند:
.PP
~/\&.git\-credentials
.RS 4
فایل اطلاعات هویتی ویژه کاربر\&.
.RE
.PP
$XDG_CONFIG_HOME/git/credentials
.RS 4
دومین فایل اطلاعات هویتی ویژه کاربر\&. اگر
\fI$XDG_CONFIG_HOME\fR
تنظیم نشده یا خالی باشد، از
\fB$HOME/\&.config/git/credentials\fR
استفاده خواهد شد\&. هرگونه اطلاعات هویتی ذخیره‌شده در این فایل، در صورتی که
\fB~/\&.git\-credentials\fR
نیز دارای اطلاعات هویتی منطبق باشد، استفاده نخواهد شد\&. توصیه می‌شود در صورتی که گاهی از نسخه‌های قدیمی‌تر گیت که از این فایل پشتیبانی نمی‌کنند استفاده می‌کنید، این فایل را ایجاد نکنید\&.
.RE
.sp
برای جستجوی اطلاعات هویتی، فایل‌ها به ترتیبی که در بالا ذکر شد خوانده می‌شوند و اولین اطلاعات هویتی منطبقِ یافت‌شده، بر اطلاعات هویتی موجود در فایل‌های بعدی فهرست اولویت دارد\&.
.sp
ذخیره‌سازی اطلاعات هویتی به طور پیش‌فرض در اولین فایل موجود در فهرست نوشته می‌شود\&. اگر هیچ‌یک از این فایل‌ها وجود نداشته باشند، \fB~/\&.git\-credentials\fR ایجاد شده و در آن نوشته می‌شود\&.
.sp
هنگام پاک کردن اطلاعات هویتی، اطلاعات منطبق از تمام فایل‌ها پاک خواهند شد\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
هدف این ابزار کمکی کاهش دفعاتی است که باید نام کاربری یا گذرواژه خود را وارد کنید\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
$ 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]
.fi
.if n \{\
.RE
.\}
.sp
.SH "قالب ذخیره‌سازی (STORAGE FORMAT)"
.sp
فایل \fB\&.git\-credentials\fR به صورت متن ساده (plaintext) ذخیره می‌شود\&. هر بخش از اطلاعات هویتی در یک خط جداگانه به صورت یک نشانی وب مانند زیر ذخیره می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
https://user:pass@example\&.com
.fi
.if n \{\
.RE
.\}
.sp
.sp
هیچ نوع خط دیگری (مانند خطوط خالی یا خطوط توضیحات) در فایل مجاز نیست، حتی اگر برخی از آن‌ها بدون هشدار نادیده گرفته شوند\&. این فایل را با ویرایشگرها مشاهده یا ویرایش نکنید\&.
.sp
هنگامی که گیت برای یک بستر نشانی وب (URL) خاص به احراز هویت نیاز دارد، credential\-store آن بستر را به عنوان الگویی برای تطبیق با هر ورودی در فایل اطلاعات هویتی در نظر می‌گیرد\&. اگر پروتکل، نام میزبان (hostname) و نام کاربری (در صورت وجود) مطابقت داشته باشند، گذرواژه به گیت بازگردانده می‌شود\&. برای اطلاعات بیشتر، به بحث پیرامون پیکربندی در \fBgitcredentials\fR(7) مراجعه کنید\&.
.SH "GIT"
.sp
بخشی از مجموعه \fBgit\fR(1)