.nh
.TH "act" "1" "Jun 2026" "act 0.2.89" ""

.SH "نام (NAME)"
act \- اجرای محلی اکشن‌های GitHub Actions


.SH "خلاصه دستور (SYNOPSIS)"
\fBact\fP [\fIنام رویداد برای اجرا\fP] [\fIگزینه‌ها\fP]

.PP
اگر هیچ نام رویدادی مشخص نشود، به‌طور پیش‌فرض از "on: push" استفاده خواهد شد.
اگر اکشن‌ها تنها از یک رویداد پشتیبانی کنند، به‌جای "on: push" از آن به عنوان پیش‌فرض استفاده می‌شود.


.SH "توضیحات (DESCRIPTION)"
اجرای محلی اکشن‌های GitHub Actions با مشخص کردن نام رویداد (مانند \fBpush\fR) یا مستقیماً نام یک اکشن.


.SH "گزینه‌ها (OPTIONS)"
\fB--action-cache-path\fP="/build/.cache/act"
	مسیر کش شدن اکشن‌ها و ایجاد فضاهای کاری میزبان را مشخص می‌کند.

.PP
\fB--action-offline-mode\fP[=false]
	اگر محتوای اکشن وجود داشته باشد، مجدداً دریافت و واکشی نمی‌شود. فعال کردن این گزینه، دریافت اجباری (force pull) را غیرفعال می‌کند.

.PP
\fB-a\fP, \fB--actor\fP="nektos/act"
	کاربری که رویداد را ایجاد کرده است.

.PP
\fB--artifact-server-addr\fP="162.55.28.166"
	آدرسی را که سرور آرتیفکت به آن متصل می‌شود مشخص می‌کند.

.PP
\fB--artifact-server-path\fP=""
	مسیری را مشخص می‌کند که سرور آرتیفکت فایل‌های آپلود شده را در آن ذخیره کرده و دانلودها را از آن بازیابی می‌کند. اگر مشخص نشود، سرور آرتیفکت راه‌اندازی نخواهد شد.

.PP
\fB--artifact-server-port\fP="34567"
	درگاهی (پورت) را که سرور آرتیفکت روی آن گوش می‌دهد مشخص می‌کند.

.PP
\fB-b\fP, \fB--bind\fP[=false]
	دایرکتوری کاری را به کانتینر متصل (bind) می‌کند، به جای این‌که آن را کپی کند.

.PP
\fB--bug-report\fP[=false]
	نمایش اطلاعات سیستم برای گزارش باگ.

.PP
\fB--cache-server-addr\fP="162.55.28.166"
	آدرسی را که سرور کش به آن متصل می‌شود مشخص می‌کند.

.PP
\fB--cache-server-external-url\fP=""
	نشانی اینترنتی (URL) خارجی را در صورتی که سرور کش پشت یک پروکسی باشد مشخص می‌کند؛ مانند: https://act-cache-server.example.com (دقت کنید که بدون اسلش پایانی باشد).

.PP
\fB--cache-server-path\fP="/build/.cache/actcache"
	مسیری را که سرور کش، کش‌ها را در آن ذخیره می‌کند مشخص می‌کند.

.PP
\fB--cache-server-port\fP=0
	درگاهی را که سرور کش روی آن گوش می‌دهد مشخص می‌کند. مقدار 0 به معنای یک درگاه تصادفی آزاد است.

.PP
\fB--concurrent-jobs\fP=0
	حداکثر تعداد کارهای همزمان برای اجرا. مقدار پیش‌فرض برابر با تعداد پردازنده‌های در دسترس است.

.PP
\fB--container-architecture\fP=""
	معماری مورد استفاده برای اجرای کانتینرها، مانند: linux/amd64. در صورت عدم تعیین، از معماری پیش‌فرض میزبان استفاده می‌شود. نیازمند Docker server API نسخه 1.41+ است. در پلتفرم‌های قدیمی‌تر Docker سرور نادیده گرفته می‌شود.

.PP
\fB--container-cap-add\fP=[]
	قابلیت‌های هسته (kernel capabilities) برای افزودن به کانتینرهای ورک‌فلو (مانند --container-cap-add SYS_PTRACE).

