'\" t
.\"     Title: flatpak remote
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 08/27/2026
.\"    Manual: flatpak remote
.\"    Source: flatpak
.\"  Language: Persian
.\"
.TH "FLATPAK REMOTE" "5" "" "flatpak" "flatpak remote"
.\" -----------------------------------------------------------------
.\" * 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-remote \- پیکربندی یک ریموت (remote)
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار Flatpak اطلاعات مربوط به ریموت‌های پیکربندی‌شده برای یک مکان نصب را در
$installation/repo/config
ذخیره می‌کند\&. برای نمونه، ریموت‌های مربوط به نصب پیش‌فرض سراسری سیستم در
$prefix/var/lib/flatpak/repo/config
و ریموت‌های مربوط به نصب به ازای هر کاربر در
$HOME/\&.local/share/flatpak/repo/config
قرار دارند\&.
.PP
به طور معمول، ویرایش مستقیم فایل‌های پیکربندی ریموت ضروری نیست؛ برای تغییر ویژگی‌های ریموت‌ها باید از دستور
\fBflatpak remote\-modify\fR
استفاده شود\&.
.PP
ریموت‌های سراسری سیستم را می‌توان با قرار دادن فایل‌های
\fBflatpakrepo\fR(5)
در مسیرهای
/usr/share/flatpak/remotes\&.d/
و
/etc/flatpak/remotes\&.d/
به صورت ایستا از پیش پیکربندی کرد\&. در صورتی که فایلی با نام یکسان در هر دو مسیر موجود باشد، فایل موجود در
/etc
اولویت خواهد داشت\&.
.SH "قالب فایل (FILE FORMAT)"
.PP
قالب فایل پیکربندی ریموت از همان قالب فایل‌های \&.ini استفاده می‌کند که برای فایل‌های واحد systemd یا فایل‌های \&.desktop برنامه‌ها به کار می‌رود\&.
.SS "[remote \&...]"
.PP
تمام پیکربندی‌های مربوط به ریموتی با نام NAME در گروه [remote "NAME"] قرار می‌گیرد\&.
.PP
کلیدهای زیر، در میان موارد دیگر، توسط OSTree شناسایی می‌شوند:
.PP
\fBurl\fR (string)
.RS 4
آدرس url مربوط به ریموت\&. یک آدرس URL به شکل oci+https:// یا oci+http:// یک افزونهٔ Flatpak است که نشان می‌دهد ریموت یک مخزن ostree نیست، بلکه یک URL به نمایه‌ای از ایمیج‌های OCI ذخیره‌شده در یک رجیستری ایمیج کانتینر است\&.
.sp
برای ریموت‌های OCI، گواهی‌های کلاینت و CA همان‌گونه که در
\fBcontainers-certs.d\fR(5)
مستند شده است، از
/etc/containers/certs\&.d
و
~/\&.config/containers/certs\&.d
خوانده می‌شوند\&.
.RE
.PP
\fBgpg\-verify\fR (boolean)
.RS 4
مشخص می‌کند که آیا برای محتوای این ریموت از اعتبارسنجی GPG استفاده شود یا خیر\&.
.RE
.PP
\fBgpg\-verify\-summary\fR (boolean)
.RS 4
مشخص می‌کند که آیا برای فایل خلاصه (summary) این ریموت از اعتبارسنجی GPG استفاده شود یا خیر\&.
.sp
در صورتی که
\fBcollection\-id\fR
تنظیم شده باشد، این گزینه نادیده گرفته می‌شود، زیرا در آن حالت ارجاع‌ها (refs) در فراداده‌های کامیت اعتبارسنجی می‌شوند\&. فعال کردن
\fBgpg\-verify\-summary\fR
توزیع همتابه‌همتای (P2P) ارجاع‌ها را با مشکل مواجه خواهد کرد\&.
.RE
.PP
\fBcollection\-id\fR (string)
.RS 4
شناسهٔ یکتای سراسری برای مخزن بالادستی مجموعه، جهت امکان‌پذیر ساختن گروه‌بندی آینه‌ها (mirrors)\&.
.RE
.PP
تمام کلیدهای اختصاصی flatpak دارای پیشوند xa\&. هستند:
.PP
\fBxa\&.disable\fR (boolean)
.RS 4
مشخص می‌کند که آیا ریموت غیرفعال است یا خیر\&. مقدار پیش‌فرض false است\&.
.RE
.PP
\fBxa\&.prio\fR (integer)
.RS 4
اولویت ریموت\&. این مقدار هنگام فهرست کردن ریموت‌ها و هنگام جست‌وجو در آن‌ها برای یافتن زمان‌اجرای (runtime) مورد نیاز یک برنامه به کار می‌رود\&. ریموتی که برنامه را ارائه می‌دهد پیش از سایر ریموت‌های با اولویت یکسان برای یافتن زمان‌اجرا جست‌وجو می‌شود\&. مقدار پیش‌فرض 1 است\&.
.RE
.PP
\fBxa\&.noenumerate\fR (boolean)
.RS 4
مشخص می‌کند که آیا این ریموت هنگام ارائهٔ برنامه‌ها/زمان‌های اجرای موجود، یا هنگام جست‌وجو برای یک وابستگی زمان‌اجرا نادیده گرفته شود یا خیر\&. مقدار پیش‌فرض false است\&.
.RE
.PP
\fBxa\&.nodeps\fR (boolean)
.RS 4
مشخص می‌کند که آیا این ریموت هنگام جست‌وجو برای وابستگی‌ها کنار گذاشته شود یا خیر\&. مقدار پیش‌فرض false است\&.
.RE
.PP
\fBxa\&.title\fR (string)
.RS 4
یک عنوان اختیاری برای استفاده هنگام نمایش این ریموت در یک رابط کاربری (UI)\&.
.RE
.PP
\fBxa\&.title\-is\-set\fR (boolean)
.RS 4
این کلید در صورتی روی true تنظیم می‌شود که
\fBxa\&.title\fR
به صورت صریح تنظیم شده باشد\&.
.RE
.PP
\fBxa\&.comment\fR (string)
.RS 4
یک توضیح تک‌خطی اختیاری برای استفاده هنگام نمایش این ریموت در یک رابط کاربری\&.
.RE
.PP
\fBxa\&.comment\-is\-set\fR (boolean)
.RS 4
این کلید در صورتی روی true تنظیم می‌شود که
\fBxa\&.comment\fR
به صورت صریح تنظیم شده باشد\&.
.RE
.PP
\fBxa\&.description\fR (string)
.RS 4
یک پاراگراف متنی کامل و اختیاری برای استفاده هنگام نمایش این ریموت در یک رابط کاربری\&.
.RE
.PP
\fBxa\&.description\-is\-set\fR (boolean)
.RS 4
این کلید در صورتی روی true تنظیم می‌شود که
\fBxa\&.description\fR
به صورت صریح تنظیم شده باشد\&.
.RE
.PP
\fBxa\&.homepage\fR (string)
.RS 4
یک نشانی وب (URL) اختیاری که به وب‌سایت این مخزن اشاره می‌کند تا هنگام نمایش این ریموت در یک رابط کاربری استفاده شود\&.
.RE
.PP
\fBxa\&.homepage\-is\-set\fR (boolean)
.RS 4
این کلید در صورتی روی true تنظیم می‌شود که
\fBxa\&.homepage\fR
به صورت صریح تنظیم شده باشد\&.
.RE
.PP
\fBxa\&.icon\fR (string)
.RS 4
یک نشانی وب (URL) اختیاری که به یک آیکون برای این مخزن اشاره می‌کند تا هنگام نمایش این ریموت در یک رابط کاربری استفاده شود\&.
.RE
.PP
\fBxa\&.icon\-is\-set\fR (boolean)
.RS 4
این کلید در صورتی روی true تنظیم می‌شود که
\fBxa\&.icon\fR
به صورت صریح تنظیم شده باشد\&.
.RE
.PP
\fBxa\&.default\-branch\fR (string)
.RS 4
شاخهٔ پیش‌فرض برای استفاده هنگام نصب از این ریموت\&.
.RE
.PP
\fBxa\&.default\-branch\-is\-set\fR (boolean)
.RS 4
این کلید در صورتی روی true تنظیم می‌شود که
\fBxa\&.default\-branch\fR
به صورت صریح تنظیم شده باشد\&.
.RE
.PP
\fBxa\&.main\-ref\fR (string)
.RS 4
ارجاع اصلی ارائه‌شده توسط این ریموت\&. این کلید برای ریموت‌های مبدا برنامه‌های نصب‌شده از طریق یک فایل flatpakref استفاده می‌شود\&.
.RE
.PP
\fBxa\&.signature\-lookaside\fR (string)
.RS 4
نشانی وب (URL) برای بارگیری امضاها (تنها برای ریموت‌های OCI)، با استفاده از
\m[blue]\fBسازوکار ذخیره‌سازی مجزای containers/image\&.\fR\m[]\&\s-2\u[1]\d\s+2
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.if n \{\
.RS 4
.\}
.nf
[remote "gnome\-nightly\-apps"]
gpg\-verify=true
gpg\-verify\-summary=true
url=https://sdk\&.gnome\&.org/nightly/repo\-apps/
xa\&.title=GNOME Applications
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
[remote "flathub"]
gpg\-verify=true
gpg\-verify\-summary=false
collection\-id=org\&.flathub\&.Stable
url=https://dl\&.flathub\&.org/repo/
xa\&.title=Flathub
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBflatpak-remote-modify\fR(1)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
سازوکار ذخیره‌سازی مجزای containers/image.
.RS 4
\%https://github.com/containers/image/blob/main/docs/signature-protocols.md
.RE