.nh
.TH "GH-AUTH-LOGIN" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-auth-login \- ورود به یک حساب گیت‌هاب


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh auth login [flags]\fR


.SH "توضیحات (DESCRIPTION)"
احراز هویت با یک میزبان گیت‌هاب.

.PP
نام میزبان پیش‌فرض
.B github.com
است. این مقدار می‌تواند با استفاده از پرچم
.B \-\-hostname
تغییر داده شود.

.PP
حالت احراز هویت پیش‌فرض، یک فرآیند مبتنی بر مرورگر وب است. پس از تکمیل، یک توکن احراز هویت به‌صورت امن در مخزن اعتبارسنجی سیستم ذخیره خواهد شد. در صورتی که مخزن اعتبارسنجی یافت نشود یا مشکلی در استفاده از آن رخ دهد،
.B gh
به‌عنوان راه‌حل جایگزین توکن را در یک فایل متنی ساده ذخیره خواهد کرد. برای مشاهده محل ذخیره‌سازی،
.B gh auth status
را ببینید.

.PP
همچنین می‌توانید از
.B \-\-with\-token
برای ارسال یک توکن دسترسی شخصی کلاسیک از طریق ورودی استاندارد استفاده کنید. حداقل دامنه‌های دسترسی (scopes) مورد نیاز برای توکن عبارتند از:
.BR repo ،
.B read:org
و
.BR gist .
هنگام ارسال توکن دسترسی شخصی دقیق (fine-grained) به
.B \-\-with\-token
احتیاط کنید؛ زیرا محدودیت ذاتی دامنه به منابع خاص ممکن است هنگام تعامل با سایر منابع رفتار غیرمنتظره‌ای ایجاد کند. برای استفاده از توکن دسترسی شخصی دقیق، تنظیم متغیر
.B GH_TOKEN
را در اولویت قرار دهید.

.PP
همچنین،
.B gh
می‌تواند از توکن احراز هویت موجود در متغیرهای محیطی استفاده کند. این روش برای استفاده بدون واسط گرافیکی (headless) از
.B gh
مانند خودکارسازی‌ها بسیار مناسب است. برای اطلاعات بیشتر،
.B gh help environment
را ببینید.

.PP
برای استفاده از
.B gh
در گیت‌هاب اکشنز (GitHub Actions)، مقدار
.B GH_TOKEN: ${{ github.token }}
را به
.B env
اضافه کنید.

.PP
پروتکل گیت مورد استفاده برای عملیات‌های گیت روی این میزبان را می‌توان با گزینه
.B \-\-git\-protocol
یا در حین اعلان‌های تعاملی مشخص کرد. اگرچه ورود به حساب تنها برای یک حساب کاربری روی یک میزبان است، اما تنظیم پروتکل گیت برای تمام کاربران آن میزبان اعمال خواهد شد.

.PP
مشخص کردن
.B ssh
برای پروتکل گیت، کلیدهای SSH موجود را برای بارگذاری شناسایی می‌کند و در صورت عدم وجود کلید، پیامی برای ساخت و بارگذاری کلید جدید نمایش می‌دهد. این مرحله را می‌توان با پرچم
.B \-\-skip\-ssh\-key
نادیده گرفت.

.PP
برای اطلاعات بیشتر درباره دامنه‌های دسترسی OAuth، پیوند زیر را ببینید:
.PP
\[la]https://docs.github.com/en/developers/apps/building\-oauth\-apps/scopes\-for\-oauth\-apps\[ra]\&.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-c\fR, \fB--clipboard\fR
کپی کردن کد یک‌بارمصرف دستگاه OAuth در کلیپ‌بورد

.TP
\fB-p\fR, \fB--git-protocol\fR \fB<string>\fR
پروتکل مورد استفاده برای عملیات‌های گیت روی این میزبان: {ssh|https}

.TP
\fB-h\fR, \fB--hostname\fR \fB<string>\fR
نام میزبان نمونه گیت‌هاب برای احراز هویت با آن

.TP
\fB--insecure-storage\fR
ذخیره اطلاعات احراز هویت به‌صورت متن ساده به‌جای استفاده از مخزن اعتبارسنجی

.TP
\fB-s\fR, \fB--scopes\fR \fB<strings>\fR
دامنه‌های دسترسی احراز هویت اضافی برای درخواست

.TP
\fB--skip-ssh-key\fR
صرف‌نظر کردن از اعلان ساخت یا بارگذاری کلید SSH

.TP
\fB-w\fR, \fB--web\fR
باز کردن یک مرورگر برای احراز هویت

.TP
\fB--with-token\fR
خواندن توکن از ورودی استاندارد


.SH "کدهای خروج (EXIT CODES)"
0: اجرای موفقیت‌آمیز

.PP
1: خطا

.PP
2: دستور لغو شد

.PP
4: نیاز به احراز هویت است

.PP
نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای اطلاعات بیشتر به راهنمای همان دستور مراجعه کنید.


.SH "مثال‌ها (EXAMPLES)"
.EX
# شروع راه‌اندازی و ورود تعاملی
$ gh auth login

# باز کردن مرورگر برای احراز هویت و کپی کد یک‌بارمصرف OAuth در کلیپ‌بورد
$ gh auth login --web --clipboard

# احراز هویت در github.com با خواندن توکن از یک فایل
$ gh auth login --with-token < mytoken.txt

# احراز هویت با یک میزبان خاص
$ gh auth login --hostname enterprise.internal

.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBgh-auth(1)\fR