.\
.\"
.TH "DISTROBOX\-EXPORT" "1" "Mar 2026" "Distrobox" "User Manual"
.SH "نام (NAME)"
distrobox\-export \- برون‌بری برنامه‌ها و فایل‌های باینری از کانتینر به سیستم میزبان
.SH "توضیحات (DESCRIPTION)"
\f[B]برون‌بری برنامه‌ها و فایل‌های باینری\f[R]
.PP
دستور distrobox\-export وظیفه برون‌بری یک برنامه کاربردی یا فایل باینری از کانتینر به سیستم میزبان را بر عهده دارد.
.PP
برنامه برون‌بری‌شده به‌راحتی در لانچر معمول شما در دسترس خواهد بود و به‌طور خودکار از داخل کانتینری که از آن صادر شده اجرا خواهد شد.
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]distrobox\-export\f[R]
.IP
.EX
\-\-app/\-a:       نام برنامه برای برون‌بری یا مسیر مطلق به فایل desktop. برای برون‌بری
\-\-bin/\-b:       مسیر مطلق فایل باینری برای برون‌بری
\-\-list\-apps:    فهرست کردن برنامه‌های صادرشده از این کانتینر
\-\-list\-binaries فهرست کردن باینری‌های صادرشده از این کانتینر؛ برای تعیین مسیرهای دلخواه جستجو از \-ep استفاده کنید
\-\-delete/\-d:    حذف برنامه یا باینری برون‌بری‌شده
\-\-export\-label/\-el: برچسب برای افزودن به نام برنامه صادرشده.
            برای غیرفعال‌سازی از \[dq]none\[dq] استفاده کنید.
            مقدار پیش‌فرض: (on \[rs]$container_name)
