'\" t
.\
.\"
.TH "DISTROBOX\-ASSEMBLE" "1" "Mar 2026" "Distrobox" "User Manual"
.SH "نام (NAME)"
distrobox\-assemble \- ایجاد یا نابودسازی دسته‌ای کانتینرها بر اساس یک فایل مانیفست
.SH "توضیحات (DESCRIPTION)"
دستور distrobox\-assemble وظیفه ایجاد یا نابودسازی دسته‌ای کانتینرها را بر اساس یک فایل مانیفست بر عهده دارد.
فایل مانیفست به‌طور پیش‌فرض \f[CR]./distrobox.ini\f[R] است، اما می‌توان آن را با استفاده از گزینه \f[CR]\-\-file\f[R] مشخص کرد.
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]distrobox assemble\f[R]
.IP
.EX
\-\-file:         مسیر یا نشانی اینترنتی (URL) به فایل مانیفست/ini توزیع‌باکس
\-\-name/\-n:      اجرا فقط برای یک ورودی خاص در فایل مانیفست/ini
\-\-replace/\-R:   جایگزینی distroboxهای از قبل موجود با نام‌های همسان
\-\-dry\-run/\-d:   صرفاً چاپ دستور تولیدشده برای مدیر کانتینر بدون اجرای آن
\-\-verbose/\-v:   نمایش جزئیات بیشتر
\-\-version/\-V:   نمایش نسخه
.EE
.SH "مثال‌ها (EXAMPLES)"
این یک نمونه فایل مانیفست برای ایجاد دو کانتینر است:
.IP
.EX
[ubuntu]
additional_packages=\[dq]git vim tmux nodejs\[dq]
image=ubuntu:latest
init=false
nvidia=false
pull=true
root=false
replace=true
start_now=false

