DISTROBOX-ENTER(1) User Manual DISTROBOX-ENTER(1)

distrobox-enter - ورود به کانتینر با نام مشخص‌شده

دستور distrobox-enter وظیفهٔ ورود به کانتینر با نام مشخص‌شده را بر عهده دارد. دستور پیش‌فرضی که اجرا می‌شود SHELL شما است، اما می‌توانید پوسته‌های دیگر یا دستورات کاملی را برای اجرا تعیین کنید. اگر از آن درون یک اسکریپت، یک برنامه یا یک سرویس استفاده می‌کنید، می‌توانید حالت –headless را برای غیرفعال کردن tty و تعاملی بودن مشخص کنید.

distrobox enter

--name/-n:      نام برای distrobox                          پیش‌فرض: my-distrobox
--/-e:          پایان آرگومان‌ها، اجرای مابقی به عنوان دستور هنگام ورود   پیش‌فرض: پوستهٔ پیش‌فرض ${USER}
--no-tty/-T:        عدم راه‌اندازی tty
--no-workdir/-nw:   همیشه کانتینر از دایرکتوری خانگی کانتینر آغاز شود
--additional-flags/-a:  پرچم‌های اضافی برای ارسال به دستور مدیر کانتینر
--help/-h:      نمایش این پیام
--root/-r:      راه‌اندازی podman/docker/lilipod با دسترسی‌های ریشه. توجه کنید اگر به ریشه نیاز دارید، این روش نسبت
            به "sudo distrobox" ارجح است (نکته: در صورت نیاز به استفاده از برنامه‌ای غیر از 'sudo' برای دسترسی‌های ریشه،
            آن را از طریق متغیر محیطی DBX_SUDO_PROGRAM یا متغیر پیکربندی 'distrobox_sudo_program' مشخص کنید)
--dry-run/-d:       صرفاً چاپ دستور تولیدشدهٔ مدیر کانتینر
--verbose/-v:       نمایش جزئیات بیشتر
--version/-V:       نمایش نسخه

ورود به یک distrobox با نام “example”

distrobox-enter example

ورود به یک distrobox با تعیین یک دستور

distrobox-enter --name fedora-toolbox-35 -- bash -l
distrobox-enter my-alpine-container -- sh -l

استفاده از پرچم‌های اضافی podman/docker/lilipod هنگام ورود به یک distrobox

distrobox-enter --additional-flags "--preserve-fds" --name test -- bash -l

تعیین متغیرهای محیطی اضافی هنگام ورود به یک distrobox

distrobox-enter --additional-flags "--env MY_VAR=value" --name test -- bash -l
MY_VAR=value distrobox-enter --additional-flags "--preserve-fds" --name test -- bash -l

همچنین می‌توانید از متغیرهای محیطی برای مشخص کردن مدیر کانتینر و نام کانتینر استفاده کنید:

DBX_CONTAINER_MANAGER="docker" DBX_CONTAINER_NAME=test-alpine distrobox-enter

DBX_CONTAINER_NAME
DBX_CONTAINER_MANAGER
DBX_SKIP_WORKDIR
DBX_SUDO_PROGRAM

این دستور برای ورود به خود distrobox استفاده می‌شود. شخصاً، من صرفاً چندین نمایه (profile) در gnome-terminal خود ایجاد می‌کنم تا چندین توزیع در دسترس داشته باشم.

گزینهٔ --additional-flags یا -a برای تغییر دستور پیش‌فرض هنگام اجرا در کانتینر مفید است. برای مثال:

distrobox enter -n dev-arch --additional-flags "--env my_var=test" -- printenv &| grep my_var
my_var=test

این کار با استفاده از متغیرهای محیطی معمولی نیز امکان‌پذیر است:

my_var=test distrobox enter -n dev-arch --additional-flags -- printenv &| grep my_var
my_var=test

اگر مایلید وارد یک کانتینر با دسترسی ریشه (rootful) شوید و کاری کنید که distrobox از برنامه‌ای غیر از 'sudo' برای اجرای podman/docker/lilipod با دسترسی ریشه استفاده کند (مانند 'pkexec' یا 'doas')، می‌توانید آن را با متغیر محیطی DBX_SUDO_PROGRAM مشخص کنید. برای مثال، جهت استفاده از 'doas' برای ورود به یک کانتینر با دسترسی ریشه:

DBX_SUDO_PROGRAM="doas" distrobox enter -n container --root

علاوه بر این، در یکی از مسیرهای فایل پیکربندی که distrobox پشتیبانی می‌کند، مانند ~/.distroboxrc، می‌توانید خط distrobox_sudo_program="doas" را (برای مثال) اضافه کنید تا دستورات distrobox مربوط به کانتینرهای با دسترسی ریشه همیشه با استفاده از 'doas' اجرا شوند.

Mar 2026 Distrobox