'\" t .\" Title: flatpak .\" Author: Alexander Larsson .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 08/27/2026 .\" Manual: flatpak .\" Source: flatpak .\" Language: Persian .\" .TH "FLATPAK" "1" "" "flatpak" "flatpak" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" flatpak \- ابزار استقرار، مدیریت و اجرای برنامه‌های کاربردی .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBflatpak\fR\ 'u \fBflatpak\fR [OPTION...] {COMMAND} .SH "توضیحات (DESCRIPTION)" .PP ابزار Flatpak ابزاری برای مدیریت برنامه‌های کاربردی و محیط‌های زمان اجرای (runtimes) مورد استفادهٔ آن‌ها است\&. در مدل Flatpak، برنامه‌ها می‌توانند مستقل از سیستم میزبانی که روی آن به کار می‌روند ساخته و توزیع شوند، و در زمان اجرا تا حدی از سیستم میزبان ایزوله («سندباکس») هستند\&. .PP ابزار Flatpak می‌تواند در حالت سراسری سیستم (system\-wide) یا به ازای هر کاربر (per\-user) کار کند\&. داده‌های سراسری سیستم (محیط‌های زمان اجرا، برنامه‌ها و پیکربندی) در مسیر $prefix/var/lib/flatpak/ و داده‌های به ازای هر کاربر در مسیر $HOME/\&.local/share/flatpak/ قرار دارند\&. زیر این مسیرها، یک مخزن محلی در زیرپوشهٔ repo/ وجود دارد و محیط‌های زمان اجرا و برنامه‌های نصب‌شده در زیرپوشه‌های متناظر runtime/ و app/ قرار می‌گیرند\&. .PP ریموت‌های سراسری سیستم را می‌توان با قرار دادن فایل‌های \fBflatpakrepo\fR(5) در مسیرهای /usr/share/flatpak/remotes\&.d/ و /etc/flatpak/remotes\&.d/ به صورت ایستا از پیش پیکربندی کرد\&. در صورتی که فایلی با نام یکسان در هر دو مسیر موجود باشد، فایل موجود در /etc اولویت خواهد داشت\&. .PP علاوه بر نصب سراسری سیستم در مسیر $prefix/var/lib/flatpak/، که همواره نصب پیش‌فرض در نظر گرفته می‌شود مگر اینکه بازنویسی شود، می‌توان مکان‌های نصب سراسری بیشتری را از طریق فایل‌های پیکربندی در /etc/flatpak/installations\&.d/ تعریف کرد، که باید دست‌کم شناسهٔ مکان نصب و مسیر مطلق آن را مشخص کنند\&. سایر پارامترهای اختیاری مانند DisplayName، Priority یا StorageType نیز پشتیبانی می‌شوند\&. .PP ابزار Flatpak از OSTree برای توزیع و استقرار داده‌ها استفاده می‌کند\&. مخازنی که استفاده می‌کند مخازن OSTree هستند و می‌توان با ابزار \fBostree\fR آن‌ها را دستکاری و مدیریت کرد\&. محیط‌های زمان اجرا و برنامه‌های نصب‌شده در واقع چک‌اوت‌های (checkouts) OSTree هستند\&. .PP دستورهای پایه‌ای برای ساخت فلت‌پک‌ها مانند build\-init، build و build\-finish در ابزار flatpak گنجانده شده‌اند\&. برای پشتیبانی ساخت در سطح بالاتر، ابزار مجزای \fBflatpak-builder\fR(1) را ببینید\&. .PP ابزار Flatpak از نصب از طریق مخازن بارگذاری جانبی (sideload repos) پشتیبانی می‌کند\&. این‌ها رونوشت‌های جزئی از یک مخزن هستند (تولیدشده توسط \fBflatpak create\-usb\fR) که در حالت آفلاین (و آنلاین برای بهبود کارایی) به عنوان منبع نصب استفاده می‌شوند\&. این مخازن با ایجاد پیوندهای نمادین (symlinks) به منابع بارگذاری جانبی در زیرپوشهٔ sideload\-repos در دایرکتوری نصب (به‌طور معمول /var/lib/flatpak/sideload\-repos یا ~/\&.local/share/flatpak/sideload\-repos) پیکربندی می‌شوند\&. علاوه بر این، پیوندهای نمادین را می‌توان در /run/flatpak/sideload\-repos ایجاد کرد که مکان بهتری برای منابع غیردائمی است (زیرا با راه‌اندازی مجدد سیستم پاک می‌شود)\&. این پیوندهای نمادین می‌توانند به دایرکتوری داده‌شده به \fBflatpak create\-usb\fR که به‌طور پیش‌فرض در زیرمسیر \&.ostree/repo می‌نویسد، یا مستقیماً به یک مخزن ostree اشاره کنند\&. .SH "گزینه‌ها (OPTIONS)" .PP گزینه‌های عمومی زیر شناخته می‌شوند\&. دستورهای تکی گزینه‌های مخصوص به خود را دارند\&. .PP \fB\-h\fR, \fB\-\-help\fR .RS 4 نمایش گزینه‌های راهنما و خروج\&. .RE .PP \fB\-v\fR, \fB\-\-verbose\fR .RS 4 نمایش اطلاعات اشکال‌زدایی هنگام پردازش دستور\&. برای جزئیات بیشتر از \-vv استفاده کنید\&. .RE .PP \fB\-\-ostree\-verbose\fR .RS 4 نمایش اطلاعات اشکال‌زدایی OSTree هنگام پردازش دستور\&. .RE .PP \fB\-\-version\fR .RS 4 چاپ اطلاعات نسخه و خروج\&. .RE .PP \fB\-\-default\-arch\fR .RS 4 چاپ معماری پیش‌فرض و خروج\&. .RE .PP \fB\-\-supported\-arches\fR .RS 4 چاپ معماری‌های پشتیبانی‌شده به ترتیب اولویت و خروج\&. .RE .PP \fB\-\-gl\-drivers\fR .RS 4 چاپ فهرست درایورهای فعال gl و خروج\&. .RE .PP \fB\-\-installations\fR .RS 4 چاپ مسیرهای مکان‌های نصب سیستم و خروج\&. .RE .PP \fB\-\-print\-system\-only\fR .RS 4 هنگامی که دستور \fBflatpak \-\-print\-updated\-env\fR اجرا می‌شود، تنها متغیرهای محیطی مربوط به مکان‌های نصب فلت‌پک سیستم چاپ شود و نصب خانگی کاربر در نظر گرفته نشود\&. .RE .PP \fB\-\-print\-updated\-env\fR .RS 4 مجموعه متغیرهای محیطی مورد نیاز برای استفاده از فلت‌پک‌ها را با اصلاح مجموعهٔ فعلی متغیرهای محیطی چاپ می‌کند\&. این گزینه برای استفاده در تولیدکننده محیط (environment generator) سیستم systemd در نظر گرفته شده و نیازی به اجرای دستی آن نیست\&. .RE .SH "دستورها (COMMANDS)" .PP دستورهای مربوط به مدیریت برنامه‌ها و محیط‌های زمان اجرای نصب‌شده: .PP \fBflatpak-install\fR(1) .RS 4 نصب یک برنامه یا محیط زمان اجرا از یک ریموت یا بسته (bundle)\&. .RE .PP \fBflatpak-update\fR(1) .RS 4 به‌روزرسانی یک برنامه یا محیط زمان اجرای نصب‌شده\&. .RE .PP \fBflatpak-uninstall\fR(1) .RS 4 حذف نصب یک برنامه یا محیط زمان اجرای نصب‌شده\&. .RE .PP \fBflatpak-mask\fR(1) .RS 4 پوشاندن (mask) و جلوگیری از به‌روزرسانی‌ها و نصب خودکار\&. .RE .PP \fBflatpak-pin\fR(1) .RS 4 سنجاق کردن (pin) محیط‌های زمان اجرا برای جلوگیری از حذف خودکار\&. .RE .PP \fBflatpak-list\fR(1) .RS 4 فهرست کردن برنامه‌ها یا محیط‌های زمان اجرای نصب‌شده\&. .RE .PP \fBflatpak-info\fR(1) .RS 4 نمایش اطلاعات یک برنامه یا محیط زمان اجرای نصب‌شده\&. .RE .PP \fBflatpak-history\fR(1) .RS 4 نمایش تاریخچه\&. .RE .PP \fBflatpak-config\fR(1) .RS 4 مدیریت پیکربندی flatpak\&. .RE .PP \fBflatpak-repair\fR(1) .RS 4 تعمیر مکان نصب flatpak\&. .RE .PP \fBflatpak-create-usb\fR(1) .RS 4 رونوشت برنامه‌ها یا محیط‌های زمان اجرا روی حافظه‌های جداشدنی (removable media)\&. .RE .PP دستورهای مربوط به یافتن برنامه‌ها و محیط‌های زمان اجرا: .PP \fBflatpak-search\fR(1) .RS 4 جستجو برای برنامه‌ها و محیط‌های زمان اجرا\&. .RE .PP دستورهای مربوط به مدیریت برنامه‌های در حال اجرا: .PP \fBflatpak-run\fR(1) .RS 4 اجرای یک برنامه\&. .RE .PP \fBflatpak-kill\fR(1) .RS 4 متوقف کردن یک برنامهٔ در حال اجرا\&. .RE .PP \fBflatpak-override\fR(1) .RS 4 بازنویسی دسترسی‌های یک برنامه\&. .RE .PP \fBflatpak-make-current\fR(1) .RS 4 مشخص کردن نسخهٔ پیش‌فرض برای اجرا\&. .RE .PP \fBflatpak-enter\fR(1) .RS 4 ورود به فضای نام (namespace) یک برنامهٔ در حال اجرا\&. .RE .PP دستورهای مربوط به مدیریت دسترسی به فایل‌ها: .PP \fBflatpak-document-export\fR(1) .RS 4 اعطای دسترسی به یک فایل خاص به یک برنامه\&. .RE .PP \fBflatpak-document-unexport\fR(1) .RS 4 لغو دسترسی به یک فایل خاص\&. .RE .PP \fBflatpak-document-info\fR(1) .RS 4 نمایش اطلاعات دربارهٔ یک فایل خاص\&. .RE .PP \fBflatpak-documents\fR(1) .RS 4 فهرست کردن فایل‌های صادرشده (به‌اشتراک‌گذاشته‌شده)\&. .RE .PP دستورهای مربوط به مدیریت مخزن پویا دسترسی‌ها (dynamic permission store): .PP \fBflatpak-permission-remove\fR(1) .RS 4 حذف مورد از مخزن دسترسی‌ها\&. .RE .PP \fBflatpak-permissions\fR(1) .RS 4 فهرست کردن دسترسی‌ها\&. .RE .PP \fBflatpak-permission-show\fR(1) .RS 4 نمایش دسترسی‌های برنامه\&. .RE .PP \fBflatpak-permission-reset\fR(1) .RS 4 بازنشانی دسترسی‌های برنامه\&. .RE .PP \fBflatpak-permission-set\fR(1) .RS 4 تنظیم دسترسی‌های برنامه\&. .RE .PP دستورهای مربوط به مدیریت مخازن ریموت: .PP \fBflatpak-remotes\fR(1) .RS 4 فهرست کردن تمام مخازن ریموت پیکربندی‌شده\&. .RE .PP \fBflatpak-remote-add\fR(1) .RS 4 افزودن یک مخزن ریموت جدید\&. .RE .PP \fBflatpak-remote-modify\fR(1) .RS 4 تغییر ویژگی‌های یک مخزن ریموت پیکربندی‌شده\&. .RE .PP \fBflatpak-remote-delete\fR(1) .RS 4 حذف یک مخزن ریموت پیکربندی‌شده\&. .RE .PP \fBflatpak-remote-ls\fR(1) .RS 4 فهرست کردن محتویات یک مخزن ریموت پیکربندی‌شده\&. .RE .PP \fBflatpak-remote-info\fR(1) .RS 4 نمایش اطلاعات دربارهٔ یک مرجع (ref) در یک مخزن ریموت پیکربندی‌شده\&. .RE .PP دستورهای مربوط به ساخت برنامه‌ها: .PP \fBflatpak-build-init\fR(1) .RS 4 راه‌اندازی اولیه یک دایرکتوری ساخت\&. .RE .PP \fBflatpak-build\fR(1) .RS 4 اجرای دستور ساخت در یک دایرکتوری ساخت\&. .RE .PP \fBflatpak-build-finish\fR(1) .RS 4 نهایی‌سازی یک دایرکتوری ساخت برای صدور (export)\&. .RE .PP \fBflatpak-build-export\fR(1) .RS 4 صدور یک دایرکتوری ساخت به یک مخزن\&. .RE .PP \fBflatpak-build-bundle\fR(1) .RS 4 ایجاد یک فایل بسته (bundle) از یک مرجع در یک مخزن محلی\&. .RE .PP \fBflatpak-build-import-bundle\fR(1) .RS 4 وارد کردن یک فایل بسته به یک مخزن محلی\&. .RE .PP \fBflatpak-build-sign\fR(1) .RS 4 امضای یک برنامه یا محیط زمان اجرا پس از صدور آن\&. .RE .PP \fBflatpak-build-update-repo\fR(1) .RS 4 به‌روزرسانی فایل خلاصه (summary) در یک مخزن\&. .RE .PP \fBflatpak-build-commit-from\fR(1) .RS 4 ایجاد یک کامیت جدید بر اساس یک مرجع (ref) موجود\&. .RE .PP \fBflatpak-repo\fR(1) .RS 4 چاپ اطلاعات دربارهٔ یک مخزن\&. .RE .PP دستورهای موجود درون سندباکس: .PP \fBflatpak-spawn\fR(1) .RS 4 اجرای یک دستور در یک سندباکس دیگر\&. .RE .SH "قالب‌های فایل (FILE FORMATS)" .PP قالب‌های فایلی که توسط دستورهای Flatpak استفاده می‌شوند: .PP \fBflatpakref\fR(5) .RS 4 ارجاع به یک ریموت برای یک برنامه یا محیط زمان اجرا .RE .PP \fBflatpakrepo\fR(5) .RS 4 ارجاع به یک ریموت .RE .PP \fBflatpak-remote\fR(5) .RS 4 پیکربندی برای یک ریموت .RE .PP \fBflatpak-installation\fR(5) .RS 4 پیکربندی برای یک مکان نصب .RE .PP \fBflatpak-metadata\fR(5) .RS 4 اطلاعات دربارهٔ یک برنامه یا محیط زمان اجرا .RE .SH "محیط (ENVIRONMENT)" .PP علاوه بر متغیرهای محیطی استاندارد مانند \fBXDG_DATA_DIRS\fR و \fBXDG_DATA_HOME\fR، ابزار flatpak متغیرهای اختصاصی خود را نیز بررسی می‌کند\&. .PP \fBFLATPAK_BINARY\fR .RS 4 مسیر فایل اجرایی flatpak که هنگام نصب یک برنامه در فایل‌های \&.desktop و اسکریپت‌های صادرشده نوشته می‌شود\&. مقدار پیش‌فرض /usr/bin/flatpak است، مگر اینکه هنگام ساخت با \fB\-\-bindir\fR بازنویسی شده باشد\&. .RE .PP \fBFLATPAK_BWRAP\fR .RS 4 مسیر فایل اجرایی \fBbwrap\fR(1) که برای ساخت سندباکس استفاده خواهد شد\&. بسته به نحوهٔ پیکربندی Flatpak در زمان ساخت، مقدار پیش‌فرض یا جستجو در \fBPATH\fR است یا استفاده از یک نسخهٔ داخلی (vendored) که معمولاً به صورت /usr/libexec/flatpak\-bwrap نصب می‌شود\&. .RE .PP \fBFLATPAK_CONFIG_DIR\fR .RS 4 مکان پیکربندی سایت flatpak\&. در صورت عدم تنظیم، از /etc/flatpak استفاده می‌شود (مگر اینکه در زمان ساخت توسط \-\-sysconfdir بازنویسی شده باشد)\&. .RE .PP \fBFLATPAK_DATA_DIR\fR .RS 4 مکان پیش‌فرض‌های سطح سیستم‌عامل و قلاب‌های یکپارچه‌سازی Flatpak\&. در صورت عدم تنظیم، از /usr/share/flatpak استفاده می‌شود، مگر اینکه در زمان ساخت توسط \fB\-\-datadir\fR بازنویسی شده باشد\&. .RE .PP \fBFLATPAK_DBUSPROXY\fR .RS 4 مسیر فایل اجرایی \fBxdg-dbus-proxy\fR(1) که برای فیلتر کردن ترافیک D\-Bus بین سندباکس و سیستم میزبان استفاده خواهد شد\&. بسته به چگونگی پیکربندی Flatpak در زمان ساخت، حالت پیش‌فرض یا جستجو در \fBPATH\fR است یا استفاده از یک نسخهٔ داخلی (vendored) که معمولاً به صورت /usr/libexec/flatpak\-dbus\-proxy نصب می‌شود\&. .RE .PP \fBFLATPAK_DOWNLOAD_TMPDIR\fR .RS 4 مسیر دایرکتوری‌ای که هنگام دریافت لایه‌های OCI و احتمالاً سایر بارگیری‌ها در آینده به طور موقت استفاده می‌شود\&. متغیر استاندارد \fBTMPDIR\fR برای این کار استفاده نمی‌شود، زیرا برنامه‌های Flatpak اغلب برای قرارگیری در یک tmpfs بسیار بزرگ هستند\&. .RE .PP \fBFLATPAK_FANCY_OUTPUT\fR .RS 4 می‌تواند روی 0 تنظیم شود تا از قالب‌بندی تزئینی خروجی ترمینال جلوگیری شود\&. این ویژگی همچنین زمانی که خروجی استاندارد یک ترمینال نباشد یا \fBG_MESSAGES_DEBUG\fR تنظیم شده باشد، به صورت خودکار غیرفعال می‌شود\&. .RE .PP \fBFLATPAK_FORCE_TEXT_AUTH\fR .RS 4 می‌تواند روی 1 تنظیم شود تا در صورت نیاز به احراز هویت برای تغییر در مکان نصب سراسری سیستم، استفاده از یک عامل متنی ساده و توکار \fBpolkit\fR(8) اجباری شود\&. به‌طور پیش‌فرض، در صورت وجود، از عامل polkit محیط رومیزی استفاده می‌شود که معمولاً به یک اعلان گرافیکی منجر می‌شود\&. .RE .PP \fBFLATPAK_GL_DRIVERS\fR .RS 4 فهرستی جداشده با دونقطه از افزونه‌های درایور گرافیک برای تلاش جهت استفاده در OpenGL، Vulkan و واسط‌های برنامه‌نویسی مشابه، با اولویت از بالاترین به پایین‌ترین\&. مقدار پیش‌فرض، انتخاب خودکار درایور گرافیک است\&. مقادیر این فهرست با آخرین جزء جداشده با نقطه در نام افزونه‌های دارای شرط active\-gl\-driver مطابقت دارند\&. مقادیر متداول عبارتند از default، mesa\-git یا nvidia\-550\-120 (جایگزین کردن شماره نسخه با نسخهٔ اصلی و فرعی ماژول هستهٔ nvidia)\&. .RE .PP \fBFLATPAK_RUN_DIR\fR .RS 4 مکان فایل‌های سراسری زمان اجرای flatpak\&. در صورت عدم تنظیم، از /run/flatpak استفاده می‌شود\&. .RE .PP \fBFLATPAK_SYSTEM_CACHE_DIR\fR .RS 4 مکانی که در طول دریافت (pull) در مکان نصب سراسری سیستم، مخازن موقت فرزند در آن ایجاد می‌شوند\&. در صورت عدم تنظیم، دایرکتوری‌ای در /var/tmp/ استفاده می‌شود\&. این ویژگی از آنجا سودمند است که احتمال بیشتری دارد روی همان سیستم‌فایل مخزن سیستم باشد (بنابراین احتمال مواردی مانند کپی‌برداری به روش reflink را افزایش می‌دهد) و می‌توان از پر شدن دایرکتوری خانگی کاربر با داده‌های موقت جلوگیری کرد\&. .RE .PP \fBFLATPAK_SYSTEM_DIR\fR .RS 4 مکان نصب پیش‌فرض سراسری سیستم\&. در صورت عدم تنظیم، از /var/lib/flatpak استفاده می‌شود (مگر اینکه در زمان ساخت توسط \fB\-\-localstatedir\fR یا \fB\-Dsystem_install_dir\fR بازنویسی شده باشد)\&. .RE .PP \fBFLATPAK_TTY_PROGRESS\fR .RS 4 می‌تواند روی 0 تنظیم شود تا گزارش پیشرفت قابل‌خواندن توسط ماشین در ترمینال غیرفعال گردد\&. این ویژگی را می‌توان غیرفعال کرد زیرا از توالی OSC 9;4 استفاده می‌کند که برخی از شبیه‌سازهای ترمینال آن را به عنوان یک اعلان جهنده (popup) تفسیر می‌کنند\&. .RE .PP \fBFLATPAK_USER_DIR\fR .RS 4 مکان نصب به ازای هر کاربر\&. در صورت عدم تنظیم، از $XDG_DATA_HOME/flatpak استفاده می‌شود\&. .RE .SH "همچنین ببینید (SEE ALSO)" .PP \fBostree\fR(1), \fBostree.repo\fR(5), \fBflatpak-remote\fR(5), \fBflatpak-installation\fR(5), \m[blue]\fBhttps://www\&.flatpak\&.org\fR\m[]