# You can add comments using this #
[arch] # also inline comments are supported
additional_packages=\[dq]git vim tmux nodejs\[dq]
home=/tmp/home
image=archlinux:latest
init=false
start_now=true
init_hooks=\[dq]touch /init\-normal\[dq]
nvidia=true
pre_init_hooks=\[dq]touch /pre\-init\[dq]
pull=true
root=false
replace=false
volume=\[dq]/tmp/test:/run/a /tmp/test:/run/b\[dq]
.EE
.PP
\f[B]ایجاد (Create)\f[R]
.PP
می‌توانیم آن‌ها را به سادگی با دستور زیر بالا بیاوریم:
.IP
.EX
distrobox assemble create
.EE
.PP
اگر نام فایل \f[CR]distrobox.ini\f[R] باشد و در همان دایرکتوری که دستور را اجرا می‌کنید قرار داشته باشد، به هیچ آرگومان دیگری نیاز نیست.
می‌توانید با استفاده از دستور زیر یک مسیر سفارشی برای فایل مشخص کنید:
.IP
.EX
distrobox assemble create \-\-file /my/custom/path.ini
.EE
.PP
یا حتی با استفاده از یک نشانی اینترنتی (URL)، یک فایل راه دور را مشخص کنید:
.IP
.EX
distrobox\-assemble create \-\-file https://raw.githubusercontent.com/89luca89/dotfiles/master/distrobox.ini
.EE
.PP
\f[B]جایگزینی (Replace)\f[R]
.PP
به‌طور پیش‌فرض، \f[CR]distrobox assemble\f[R] یک کانتینر را تنها در صورتی جایگزین می‌کند که \f[CR]replace=true\f[R] در فایل مانیفست مشخص شده باشد.
.PP
در مثال مانیفست بالا، کانتینر ubuntu هنگام اجرای \f[CR]distrobox assemble create\f[R] همواره جایگزین خواهد شد، در حالی که کانتینر arch جایگزین نمی‌شود.
.PP
برای اجبار در جایگزینی تمام کانتینرهای موجود در یک مانیفست، از گزینه \f[CR]\-\-replace\f[R] استفاده کنید:
.IP
.EX
distrobox assemble create \-\-replace [\-\-file my/custom/path.ini]
.EE
.PP
\f[B]حذف (Remove)\f[R]
.PP
می‌توانیم تمام کانتینرهای تعریف‌شده در یک فایل مانیفست را با اجرای ساده دستور زیر متوقف و حذف کنیم:
.IP
.EX
distrobox assemble rm
.EE
.PP
یا با استفاده از یک مسیر سفارشی برای فایل ini:
.IP
.EX
distrobox assemble rm \-\-file my/custom/path.ini
.EE
.PP
\f[B]آزمایش (Test)\f[R]
.PP
همواره می‌توانید با استفاده از گزینه \f[CR]\-\-dry\-run\f[R] بررسی کنید که distrobox \f[B]چه کاری انجام خواهد داد\f[R].
این دستور تنها دستوراتی را که distrobox اجرا خواهد کرد نمایش می‌دهد، بدون اینکه واقعاً آن‌ها را اجرا کند.
.PP
\f[B]شبیه‌سازی (Clone)\f[R]
.PP
\f[B]سلب مسئولیت\f[R]: برای اطمینان از مقداردهی اولیه کامل و ساخته شدن کانتینر پیش از کلون کردن، باید یک بار آن را راه‌اندازی کنید.
همچنین کانتینری که کپی می‌شود باید پیش از ادامه فرایند کلون کردن، متوقف شده باشد.
.PP
\f[B]گزینه‌های موجود (Available options)\f[R]
.PP
فهرست گزینه‌های موجود همراه با نوع متناظر آن‌ها به شرح زیر است:
.PP
راهنمای انواع داده:
.IP \[bu] 2
bool: مقدار بولی، true یا false
.IP \[bu] 2
string: یک رشته متنی منفرد؛ به عنوان مثال:
\f[CR]home=\[dq]/home/luca\-linux/dbox\[dq]\f[R]
.IP \[bu] 2
string_list: چندین رشته متنی؛ به عنوان مثال:
\f[CR]additional_packages=\[dq]htop vim git\[dq]\f[R].
توجه داشته باشید که \f[CR]string_list\f[R] را می‌توان چندین بار تعریف کرد تا مقادیر با یکدیگر ترکیب شوند:
.RS 2
.IP
.EX
\f[B][ubuntu]\f[R]
image=ubuntu:latest
additional_packages=\[dq]git vim tmux nodejs\[dq]
additional_packages=\[dq]htop iftop iotop\[dq]
additional_packages=\[dq]zsh fish\[dq]
.EE
.RE
.PP
.TS
tab(@);
lw(23.3n) lw(23.3n) lw(23.3n).
T{
نام گزینه
T}@T{
نوع
T}@T{
توضیحات
T}
_
T{
additional_flags
T}@T{
string_list
T}@T{
گزینه‌ها و فلگ‌های اضافی برای ارسال به مدیر کانتینر
T}
T{
additional_packages
T}@T{
string_list
T}@T{
بسته‌های اضافی برای نصب درون کانتینر
T}
T{
home
T}@T{
string
T}@T{
تعیین دایرکتوری خانگی (home) مورد استفاده کانتینر
T}
T{
hostname
T}@T{
string
T}@T{
تنظیم نام میزبان (hostname) برای کانتینر
T}
T{
image
T}@T{
string
T}@T{
تعیین ایمیج مورد استفاده کانتینر؛ برای مشاهده فهرست، به مستندات ایمیج‌ها مراجعه کنید
T}
T{
clone
T}@T{
string
T}@T{
نام کانتینر Distrobox که به‌عنوان پایه برای کانتینر جدید استفاده می‌شود (کانتینر باید متوقف باشد).
T}
T{
include
T}@T{
string
T}@T{
نام ورودی در مانیفست که باید در تعریف جاری گنجانده شود.
T}
T{
init_hooks
T}@T{
string_list
T}@T{
دستوراتی که پس از راه‌اندازی بسته‌ها، درون کانتینر اجرا می‌شوند
T}
T{
pre_init_hooks
T}@T{
string_list
T}@T{
دستوراتی که پیش از راه‌اندازی بسته‌ها، درون کانتینر اجرا می‌شوند
T}
T{
volume
T}@T{
string_list
T}@T{
فضاهای ذخیره‌سازی (volume) اضافی برای متصل کردن (mount) درون کانتینرها
T}
T{
exported_apps
T}@T{
string_list
T}@T{
نام برنامه‌ها یا مسیر فایل‌های desktop برای برون‌بری (export)
T}
T{
exported_bins
T}@T{
string_list
T}@T{
فایل‌های باینری برای برون‌بری (export)
T}
T{
exported_bins_path
T}@T{
string
T}@T{
مسیر اختیاری برای برون‌بری باینری‌ها (پیش‌فرض: $HOME/.local/bin)
T}
T{
entry
T}@T{
bool
T}@T{
ایجاد یک مدخل برای کانتینر در فهرست برنامه‌ها (پیش‌فرض: false)
T}
T{
start_now
T}@T{
bool
T}@T{
راه‌اندازی فوری کانتینر (پیش‌فرض: false)
T}
T{
init
T}@T{
bool
T}@T{
مشخص می‌کند که آیا این کانتینر دارای سیستم init است یا خیر (پیش‌فرض: false)
T}
T{
nvidia
T}@T{
bool
T}@T{
مشخص می‌کند که آیا مایل به فعال‌سازی یکپارچه‌سازی با درایورهای NVidia هستید (پیش‌فرض: false)
T}
T{
pull
T}@T{
bool
T}@T{
مشخص می‌کند که آیا می‌خواهید ایمیج در هر بار اجرا دریافت (pull) شود (پیش‌فرض: false)
T}
T{
root
T}@T{
bool
T}@T{
مشخص می‌کند که آیا کانتینر با دسترسی ریشه (rootful) باشد یا خیر (پیش‌فرض: false)
T}
T{
unshare_groups
T}@T{
bool
T}@T{
مشخص می‌کند که آیا گروه‌های کاربری اضافی برای کانتینر تفکیک (unshare) شوند (پیش‌فرض: false)
T}
T{
unshare_ipc
T}@T{
bool
T}@T{
مشخص می‌کند که آیا فضای نام ipc برای کانتینر تفکیک (unshare) شود (پیش‌فرض: false)
T}
T{
unshare_netns
T}@T{
bool
T}@T{
مشخص می‌کند که آیا فضای نام شبکه (network namespace) برای کانتینر تفکیک (unshare) شود (پیش‌فرض: false)
T}
T{
unshare_process
T}@T{
bool
T}@T{
مشخص می‌کند که آیا فضای نام فرایندها (pid namespace) برای کانتینر تفکیک (unshare) شود (پیش‌فرض: false)
T}
T{
unshare_devsys
T}@T{
bool
T}@T{
مشخص می‌کند که آیا دایرکتوری /dev برای کانتینر تفکیک (unshare) شود (پیش‌فرض: false)
T}
T{
unshare_all
T}@T{
bool
T}@T{
مشخص می‌کند که آیا تمام گزینه‌های تفکیک (unshare) پیشین برای کانتینر فعال شوند (پیش‌فرض: false)
T}
.TE
.PP
گزینه \f[CR]include\f[R] ویژگی‌های یک تعریف را در تعریفی دیگر کپی می‌کند.
استفاده از گنجاندن‌های بازگشتی (Recursive) مجاز است.
این گزینه روی فایل مانیفست عمل می‌کند و کانتینرهای \f[CR]distrobox\f[R] حاصل از آن هیچ‌گونه ارتباطی با یکدیگر نخواهند داشت.
لطفاً توجه داشته باشید که ویژگی‌های موجود در تعریف گنجاننده‌، ویژگی‌های تعریف گنجانده‌شده را بازنویسی یا پنهان نمی‌کنند، بلکه صرفاً تکرار می‌شوند.
.PP
برای توضیحات بیشتر درباره هر یک از گزینه‌های دیگر در این فهرست، به راهنمای دستور distrobox create نگاهی بیندازید؛ هر گزینه با یکی از گزینه‌های دستور \f[CR]create\f[R] مطابقت دارد.
.PP
\f[B]مثال پیشرفته (Advanced example)\f[R]
.IP
.EX
[tumbleweed_distrobox]
image=registry.opensuse.org/opensuse/distrobox
pull=true
additional_packages=\[dq]acpi bash\-completion findutils iproute iputils sensors inotify\-tools unzip\[dq]
additional_packages=\[dq]net\-tools nmap openssl procps psmisc rsync man tig tmux tree vim htop xclip yt\-dlp\[dq]
additional_packages=\[dq]git git\-credential\-libsecret\[dq]
additional_packages=\[dq]patterns\-devel\-base\-devel_basis\[dq]
additional_packages=\[dq]ShellCheck ansible\-lint clang clang\-tools codespell ctags desktop\-file\-utils gcc golang jq python3\[dq]
additional_packages=\[dq]python3\-bashate python3\-flake8 python3\-mypy python3\-pipx python3\-pycodestyle python3\-pyflakes python3\-pylint python3\-python\-lsp\-server python3\-rstcheck python3\-yapf python3\-yamllint rustup shfmt\[dq]
additional_packages=\[dq]kubernetes\-client helm\[dq]
init_hooks=GOPATH=\[dq]${HOME}/.local/share/system\-go\[dq] GOBIN=/usr/local/bin go install github.com/golangci/golangci\-lint/cmd/golangci\-lint\[at]latest;
init_hooks=GOPATH=\[dq]${HOME}/.local/share/system\-go\[dq] GOBIN=/usr/local/bin go install github.com/onsi/ginkgo/v2/ginkgo\[at]latest;
init_hooks=GOPATH=\[dq]${HOME}/.local/share/system\-go\[dq] GOBIN=/usr/local/bin go install golang.org/x/tools/cmd/goimports\[at]latest;
init_hooks=GOPATH=\[dq]${HOME}/.local/share/system\-go\[dq] GOBIN=/usr/local/bin go install golang.org/x/tools/gopls\[at]latest;
init_hooks=GOPATH=\[dq]${HOME}/.local/share/system\-go\[dq] GOBIN=/usr/local/bin go install sigs.k8s.io/kind\[at]latest;
init_hooks=ln \-sf /usr/bin/distrobox\-host\-exec /usr/local/bin/conmon;
init_hooks=ln \-sf /usr/bin/distrobox\-host\-exec /usr/local/bin/crun;
init_hooks=ln \-sf /usr/bin/distrobox\-host\-exec /usr/local/bin/docker;
init_hooks=ln \-sf /usr/bin/distrobox\-host\-exec /usr/local/bin/docker\-compose;
init_hooks=ln \-sf /usr/bin/distrobox\-host\-exec /usr/local/bin/flatpak;
init_hooks=ln \-sf /usr/bin/distrobox\-host\-exec /usr/local/bin/podman;
init_hooks=ln \-sf /usr/bin/distrobox\-host\-exec /usr/local/bin/xdg\-open;
exported_apps=\[dq]htop\[dq]
exported_bins=\[dq]/usr/bin/htop /usr/bin/git\[dq]
exported_bins_path=\[dq]\[ti]/.local/bin\[dq]
.EE
.PP
\f[B]مثال شبیه‌سازی (Clone example)\f[R]
.IP
.EX
[ubuntu]
additional_packages=\[dq]git vim tmux\[dq]
image=ubuntu:latest
init=false
nvidia=false
pull=true
root=false
replace=true
start_now=true

[deno_ubuntu]
clone=ubuntu
init=false
nvidia=false
pull=true
root=false
replace=true
start_now=true
pre_init_hooks=curl \-fsSL https://deno.land/install.sh | sh;

[bun_ubuntu]
clone=ubuntu
init=false
nvidia=false
pull=true
root=false
replace=true
start_now=true
pre_init_hooks=curl \-fsSL https://bun.sh/install | bash;
.EE
.PP
\f[B]مثال پوسته ورود سفارشی (Custom login shell example)\f[R]
.IP
.EX
[ubuntu]
image=ubuntu:latest
pre_init_hooks=\[dq]export SHELL=/bin/bash;\[dq]
.EE
.PP
\f[B]مثال گنجاندن (ارث‌بری فیلدها از یک distrobox دیگر)\f[R]
.IP
.EX
[ubuntu]
image=ubuntu:latest
additional_packages=\[dq]git vim tmux nodejs\[dq]
additional_packages=\[dq]htop iftop iotop\[dq]
additional_packages=\[dq]zsh fish\[dq]

[ubuntu\-nvidia]
include=ubuntu
nvidia=true
.EE