'\" t
.\"     Title: flatpak remote-add
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/27/2026
.\"    Manual: flatpak remote-add
.\"    Source: flatpak
.\"  Language: Persian
.\"
.TH "FLATPAK REMOTE\-ADD" "1" "" "flatpak" "flatpak remote-add"
.\" -----------------------------------------------------------------
.\" * 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-add \- افزودن یک مخزن دوردست
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBflatpak\ remote\-add\fR\ 'u
\fBflatpak remote\-add\fR [OPTION...] NAME LOCATION
.SH "توضیحات (DESCRIPTION)"
.PP
یک مخزن دوردست را به پیکربندی مخازن فلت‌پک اضافه می‌کند\&.
NAME
نام مخزن دوردست جدید است و
LOCATION
یک نشانی اینترنتی (URL) یا مسیر فایل است\&.
LOCATION
می‌تواند یک مخزن فلت‌پک یا یک فایل
\&.flatpakrepo
باشد که مخزن را توصیف می‌کند\&. در حالت اول ممکن است لازم باشد گزینه‌های اضافی مانند کلید GPG مخزن را نیز مشخص کنید\&.
.PP
مگر اینکه با گزینه‌های
\fB\-\-user\fR
یا
\fB\-\-installation\fR
بازنویسی شود، این دستور پیکربندی پیش‌فرض سراسری سیستم را تغییر می‌دهد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش گزینه‌های راهنما و خروج\&.
.RE
.PP
\fB\-\-from\fR
.RS 4
فرض می‌کند که شناسهٔ URI یک فایل \&.flatpakrepo است نه خود مخزن\&. اگر پسوند فایل \&.flatpakrepo باشد، این گزینه به‌طور پیش‌فرض فعال است، بنابراین عموماً به آن نیازی ندارید\&.
.RE
.PP
\fB\-u\fR, \fB\-\-user\fR
.RS 4
تغییر پیکربندی به ازای کاربر\&.
.RE
.PP
\fB\-\-system\fR
.RS 4
تغییر پیکربندی پیش‌فرض سراسری سیستم\&.
.RE
.PP
\fB\-\-installation=NAME\fR
.RS 4
تغییر یک مکان نصب سراسری سیستم مشخص‌شده با
NAME
از میان موارد تعریف‌شده در
/etc/flatpak/installations\&.d/\&. استفاده از
\fB\-\-installation=default\fR
معادل استفاده از
\fB\-\-system\fR
است\&.
.RE
.PP
\fB\-\-no\-gpg\-verify\fR
.RS 4
غیرفعال‌سازی اعتبارسنجی GPG برای مخزن دوردست افزوده‌شده\&.
.RE
.PP
\fB\-\-prio=PRIO\fR
.RS 4
تنظیم اولویت برای مخزن دوردست\&. مقدار پیش‌فرض ۱ است؛ مقدار بالاتر به معنی اولویت بیشتر است\&. این گزینه عمدتاً برای ابزارهای گرافیکی نصب استفاده می‌شود\&. همچنین هنگام جستجوی مخزن دوردست برای تأمین محیط زمان اجرای یک برنامه به کار می‌رود\&. مبدا برنامه پیش از سایر مخازن با اولویت یکسان بررسی می‌شود\&.
.RE
.PP
\fB\-\-subset=SUBSET\fR
.RS 4
محدود کردن ارجاع‌های (refs) در دسترس از مخزن دوردست به آن‌هایی که بخشی از زیرمجموعهٔ نام‌برده هستند\&.
.RE
.PP
\fB\-\-no\-enumerate\fR
.RS 4
علامت‌گذاری مخزن دوردست به‌عنوان شمارش‌نشده (not enumerated)\&. این بدان معناست که این مخزن دوردست برای فهرست‌کردن برنامه‌ها (مثلاً در ابزارهای گرافیکی نصب) استفاده نخواهد شد\&.
.RE
.PP
\fB\-\-no\-use\-for\-deps\fR
.RS 4
علامت‌گذاری مخزن دوردست برای عدم استفاده در حل خودکار وابستگی‌های محیط زمان اجرا\&.
.RE
.PP
\fB\-\-if\-not\-exists\fR
.RS 4
اگر مخزن دوردست ارائه‌شده از قبل وجود دارد، هیچ عملیاتی انجام ندهد\&.
.RE
.PP
\fB\-\-disable\fR
.RS 4
غیرفعال کردن مخزن دوردست افزوده‌شده\&.
.RE
.PP
\fB\-\-title=TITLE\fR
.RS 4
یک عنوان برای مخزن دوردست، مثلاً برای نمایش در واسط کاربری\&.
.RE
.PP
\fB\-\-comment=COMMENT\fR
.RS 4
یک توضیح تک‌خطی برای مخزن دوردست، مثلاً برای نمایش در واسط کاربری\&.
.RE
.PP
\fB\-\-description=DESCRIPTION\fR
.RS 4
یک توضیح کامل در قالب یک پاراگراف برای مخزن دوردست، مثلاً برای نمایش در واسط کاربری\&.
.RE
.PP
\fB\-\-homepage=URL\fR
.RS 4
نشانی اینترنتی (URL) وب‌سایت مخزن دوردست، مثلاً برای نمایش در واسط کاربری\&.
.RE
.PP
\fB\-\-icon=URL\fR
.RS 4
نشانی اینترنتی (URL) آیکون مخزن دوردست، مثلاً برای نمایش در واسط کاربری\&.
.RE
.PP
\fB\-\-default\-branch=BRANCH\fR
.RS 4
شاخهٔ پیش‌فرض برای مخزن دوردست، عمدتاً برای استفاده در واسط کاربری\&.
.RE
.PP
\fB\-\-filter=PATH\fR
.RS 4
افزودن یک فیلتر محلی به مخزن دوردست\&. یک فایل فیلتر فهرستی از خطوط است که هر خط با «allow» یا «deny» شروع می‌شود و سپس یک الگوی منطبق‌سازی (glob) برای ارجاعِ مجاز یا غیرمجاز می‌آید\&. الگوها یک ارجاع جزئی را مشخص می‌کنند (یعنی می‌توانید بخش‌های انتهایی را حذف کنید که در این صورت با همه چیز مطابقت می‌یابد)، و تنها نویسهٔ «*» دارای عملکرد ویژه است که با هر چیزی در آن بخش از ارجاع مطابقت دارد\&.
.sp
به‌طور پیش‌فرض همهٔ ارجاع‌ها مجاز هستند، اما اگر یک ارجاع با یک قانون deny مطابقت داشته باشد ممنوع می‌شود، مگر اینکه به‌طور مشخص با یک قانون allow مطابقت یابد\&. این بدان معناست که می‌توانید از آن برای پیاده‌سازی فهرست مجاز (allowlist) و فهرست مسدودشده (blocklist) استفاده کنید\&.
.sp
نمونه‌ای از یک فایل فیلتر در زیر آورده شده است:
.sp
.if n \{\
.RS 4
.\}
.nf
# This is an allowlist style filter as it denies all first
deny *
allow runtime/org\&.freedesktop\&.*
allow org\&.some\&.app/arm
allow org\&.signal\&.Signal/*/stable
allow org\&.signal\&.Signal\&.*/*/stable
.fi
.if n \{\
.RE
.\}
.sp
.RE
.PP
\fB\-\-gpg\-import=FILE\fR
.RS 4
وارد کردن کلیدهای GPG از فایل دسته‌کلید (keyring) مشخص‌شده به‌عنوان کلیدهای معتمد برای مخزن دوردست جدید\&. اگر فایل \- باشد، دسته‌کلید از ورودی استاندارد خوانده می‌شود\&.
.RE
.PP
\fB\-\-signature\-lookaside=URL\fR
.RS 4
مشخص کردن یک نشانی اینترنتی (URL) برای جستجوی امضاها در این مخزن دوردست (فقط مخازن OCI)\&.
.RE
.PP
\fB\-\-authenticator\-name=NAME\fR
.RS 4
مشخص کردن احرازهویت‌کننده (authenticator) برای استفاده در مخزن دوردست\&.
.RE
.PP
\fB\-\-authenticator\-option=KEY=VALUE\fR
.RS 4
مشخص کردن یک گزینه برای احرازهویت‌کننده در مخزن دوردست\&.
.RE
.PP
\fB\-\-authenticator\-install\fR
.RS 4
فعال‌سازی نصب خودکار احرازهویت‌کننده\&.
.RE
.PP
\fB\-\-no\-authenticator\-install\fR
.RS 4
غیرفعال‌سازی نصب خودکار احرازهویت‌کننده\&.
.RE
.PP
\fB\-\-no\-follow\-redirect\fR
.RS 4
پیروی نکردن از xa\&.redirect\-url تعریف‌شده در فایل خلاصه (summary)\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی هنگام پردازش دستور\&.
.RE
.PP
\fB\-\-ostree\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی OSTree هنگام پردازش دستور\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fB$ flatpak remote\-add gnome https://sdk\&.gnome\&.org/gnome\&.flatpakrepo\fR
.PP
\fB$ flatpak \-\-user remote\-add \-\-no\-gpg\-verify test\-repo https://people\&.gnome\&.org/~alexl/gnome\-sdk/repo\fR
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBflatpak\fR(1),
\fBflatpak-remote-modify\fR(1),
\fBflatpak-remote-delete\fR(1),
\fBflatpak-remotes\fR(1),
\fBflatpakrepo\fR(5)