\-\-export\-path/\-ep:  مسیر مقصد برای برون‌بری باینری
\-\-extra\-flags/\-ef:  فلگ‌ها و گزینه‌های اضافی برای افزودن به دستور اجرا
\-\-enter\-flags/\-nf:  فلگ‌ها برای افزودن به distrobox\-enter
\-\-sudo/\-S:      مشخص کردن اینکه آیا مورد صادرشده باید با دسترسی sudo اجرا شود یا خیر
\-\-help/\-h:      نمایش این پیام راهنما
\-\-verbose/\-v:   نمایش جزئیات بیشتر
\-\-version/\-V:   نمایش نسخه
.EE
.PP
ممکن است بخواهید برنامه‌های گرافیکی یا ابزارهای خط فرمان را در distrobox خود نصب کنید.
استفاده از \f[CR]distrobox\-export\f[R] از \f[B]داخل\f[R] کانتینر به شما امکان می‌دهد از آن‌ها مستقیماً در خود سیستم میزبان استفاده کنید.
.SH "مثال‌ها (EXAMPLES)"
.IP
.EX
distrobox\-export \-\-app mpv [\-\-extra\-flags \[dq]flags\[dq]] [\-\-delete] [\-\-sudo]
distrobox\-export \-\-bin /path/to/bin [\-\-export\-path \[ti]/.local/bin] [\-\-extra\-flags \[dq]flags\[dq]] [\-\-delete] [\-\-sudo]
.EE
.PP
\f[B]مثال برون‌بری برنامه\f[R]
.IP
.EX
distrobox\-export \-\-app abiword
.EE
.PP
این ابزار فایل‌های اصلی \f[CR].desktop\f[R] را به همراه آیکون‌های مورد نیاز کپی کرده، پیشوند
\f[CR]/usr/local/bin/distrobox\-enter \-n distrobox_name \-e ...\f[R] را به
دستورات اجرایی اضافه می‌کند و آن‌ها را در دایرکتوری خانگی شما ذخیره می‌کند تا مانند یک برنامه معمولی مستقیماً از سیستم میزبان قابل استفاده باشند.
.IP
.EX
distrobox\-export \-\-app /opt/application/my\-app.desktop
.EE
.PP
این کار از جستجوی فایل desktop در مسیرهای استاندارد صرف‌نظر کرده و مستقیماً از مسیر فایل ارائه‌شده استفاده می‌کند.
.PP
\f[B]مثال برون‌بری فایل باینری\f[R]
.IP
.EX
distrobox\-export \-\-bin /usr/bin/code \-\-extra\-flags \[dq]\-\-foreground\[dq] \-\-export\-path $HOME/.local/bin
.EE
.PP
در صورت برون‌بری باینری‌ها، باید مشخص کنید که در \f[B]کجا\f[R] صادر شوند (\f[CR]\-\-export\-path\f[R]) و این ابزار یک اسکریپت پوششی کوچک ایجاد می‌کند که باینری مورد نظر را با دستور
\f[CR]distrobox\-enter \-e\f[R] از سیستم میزبان اجرا خواهد کرد.
این قابلیت می‌تواند به همراه \f[CR]direnv\f[R] برای داشتن نسخه‌های مختلفی از یک باینری بر اساس \f[CR]env\f[R] یا پروژه شما بسیار کاربردی باشد.
.PP
باینری‌های صادرشده در مسیر انتخابی با گزینه
\[lq]\[en]export\-path\[rq] به عنوان یک اسکریپت پوششی قرار می‌گیرند که هم در میزبان و هم در کانتینر عملکردی کاملاً طبیعی دارد.
.PP
\f[B]فلگ‌های اضافی\f[R]
.PP
می‌توانید گزینه‌ها و فلگ‌های اضافی را برای افزودن به دستور مشخص کنید؛ برای مثال اگر می‌خواهید یک برنامه الکترون را صادر کنید، می‌توانید فلگ
\[lq]\[en]foreground\[rq] را به دستور بیفزایید:
.IP
.EX
distrobox\-export \-\-app atom \-\-extra\-flags \[dq]\-\-foreground\[dq]
distrobox\-export \-\-bin /usr/bin/vim \-\-export\-path \[ti]/.local/bin \-\-extra\-flags \[dq]\-p\[dq]
.EE
.PP
این قابلیت هم برای باینری‌ها و هم برای برنامه‌ها کار می‌کند.
فلگ‌های اضافی فقط زمانی استفاده می‌شوند که برنامه یا باینری برون‌بری‌شده از سیستم میزبان فراخوانی شود؛ اجرای آن‌ها در داخل کانتینر این فلگ‌ها را شامل نخواهد شد.
.PP
\f[B]لغو برون‌بری (Unexport)\f[R]
.PP
گزینه \[lq]\[en]delete\[rq] یک برنامه یا باینری را از حالت برون‌بری خارج (حذف) می‌کند.
.IP
.EX
distrobox\-export \-\-app atom \-\-delete
distrobox\-export \-\-bin /usr/bin/vim \-\-export\-path \[ti]/.local/bin \-\-delete
.EE
.PP
\f[B]اجرا با دسترسی ریشه (root) در کانتینر\f[R]
.PP
گزینه \[lq]\[en]sudo\[rq] مورد صادرشده را با دسترسی root در داخل کانتینر distrobox اجرا می‌کند.
.PP
\f[B]نکات\f[R]
.PP
توجه داشته باشید که می‌توانید از \[en]app یا \[en]bin استفاده کنید اما استفاده همزمان از هر دو مجاز نیست.
[IMAGE: \c
.UR https://user-images.githubusercontent.com/598882/144294795-c7785620-bf68-4d1b-b251-1e1f0a32a08d.png
app\-export
.UE \c
]
app\-export
.PP
نکته: برخی از برنامه‌های الکترون مانند vscode و atom برای کارکرد صحیح از داخل کانتینر به فلگ‌های اضافی نیاز دارند؛ از گزینه \f[CR]\-\-extra\-flags\f[R] برای ارائه مجموعه‌ای از فلگ‌ها استفاده کنید، برای مثال:
.PP
\f[CR]distrobox\-export \-\-app atom \-\-extra\-flags \[dq]\-\-foreground\[dq]\f[R]