.PP
\fB--container-cap-drop\fP=[]
	قابلیت‌های هسته (kernel capabilities) برای حذف از کانتینرهای ورک‌فلو (مانند --container-cap-drop SYS_PTRACE).

.PP
\fB--container-daemon-socket\fP=""
	شناسه منبع یکنواخت (URI) سوکت Docker Engine (مانند: unix://~/.docker/run/docker.sock یا - برای غیرفعال کردن اتصال سوکت).

.PP
\fB--container-options\fP=""
	گزینه‌های سفارشی کانتینر داکر برای کانتینر وظیفه (job) که در تعریف آن ویژگی options مشخص نشده است.

.PP
\fB--defaultbranch\fP=""
	نام شاخه اصلی.

.PP
\fB--detect-event\fP[=false]
	استفاده از اولین نوع رویداد از ورک‌فلو به عنوان رویدادی که ورک‌فلو را آغاز کرده است.

.PP
\fB-C\fP, \fB--directory\fP="."
	دایرکتوری کاری.

.PP
\fB-n\fP, \fB--dryrun\fP[=false]
	غیرفعال کردن ایجاد کانتینر و فقط اعتبارسنجی درستی ورک‌فلو.

.PP
\fB--env\fP=[]
	متغیر محیطی برای در دسترس قرار دادن در اکشن‌ها همراه با مقدار اختیاری (مانند --env myenv=foo یا --env myenv).

.PP
\fB--env-file\fP=".env"
	فایل محیطی برای خواندن و استفاده به عنوان متغیرهای محیطی در کانتینرها.

.PP
\fB-e\fP, \fB--eventpath\fP=""
	مسیر فایل JSON رویداد.

.PP
\fB--github-instance\fP="github.com"
	نمونه گیت‌هاب مورد استفاده. تنها هنگام استفاده از GitHub Enterprise Server از این گزینه استفاده کنید.

.PP
\fB-g\fP, \fB--graph\fP[=false]
	رسم گراف ورک‌فلوها.

.PP
\fB-h\fP, \fB--help\fP[=false]
	نمایش راهنمای act.

.PP
\fB--input\fP=[]
	ورودی اکشن برای در دسترس قرار دادن در اکشن‌ها (مانند --input myinput=foo).

.PP
\fB--input-file\fP=".input"
	فایل ورودی برای خواندن و استفاده به عنوان ورودی اکشن.

.PP
\fB--insecure-secrets\fP[=false]
	توصیه نمی‌شود! هنگام چاپ لاگ‌ها، رازها (secrets) را پنهان نمی‌کند.

.PP
\fB-j\fP, \fB--job\fP=""
	اجرای یک شناسه وظیفه (Job ID) خاص.

.PP
\fB--json\fP[=false]
	خروجی دادن لاگ‌ها در قالب JSON.

.PP
\fB-l\fP, \fB--list\fP[=false]
	فهرست کردن ورک‌فلوها.

.PP
\fB--list-options\fP[=false]
	چاپ یک ساختار JSON از گزینه‌های سازگار.

.PP
\fB--local-repository\fP=[]
	جایگزین کردن مخزن و ارجاع (ref) مشخص‌شده با یک پوشه محلی (مانند https://github.com/test/test@v0=/home/act/test یا test/test@v0=/home/act/test که مورد دوم با هر میزبان یا پروتکلی مطابقت دارد).

.PP
\fB--log-prefix-job-id\fP[=false]
	خروجی دادن شناسه وظیفه در لاگ‌های غیر JSON به جای نام کامل آن.

.PP
\fB--man-page\fP[=false]
	چاپ صفحه راهنمای تولید شده در خروجی استاندارد (stdout).

.PP
\fB--matrix\fP=[]
	مشخص کردن این‌که کدام پیکربندی ماتریسی گنجانده شود (مانند --matrix java:13).

.PP
\fB--network\fP="host"
	نام شبکه داکر را تنظیم می‌کند. پیش‌فرض host است.

.PP
\fB--no-cache-server\fP[=false]
	غیرفعال کردن سرور کش.

.PP
\fB--no-recurse\fP[=false]
	فلگ غیرفعال کردن اجرای ورک‌فلوها از زیرپوشه‌های مسیر مشخص شده در فلگ‌های '--workflows'/'-W'.

.PP
\fB--no-skip-checkout\fP[=false]
	استفاده از actions/checkout به جای کپی کردن فایل‌های محلی به درون کانتینر.

.PP
\fB-P\fP, \fB--platform\fP=[]
	ایمیج سفارشی مورد استفاده برای هر پلتفرم (مانند -P ubuntu-18.04=nektos/act-environments-ubuntu:18.04).

.PP
\fB--privileged\fP[=false]
	استفاده از حالت دسترسی ویژه (privileged mode).

.PP
\fB-p\fP, \fB--pull\fP[=true]
	دریافت (pull) ایمیج‌های داکر حتی در صورتی که از قبل موجود باشند.

.PP
\fB-q\fP, \fB--quiet\fP[=false]
	غیرفعال کردن ثبت خروجی گام‌ها در لاگ.

.PP
\fB--rebuild\fP[=true]
	بازسازی ایمیج‌های داکر اکشن محلی حتی در صورتی که از قبل موجود باشند.

.PP
\fB--remote-name\fP="origin"
	نام ریموت گیت که برای دریافت نشانی مخزن گیت استفاده می‌شود.

.PP
\fB--replace-ghe-action-token-with-github-com\fP=""
	اگر از replace-ghe-action-with-github-com استفاده می‌کنید و می‌خواهید از اکشن‌های خصوصی در گیت‌هاب استفاده کنید، باید توکن دسترسی شخصی (personal access token) را تنظیم نمایید.

.PP
\fB--replace-ghe-action-with-github-com\fP=[]
	اگر از GitHub Enterprise Server استفاده می‌کنید و اجازه استفاده از اکشن‌های خاص از GitHub (github.com) را می‌دهید، می‌توانید اکشن‌ها را در این گزینه تنظیم کنید (مانند --replace-ghe-action-with-github-com =github/super-linter).

.PP
\fB-r\fP, \fB--reuse\fP[=false]
	عدم حذف کانتینرها پس از تکمیل موفقیت‌آمیز ورک‌فلوها برای حفظ وضعیت بین دفعات اجرا.

.PP
\fB--rm\fP[=false]
	حذف خودکار کانتینرها/والیوم‌ها پس از شکست یک یا چند ورک‌فلو.

.PP
\fB-s\fP, \fB--secret\fP=[]
	راز (secret) برای در دسترس قرار دادن در اکشن‌ها همراه با مقدار اختیاری (مانند -s mysecret=foo یا -s mysecret).

.PP
\fB--secret-file\fP=".secrets"
	فایل حاوی فهرستی از رازها برای خواندن (مانند --secret-file .secrets).

.PP
\fB--strict\fP[=false]
	استفاده از ساختار (schema) سخت‌گیرانه ورک‌فلو.

.PP
\fB--use-gitignore\fP[=true]
	کنترل می‌کند که آیا مسیرهای مشخص شده در .gitignore باید به داخل کانتینر کپی شوند یا خیر.

.PP
\fB--use-new-action-cache\fP[=false]
	فعال کردن استفاده از Action Cache جدید برای ذخیره محلی اکشن‌ها.

.PP
\fB--userns\fP=""
	فضای نام کاربر (user namespace) مورد استفاده.

.PP
\fB--validate\fP[=false]
	اعتبارسنجی ورک‌فلوها.

.PP
\fB--var\fP=[]
	متغیر برای در دسترس قرار دادن در اکشن‌ها همراه با مقدار اختیاری (مانند --var myvar=foo یا --var myvar).

.PP
\fB--var-file\fP=".vars"
	فایل حاوی فهرستی از متغیرها برای خواندن (مانند --var-file .vars).

.PP
\fB-v\fP, \fB--verbose\fP[=false]
	خروجی با جزئیات کامل.

.PP
\fB--version\fP[=false]
	نمایش نسخه act.

.PP
\fB-w\fP, \fB--watch\fP[=false]
	نظارت بر محتویات مخزن محلی و اجرا در هنگام تغییر فایل‌ها.

.PP
\fB-W\fP, \fB--workflows\fP="./.github/workflows/"
	مسیر فایل(های) ورک‌فلو.


.SH "تاریخچه (HISTORY)"
1-Jun-2026 تولید خودکار توسط spf13/cobra