GH-RELEASE-DOWNLOAD(1)         GitHub CLI manual        GH-RELEASE-DOWNLOAD(1)



نام (NAME)
       gh-release-download - دانلود فایل‌های یک انتشار


خلاصه دستور (SYNOPSIS)
       gh release download [<tag>] [flags]


توضیحات (DESCRIPTION)
       دانلود فایل‌ها و دارایی‌ها (assets) از یک انتشار گیت‌هاب (GitHub release).


       بدون آرگومان صریح نام برچسب (tag name)، فایل‌ها از آخرین انتشار پروژه
       دانلود می‌شوند. در این حالت، مشخص کردن --pattern یا --archive الزامی
       است.


گزینه‌ها (OPTIONS)
       --allow-escape-sequences
              اجازه چاپ توالی‌های گریز ترمینال هنگام نوشتن یک فایل در خروجی
              استاندارد


       -A, --archive <format>
              دانلود آرشیو کد منبع در قالب مشخص‌شده (zip یا tar.gz)


       --clobber
              رونویسی فایل‌های موجود با نام یکسان


       -D, --dir <directory> (default ".")
              دایرکتوری مقصد برای دانلود فایل‌ها


       -O, --output <file>
              فایلی برای نوشتن یک دارایی تکی در آن (از "-" برای نوشتن در خروجی
              استاندارد استفاده کنید)


       -p, --pattern <stringArray>
              تنها دانلود فایل‌هایی که با یک الگوی glob مطابقت دارند


       --skip-existing
              صرف‌نظر کردن از دانلود در صورت وجود فایل‌هایی با نام مشابه


گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)
       -R, --repo <[HOST/]OWNER/REPO>
              انتخاب یک مخزن دیگر با استفاده از قالب [HOST/]OWNER/REPO


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


       1: خطا


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


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


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


مثال (EXAMPLE)
       # دانلود تمام فایل‌های یک انتشار مشخص
       $ gh release download v1.2.3

       # دانلود تنها بسته‌های دبیان برای آخرین انتشار
       $ gh release download --pattern '*.deb'

       # مشخص کردن چندین الگوی فایل
       $ gh release download -p '*.deb' -p '*.rpm'

       # دانلود آرشیو کد منبع برای یک انتشار
       $ gh release download v1.2.3 --archive=zip



همچنین ببینید (SEE ALSO)
       gh-release(1)

                                   Sep 2026             GH-RELEASE-DOWNLOAD(1)