.\
.\"
.TH "DISTROBOX\-ENTER" "1" "Mar 2026" "Distrobox" "User Manual"
.SH "نام (NAME)"
distrobox\-enter \- ورود به کانتینر با نام مشخص‌شده
.SH "توضیحات (DESCRIPTION)"
دستور distrobox\-enter وظیفهٔ ورود به کانتینر با نام مشخص‌شده را بر عهده
دارد.
دستور پیش‌فرضی که اجرا می‌شود SHELL شما است، اما می‌توانید پوسته‌های دیگر یا دستورات
کاملی را برای اجرا تعیین کنید.
اگر از آن درون یک اسکریپت، یک برنامه یا یک سرویس استفاده می‌کنید، می‌توانید
حالت \[en]headless را برای غیرفعال کردن tty و تعاملی بودن مشخص کنید.
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]distrobox enter\f[R]
.IP
.EX
\-\-name/\-n:      نام برای distrobox                          پیش‌فرض: my\-distrobox
\-\-/\-e:          پایان آرگومان‌ها، اجرای مابقی به عنوان دستور هنگام ورود   پیش‌فرض: پوستهٔ پیش‌فرض ${USER}
\-\-no\-tty/\-T:        عدم راه‌اندازی tty
\-\-no\-workdir/\-nw:   همیشه کانتینر از دایرکتوری خانگی کانتینر آغاز شود
\-\-additional\-flags/\-a:  پرچم‌های اضافی برای ارسال به دستور مدیر کانتینر
\-\-help/\-h:      نمایش این پیام
\-\-root/\-r:      راه‌اندازی podman/docker/lilipod با دسترسی‌های ریشه. توجه کنید اگر به ریشه نیاز دارید، این روش نسبت
            به \[dq]sudo distrobox\[dq] ارجح است (نکته: در صورت نیاز به استفاده از برنامه‌ای غیر از \[aq]sudo\[aq] برای دسترسی‌های ریشه،
            آن را از طریق متغیر محیطی DBX_SUDO_PROGRAM یا متغیر پیکربندی \[aq]distrobox_sudo_program\[aq] مشخص کنید)
\-\-dry\-run/\-d:       صرفاً چاپ دستور تولیدشدهٔ مدیر کانتینر
\-\-verbose/\-v:       نمایش جزئیات بیشتر
\-\-version/\-V:       نمایش نسخه
.EE
.SH "مثال‌ها (EXAMPLES)"
ورود به یک distrobox با نام \[lq]example\[rq]
.IP
.EX
distrobox\-enter example
.EE
.PP
ورود به یک distrobox با تعیین یک دستور
.IP
.EX
distrobox\-enter \-\-name fedora\-toolbox\-35 \-\- bash \-l
distrobox\-enter my\-alpine\-container \-\- sh \-l
.EE
.PP
استفاده از پرچم‌های اضافی podman/docker/lilipod هنگام ورود به یک distrobox
.IP
.EX
distrobox\-enter \-\-additional\-flags \[dq]\-\-preserve\-fds\[dq] \-\-name test \-\- bash \-l
.EE
.PP
تعیین متغیرهای محیطی اضافی هنگام ورود به یک distrobox
.IP
.EX
distrobox\-enter \-\-additional\-flags \[dq]\-\-env MY_VAR=value\[dq] \-\-name test \-\- bash \-l
MY_VAR=value distrobox\-enter \-\-additional\-flags \[dq]\-\-preserve\-fds\[dq] \-\-name test \-\- bash \-l
.EE
.PP
همچنین می‌توانید از متغیرهای محیطی برای مشخص کردن مدیر کانتینر و نام کانتینر استفاده کنید:
.IP
.EX
DBX_CONTAINER_MANAGER=\[dq]docker\[dq] DBX_CONTAINER_NAME=test\-alpine distrobox\-enter
.EE
.SH "محیط (ENVIRONMENT)"
.IP
.EX
DBX_CONTAINER_NAME
DBX_CONTAINER_MANAGER
DBX_SKIP_WORKDIR
DBX_SUDO_PROGRAM
.EE
.SH "اطلاعات بیشتر (EXTRA)"
این دستور برای ورود به خود distrobox استفاده می‌شود.
شخصاً، من صرفاً چندین نمایه (profile) در \f[CR]gnome\-terminal\f[R] خود ایجاد می‌کنم تا چندین توزیع در دسترس داشته باشم.
.PP
گزینهٔ \f[CR]\-\-additional\-flags\f[R] یا \f[CR]\-a\f[R] برای تغییر
دستور پیش‌فرض هنگام اجرا در کانتینر مفید است.
برای مثال:
.IP
.EX
distrobox enter \-n dev\-arch \-\-additional\-flags \[dq]\-\-env my_var=test\[dq] \-\- printenv &| grep my_var
my_var=test
.EE
.PP
این کار با استفاده از متغیرهای محیطی معمولی نیز امکان‌پذیر است:
.IP
.EX
my_var=test distrobox enter \-n dev\-arch \-\-additional\-flags \-\- printenv &| grep my_var
my_var=test
.EE
.PP
اگر مایلید وارد یک کانتینر با دسترسی ریشه (rootful) شوید و کاری کنید که distrobox از
برنامه‌ای غیر از \[aq]sudo\[aq] برای اجرای podman/docker/lilipod با دسترسی ریشه استفاده کند (مانند
\[aq]pkexec\[aq] یا \[aq]doas\[aq])، می‌توانید آن را با متغیر محیطی
\f[CR]DBX_SUDO_PROGRAM\f[R] مشخص کنید.
برای مثال، جهت استفاده از \[aq]doas\[aq] برای ورود به یک کانتینر با دسترسی ریشه:
.IP
.EX
DBX_SUDO_PROGRAM=\[dq]doas\[dq] distrobox enter \-n container \-\-root
.EE
.PP
علاوه بر این، در یکی از مسیرهای فایل پیکربندی که distrobox پشتیبانی می‌کند،
مانند \f[CR]\[ti]/.distroboxrc\f[R]، می‌توانید خط
\f[CR]distrobox_sudo_program=\[dq]doas\[dq]\f[R] را (برای مثال) اضافه کنید تا
دستورات distrobox مربوط به کانتینرهای با دسترسی ریشه همیشه با استفاده از \[aq]doas\[aq] اجرا شوند.