'\" t
.\"     Title: git-remote
.\"    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: دستورات عمومی کاربر
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-REMOTE" "1" "2026\-06\-29" "Git 2\&.55\&.0" "دستورات عمومی کاربر"
.\" -----------------------------------------------------------------
.\" * 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-remote \- مدیریت مجموعه مخازن ردیابی‌شده دوردست
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBgit\fR \fBremote\fR [\fB\-v\fR | \fB\-\-verbose\fR]
\fBgit\fR \fBremote\fR \fBadd\fR [\fB\-t\fR \fI<branch>\fR] [\fB\-m\fR \fI<master>\fR] [\fB\-f\fR] [\fB\-\-\fR[\fBno\-\fR]\fBtags\fR] [\fB\-\-mirror=\fR(\fBfetch\fR|\fBpush\fR)] \fI<name>\fR \fI<URL>\fR
\fBgit\fR \fBremote\fR \fBrename\fR [\fB\-\-\fR[\fBno\-\fR]\fBprogress\fR] \fI<old>\fR \fI<new>\fR
\fBgit\fR \fBremote\fR \fBremove\fR \fI<name>\fR
\fBgit\fR \fBremote\fR \fBset\-head\fR \fI<name>\fR (\fB\-a\fR | \fB\-\-auto\fR | \fB\-d\fR | \fB\-\-delete\fR | \fI<branch>\fR)
\fBgit\fR \fBremote\fR \fBset\-branches\fR [\fB\-\-add\fR] \fI<name>\fR \fI<branch>\fR\&...
\fBgit\fR \fBremote\fR \fBget\-url\fR [\fB\-\-push\fR] [\fB\-\-all\fR] \fI<name>\fR
\fBgit\fR \fBremote\fR \fBset\-url\fR [\fB\-\-push\fR] \fI<name>\fR \fI<newurl>\fR [\fI<oldurl>\fR]
\fBgit\fR \fBremote\fR \fBset\-url\fR \fB\-\-add\fR [\fB\-\-push\fR] \fI<name>\fR \fI<newurl>\fR
\fBgit\fR \fBremote\fR \fBset\-url\fR \fB\-\-delete\fR [\fB\-\-push\fR] \fI<name>\fR \fI<URL>\fR
\fBgit\fR \fBremote\fR [\fB\-v\fR | \fB\-\-verbose\fR] \fBshow\fR [\fB\-n\fR] \fI<name>\fR\&...
\fBgit\fR \fBremote\fR \fBprune\fR [\fB\-n\fR | \fB\-\-dry\-run\fR] \fI<name>\fR\&...
\fBgit\fR \fBremote\fR [\fB\-v\fR | \fB\-\-verbose\fR] \fBupdate\fR [\fB\-p\fR | \fB\-\-prune\fR] [(\fI<group>\fR | \fI<remote>\fR)\&...]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
مدیریت مجموعه‌ای از مخازن («remotes» یا مخازن دوردست) که شاخه‌های آن‌ها را ردیابی می‌کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
اطلاعات با جزئیات بیشتری نمایش داده شده و نشانی اینترنتی (URL) مخزن دوردست پس از نام آن نشان داده می‌شود\&. برای مخازن متعهدکننده (promisor remotes)، همچنین نشان می‌دهد چه فیلترهایی
(\fBblob:none\fR
و غیره) پیکربندی شده‌اند\&. نکته: این گزینه باید بین
\fBremote\fR
و زیردستور قرار گیرد\&.
.RE
.SH "دستورها (COMMANDS)"
.sp
بدون هیچ آرگومانی، فهرستی از مخازن دوردست موجود را نمایش می‌دهد\&. چندین زیردستور برای انجام عملیات روی مخازن دوردست در دسترس است\&.
.PP
\fBadd\fR
.RS 4
یک مخزن دوردست با نام
\fI<name>\fR
برای مخزن موجود در
\fI<URL>\fR
اضافه می‌کند\&. سپس می‌توان از دستور
\fBgit\fR
\fBfetch\fR
\fI<name>\fR
برای ایجاد و به‌روزرسانی شاخه‌های ردیابی دوردست
\fI<name>\fR\fB/\fR\fI<branch>\fR
استفاده کرد\&.
.sp
با گزینه
\fB\-f\fR،
دستور
\fBgit\fR
\fBfetch\fR
\fI<name>\fR
بلافاصله پس از تنظیم اطلاعات مخزن دوردست اجرا می‌شود\&.
.sp
با گزینه
\fB\-\-tags\fR،
دستور
\fBgit\fR
\fBfetch\fR
\fI<name>\fR
تمام برچسب‌ها را از مخزن دوردست وارد می‌کند\&.
.sp
با گزینه
\fB\-\-no\-tags\fR،
دستور
\fBgit\fR
\fBfetch\fR
\fI<name>\fR
برچسب‌ها را از مخزن دوردست وارد نمی‌کند\&.
.sp
به‌طور پیش‌فرض، فقط برچسب‌های موجود در شاخه‌های دریافت‌شده وارد می‌شوند (نگاه کنید به
\fBgit-fetch\fR(1))\&.
.sp
با گزینه
\fB\-t\fR
\fI<branch>\fR،
به جای الگوی پیش‌فرض glob refspec برای مخزن دوردست جهت ردیابی تمام شاخه‌های زیر فضای نام
\fBrefs/remotes/\fR\fI<name>\fR\fB/\fR،
یک refspec برای ردیابی فقط
\fI<branch>\fR
ایجاد می‌شود\&. می‌توانید بیش از یک
\fB\-t\fR
\fI<branch>\fR
را برای ردیابی چندین شاخه بدون دریافت همه شاخه‌ها مشخص کنید\&.
.sp
با گزینه
\fB\-m\fR
\fI<master>\fR،
یک ارجاع نمادین (symbolic\-ref)
\fBrefs/remotes/\fR\fI<name>\fR\fB/HEAD\fR
تنظیم می‌شود تا به شاخه
\fI<master>\fR
مخزن دوردست اشاره کند\&. همچنین دستور set\-head را ببینید\&.
.sp
هنگامی که با
\fB\-\-mirror=fetch\fR
یک آینه دریافت (fetch mirror) ایجاد می‌شود، ارجاع‌ها در فضای نام
\fBrefs/remotes/\fR
ذخیره نخواهند شد، بلکه همه چیز در
\fBrefs/\fR
مخزن دوردست مستقیماً در
\fBrefs/\fR
مخزن محلی آینه‌سازی می‌شود\&. این گزینه فقط در مخازن bare کاربرد دارد، زیرا یک fetch هرگونه کامیت محلی را بازنویسی می‌کند\&.
.sp
هنگامی که با
\fB\-\-mirror=push\fR
یک آینه ارسال (push mirror) ایجاد می‌شود، آنگاه
\fBgit\fR
\fBpush\fR
همیشه به‌گونه‌ای رفتار خواهد کرد که گویی
\fB\-\-mirror\fR
ارسال شده است\&.
.RE
.PP
\fBrename\fR
.RS 4
مخزن دوردست با نام
\fI<old>\fR
را به
\fI<new>\fR
تغییر نام می‌دهد\&. تمامی شاخه‌های ردیابی دوردست و تنظیمات پیکربندی مربوط به مخزن دوردست به‌روزرسانی می‌شوند\&.
.sp
در صورتی که
\fI<old>\fR
و
\fI<new>\fR
یکسان باشند، و
\fI<old>\fR
فایلی در زیر
\fB$GIT_DIR/remotes\fR
یا
\fB$GIT_DIR/branches\fR
باشد، مخزن دوردست به قالب فایل پیکربندی تبدیل می‌شود\&.
.RE
.PP
\fBremove\fR, \fBrm\fR
.RS 4
مخزن دوردست با نام
\fI<name>\fR
را حذف می‌کند\&. تمامی شاخه‌های ردیابی دوردست و تنظیمات پیکربندی مربوط به مخزن دوردست حذف می‌شوند\&.
.RE
.PP
\fBset\-head\fR
.RS 4
شاخه پیش‌فرض (یعنی هدف ارجاع نمادین
\fBrefs/remotes/\fR\fI<name>\fR\fB/HEAD\fR)
را برای مخزن دوردست مشخص‌شده تنظیم یا حذف می‌کند\&. داشتن شاخه پیش‌فرض برای یک مخزن دوردست الزامی نیست، اما اجازه می‌دهد نام مخزن دوردست به جای یک شاخه خاص قید شود\&. برای مثال، اگر شاخه پیش‌فرض برای
\fBorigin\fR
روی
\fBmaster\fR
تنظیم شده باشد، آنگاه می‌توان
\fBorigin\fR
را در هر جایی که معمولاً
\fBorigin/master\fR
را مشخص می‌کردید، تعیین کرد\&.
.sp
با
\fB\-d\fR
یا
\fB\-\-delete\fR،
ارجاع نمادین
\fBrefs/remotes/\fR\fI<name>\fR\fB/HEAD\fR
حذف می‌شود\&.
.sp
با
\fB\-a\fR
یا
\fB\-\-auto\fR،
از مخزن دوردست برای تعیین
\fBHEAD\fR
آن استعلام می‌شود، سپس ارجاع نمادین
\fBrefs/remotes/\fR\fI<name>\fR\fB/HEAD\fR
روی همان شاخه تنظیم می‌گردد؛ مثلاً اگر
\fBHEAD\fR
مخزن دوردست به
\fBnext\fR
اشاره داشته باشد، دستور
\fBgit\fR
\fBremote\fR
\fBset\-head\fR
\fBorigin\fR
\fB\-a\fR
ارجاع نمادین
\fBrefs/remotes/origin/HEAD\fR
را روی
\fBrefs/remotes/origin/next\fR
تنظیم خواهد کرد\&. این تنها در صورتی کار خواهد کرد که
\fBrefs/remotes/origin/next\fR
از قبل وجود داشته باشد؛ در غیر این صورت ابتدا باید دریافت (fetch) شود\&.
.sp
از
\fI<branch>\fR
برای تنظیم صریح ارجاع نمادین
\fBrefs/remotes/\fR\fI<name>\fR\fB/HEAD\fR
استفاده کنید؛ مثلاً
\fBgit\fR
\fBremote\fR
\fBset\-head\fR
\fBorigin\fR
\fBmaster\fR
ارجاع نمادین
\fBrefs/remotes/origin/HEAD\fR
را روی
\fBrefs/remotes/origin/master\fR
تنظیم خواهد کرد\&. این تنها در صورتی کار خواهد کرد که
\fBrefs/remotes/origin/master\fR
از قبل وجود داشته باشد؛ در غیر این صورت ابتدا باید دریافت (fetch) شود\&.
.RE
.PP
\fBset\-branches\fR
.RS 4
فهرست شاخه‌های ردیابی‌شده توسط مخزن دوردست مشخص‌شده را تغییر می‌دهد\&. این دستور می‌تواند برای ردیابی زیرمجموعه‌ای از شاخه‌های دوردست موجود پس از راه‌اندازی اولیه یک مخزن دوردست استفاده شود\&.
.sp
شاخه‌های مشخص‌شده به‌گونه‌ای تفسیر می‌شوند که گویی با گزینه
\fB\-t\fR
در خط فرمان
\fBgit\fR
\fBremote\fR
\fBadd\fR
مشخص شده‌اند\&.
.sp
با
\fB\-\-add\fR،
به جای جایگزین کردن فهرست شاخه‌هایی که در حال حاضر ردیابی می‌شوند، به آن فهرست اضافه می‌کند\&.
.RE
.PP
\fBget\-url\fR
.RS 4
نشانی‌های اینترنتی (URLها) یک مخزن دوردست را بازیابی می‌کند\&. پیکربندی‌های
\fBinsteadOf\fR
و
\fBpushInsteadOf\fR
در اینجا بسط داده می‌شوند\&. به‌طور پیش‌فرض، فقط نخستین URL فهرست می‌شود\&.
.sp
با
\fB\-\-push\fR،
به جای URLهای دریافت (fetch)، نشانی‌های ارسال (push) پرس‌وجو می‌شوند\&.
.sp
با
\fB\-\-all\fR،
تمامی URLهای مربوط به مخزن دوردست فهرست خواهند شد\&.
.RE
.PP
\fBset\-url\fR
.RS 4
نشانی‌های اینترنتی (URLها) مربوط به مخزن دوردست را تغییر می‌دهد\&. اولین URL مخزن دوردست
\fI<name>\fR
را که با عبارت باقاعده (regex)
\fI<oldurl>\fR
مطابقت دارد (یا اولین URL در صورت عدم تعیین
\fI<oldurl>\fR)
به
\fI<newurl>\fR
تنظیم می‌کند\&. اگر
\fI<oldurl>\fR
با هیچ URLای مطابقت نداشته باشد، خطا رخ داده و چیزی تغییر نمی‌کند\&.
.sp
با
\fB\-\-push\fR،
به جای URLهای دریافت، نشانی‌های ارسال دستکاری می‌شوند\&.
.sp
با
\fB\-\-add\fR،
به جای تغییر URLهای موجود، نشانی اینترنتی جدید اضافه می‌شود\&.
.sp
با
\fB\-\-delete\fR،
به جای تغییر URLهای موجود، تمامی URLهای مطابق با عبارت باقاعده
\fI<URL>\fR
برای مخزن دوردست
\fI<name>\fR
حذف می‌شوند\&. تلاش برای حذف تمام URLهای غیر از push یک خطا است\&.
.sp
توجه داشته باشید که نشانی ارسال (push URL) و نشانی دریافت (fetch URL)، با وجود اینکه می‌توانند متفاوت تنظیم شوند، اما همچنان باید به یک مکان اشاره کنند\&. آنچه به push URL ارسال می‌کنید باید همان چیزی باشد که در صورت دریافت فوری از fetch URL مشاهده می‌کنید\&. اگر تلاش می‌کنید از یک مکان دریافت کرده (مانند مخزن بالادستی شما) و به مکان دیگری ارسال کنید (مانند مخزن انتشار خود)، از دو مخزن دوردست مجزا استفاده کنید\&.
.RE
.PP
\fBshow\fR
.RS 4
اطلاعاتی درباره مخزن دوردست
\fI<name>\fR
ارائه می‌دهد\&.
.sp
با گزینه
\fB\-n\fR،
ابتدا وضعیت headهای دوردست با دستور
\fBgit\fR
\fBls\-remote\fR
\fI<name>\fR
استعلام نمی‌شود؛ بلکه به جای آن از اطلاعات ذخیره‌شده در حافظه نهان استفاده می‌گردد\&.
.RE
.PP
\fBprune\fR
.RS 4
ارجاع‌های کهنه مرتبط با
\fI<name>\fR
را حذف می‌کند\&. به‌طور پیش‌فرض، شاخه‌های ردیابی دوردست کهنه زیر
\fI<name>\fR
حذف می‌شوند، اما بسته به پیکربندی سراسری و پیکربندی مخزن دوردست، حتی ممکن است برچسب‌های محلی که به آنجا ارسال نشده‌اند نیز هرس شوند\&. این کار معادل دستور
\fBgit\fR
\fBfetch\fR
\fB\-\-prune\fR
\fI<name>\fR
است، به جز اینکه هیچ ارجاع جدیدی دریافت نخواهد شد\&.
.sp
بخش PRUNING در
\fBgit-fetch\fR(1)
را برای آنچه که بسته به پیکربندی‌های مختلف هرس خواهد شد ببینید\&.
.sp
با گزینه
\fB\-\-dry\-run\fR،
گزارش می‌دهد چه شاخه‌هایی هرس خواهند شد، اما در عمل آن‌ها را هرس نمی‌کند\&.
.RE
.PP
\fBupdate\fR
.RS 4
به‌روزرسانی‌ها را برای مخازن دوردست یا گروه‌های مخزن دوردست در مخزن همان‌طور که توسط
\fBremotes\&.\fR\fI<group>\fR
تعریف شده است دریافت می‌کند\&. اگر نه گروه و نه مخزن دوردست در خط فرمان مشخص نشده باشند، پارامتر پیکربندی
\fBremotes\&.default\fR
استفاده خواهد شد؛ اگر
\fBremotes\&.default\fR
تعریف نشده باشد، تمامی مخازن دوردستی که پارامتر پیکربندی
\fBremote\&.\fR\fI<name>\fR\fB\&.skipDefaultUpdate\fR
آن‌ها روی
\fBtrue\fR
تنظیم نشده باشد، به‌روزرسانی خواهند شد\&. (نگاه کنید به
\fBgit-config\fR(1))\&.
.sp
با گزینه
\fB\-\-prune\fR،
عملیات هرس را برای تمام مخازن دوردستی که به‌روزرسانی می‌شوند اجرا می‌کند\&.
.RE
.SH "بحث و بررسی (DISCUSSION)"
.sp
پیکربندی مخزن دوردست با استفاده از متغیرهای پیکربندی \fBremote\&.origin\&.url\fR و \fBremote\&.origin\&.fetch\fR انجام می‌شود\&. (نگاه کنید به \fBgit-config\fR(1))\&.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
در صورت موفقیت، وضعیت خروج \fB0\fR است\&.
.sp
هنگامی که زیردستورهایی مانند \fBadd\fR، \fBrename\fR و \fBremove\fR نتوانند مخزن دوردست مورد نظر را بیابند، وضعیت خروج \fB2\fR خواهد بود\&. هنگامی که مخزن دوردست از قبل وجود داشته باشد، وضعیت خروج \fB3\fR است\&.
.sp
در صورت وقوع هر خطای دیگری، وضعیت خروج ممکن است هر مقدار غیر صفر دیگری باشد\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
افزودن یک مخزن دوردست جدید، دریافت (fetch)، و چک‌اوت یک شاخه از آن
.sp
.if n \{\
.RS 4
.\}
.nf
$ git remote
origin
$ git branch \-r
  origin/HEAD \-> origin/master
  origin/master
$ git remote add staging git://git\&.kernel\&.org/\&.\&.\&./gregkh/staging\&.git
$ git remote
origin
staging
$ git fetch staging
\&.\&.\&.
From git://git\&.kernel\&.org/pub/scm/linux/kernel/git/gregkh/staging
 * [new branch]      master     \-> staging/master
 * [new branch]      staging\-linus \-> staging/staging\-linus
 * [new branch]      staging\-next \-> staging/staging\-next
$ git branch \-r
  origin/HEAD \-> origin/master
  origin/master
  staging/master
  staging/staging\-linus
  staging/staging\-next
$ git switch \-c staging staging/master
\&.\&.\&.
.fi
.if n \{\
.RE
.\}
.sp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تقلید رفتار
\fBgit\fR
\fBclone\fR
اما فقط با ردیابی شاخه‌های انتخاب‌شده
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkdir project\&.git
$ cd project\&.git
$ git init
$ git remote add \-f \-t master \-m master origin git://example\&.com/git\&.git/
$ git merge origin
.fi
.if n \{\
.RE
.\}
.sp
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgit-fetch\fR(1) \fBgit-branch\fR(1) \fBgit-config\fR(1)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)