FLATPAK REMOTE(5) flatpak remote FLATPAK REMOTE(5)

flatpak-remote - پیکربندی یک ریموت (remote)

ابزار Flatpak اطلاعات مربوط به ریموت‌های پیکربندی‌شده برای یک مکان نصب را در $installation/repo/config ذخیره می‌کند. برای نمونه، ریموت‌های مربوط به نصب پیش‌فرض سراسری سیستم در $prefix/var/lib/flatpak/repo/config و ریموت‌های مربوط به نصب به ازای هر کاربر در $HOME/.local/share/flatpak/repo/config قرار دارند.

به طور معمول، ویرایش مستقیم فایل‌های پیکربندی ریموت ضروری نیست؛ برای تغییر ویژگی‌های ریموت‌ها باید از دستور flatpak remote-modify استفاده شود.

ریموت‌های سراسری سیستم را می‌توان با قرار دادن فایل‌های flatpakrepo(5) در مسیرهای /usr/share/flatpak/remotes.d/ و /etc/flatpak/remotes.d/ به صورت ایستا از پیش پیکربندی کرد. در صورتی که فایلی با نام یکسان در هر دو مسیر موجود باشد، فایل موجود در /etc اولویت خواهد داشت.

قالب فایل پیکربندی ریموت از همان قالب فایل‌های .ini استفاده می‌کند که برای فایل‌های واحد systemd یا فایل‌های .desktop برنامه‌ها به کار می‌رود.

تمام پیکربندی‌های مربوط به ریموتی با نام NAME در گروه [remote "NAME"] قرار می‌گیرد.

کلیدهای زیر، در میان موارد دیگر، توسط OSTree شناسایی می‌شوند:

url (string)

آدرس url مربوط به ریموت. یک آدرس URL به شکل oci+https:// یا oci+http:// یک افزونهٔ Flatpak است که نشان می‌دهد ریموت یک مخزن ostree نیست، بلکه یک URL به نمایه‌ای از ایمیج‌های OCI ذخیره‌شده در یک رجیستری ایمیج کانتینر است.

برای ریموت‌های OCI، گواهی‌های کلاینت و CA همان‌گونه که در containers-certs.d(5) مستند شده است، از /etc/containers/certs.d و ~/.config/containers/certs.d خوانده می‌شوند.

gpg-verify (boolean)

مشخص می‌کند که آیا برای محتوای این ریموت از اعتبارسنجی GPG استفاده شود یا خیر.

gpg-verify-summary (boolean)

مشخص می‌کند که آیا برای فایل خلاصه (summary) این ریموت از اعتبارسنجی GPG استفاده شود یا خیر.

در صورتی که collection-id تنظیم شده باشد، این گزینه نادیده گرفته می‌شود، زیرا در آن حالت ارجاع‌ها (refs) در فراداده‌های کامیت اعتبارسنجی می‌شوند. فعال کردن gpg-verify-summary توزیع همتابه‌همتای (P2P) ارجاع‌ها را با مشکل مواجه خواهد کرد.

collection-id (string)

شناسهٔ یکتای سراسری برای مخزن بالادستی مجموعه، جهت امکان‌پذیر ساختن گروه‌بندی آینه‌ها (mirrors).

تمام کلیدهای اختصاصی flatpak دارای پیشوند xa. هستند:

xa.disable (boolean)

مشخص می‌کند که آیا ریموت غیرفعال است یا خیر. مقدار پیش‌فرض false است.

xa.prio (integer)

اولویت ریموت. این مقدار هنگام فهرست کردن ریموت‌ها و هنگام جست‌وجو در آن‌ها برای یافتن زمان‌اجرای (runtime) مورد نیاز یک برنامه به کار می‌رود. ریموتی که برنامه را ارائه می‌دهد پیش از سایر ریموت‌های با اولویت یکسان برای یافتن زمان‌اجرا جست‌وجو می‌شود. مقدار پیش‌فرض 1 است.

xa.noenumerate (boolean)

مشخص می‌کند که آیا این ریموت هنگام ارائهٔ برنامه‌ها/زمان‌های اجرای موجود، یا هنگام جست‌وجو برای یک وابستگی زمان‌اجرا نادیده گرفته شود یا خیر. مقدار پیش‌فرض false است.

xa.nodeps (boolean)

مشخص می‌کند که آیا این ریموت هنگام جست‌وجو برای وابستگی‌ها کنار گذاشته شود یا خیر. مقدار پیش‌فرض false است.

xa.title (string)

یک عنوان اختیاری برای استفاده هنگام نمایش این ریموت در یک رابط کاربری (UI).

xa.title-is-set (boolean)

این کلید در صورتی روی true تنظیم می‌شود که xa.title به صورت صریح تنظیم شده باشد.

xa.comment (string)

یک توضیح تک‌خطی اختیاری برای استفاده هنگام نمایش این ریموت در یک رابط کاربری.

xa.comment-is-set (boolean)

این کلید در صورتی روی true تنظیم می‌شود که xa.comment به صورت صریح تنظیم شده باشد.

xa.description (string)

یک پاراگراف متنی کامل و اختیاری برای استفاده هنگام نمایش این ریموت در یک رابط کاربری.

xa.description-is-set (boolean)

این کلید در صورتی روی true تنظیم می‌شود که xa.description به صورت صریح تنظیم شده باشد.

xa.homepage (string)

یک نشانی وب (URL) اختیاری که به وب‌سایت این مخزن اشاره می‌کند تا هنگام نمایش این ریموت در یک رابط کاربری استفاده شود.

xa.homepage-is-set (boolean)

این کلید در صورتی روی true تنظیم می‌شود که xa.homepage به صورت صریح تنظیم شده باشد.

xa.icon (string)

یک نشانی وب (URL) اختیاری که به یک آیکون برای این مخزن اشاره می‌کند تا هنگام نمایش این ریموت در یک رابط کاربری استفاده شود.

xa.icon-is-set (boolean)

این کلید در صورتی روی true تنظیم می‌شود که xa.icon به صورت صریح تنظیم شده باشد.

xa.default-branch (string)

شاخهٔ پیش‌فرض برای استفاده هنگام نصب از این ریموت.

xa.default-branch-is-set (boolean)

این کلید در صورتی روی true تنظیم می‌شود که xa.default-branch به صورت صریح تنظیم شده باشد.

xa.main-ref (string)

ارجاع اصلی ارائه‌شده توسط این ریموت. این کلید برای ریموت‌های مبدا برنامه‌های نصب‌شده از طریق یک فایل flatpakref استفاده می‌شود.

xa.signature-lookaside (string)

نشانی وب (URL) برای بارگیری امضاها (تنها برای ریموت‌های OCI)، با استفاده از سازوکار ذخیره‌سازی مجزای containers/image.[1]

[remote "gnome-nightly-apps"]
gpg-verify=true
gpg-verify-summary=true
url=https://sdk.gnome.org/nightly/repo-apps/
xa.title=GNOME Applications
[remote "flathub"]
gpg-verify=true
gpg-verify-summary=false
collection-id=org.flathub.Stable
url=https://dl.flathub.org/repo/
xa.title=Flathub

flatpak-remote-modify(1)

1.
سازوکار ذخیره‌سازی مجزای containers/image.
https://github.com/containers/image/blob/main/docs/signature-protocols.md
flatpak