FLATPAK REMOTE-ADD(1) flatpak remote-add FLATPAK REMOTE-ADD(1)

flatpak-remote-add - افزودن یک مخزن دوردست

flatpak remote-add [OPTION...] NAME LOCATION

یک مخزن دوردست را به پیکربندی مخازن فلت‌پک اضافه می‌کند. NAME نام مخزن دوردست جدید است و LOCATION یک نشانی اینترنتی (URL) یا مسیر فایل است. LOCATION می‌تواند یک مخزن فلت‌پک یا یک فایل .flatpakrepo باشد که مخزن را توصیف می‌کند. در حالت اول ممکن است لازم باشد گزینه‌های اضافی مانند کلید GPG مخزن را نیز مشخص کنید.

مگر اینکه با گزینه‌های --user یا --installation بازنویسی شود، این دستور پیکربندی پیش‌فرض سراسری سیستم را تغییر می‌دهد.

گزینه‌های زیر پشتیبانی می‌شوند:

-h, --help

نمایش گزینه‌های راهنما و خروج.

--from

فرض می‌کند که شناسهٔ URI یک فایل .flatpakrepo است نه خود مخزن. اگر پسوند فایل .flatpakrepo باشد، این گزینه به‌طور پیش‌فرض فعال است، بنابراین عموماً به آن نیازی ندارید.

-u, --user

تغییر پیکربندی به ازای کاربر.

--system

تغییر پیکربندی پیش‌فرض سراسری سیستم.

--installation=NAME

تغییر یک مکان نصب سراسری سیستم مشخص‌شده با NAME از میان موارد تعریف‌شده در /etc/flatpak/installations.d/. استفاده از --installation=default معادل استفاده از --system است.

--no-gpg-verify

غیرفعال‌سازی اعتبارسنجی GPG برای مخزن دوردست افزوده‌شده.

--prio=PRIO

تنظیم اولویت برای مخزن دوردست. مقدار پیش‌فرض ۱ است؛ مقدار بالاتر به معنی اولویت بیشتر است. این گزینه عمدتاً برای ابزارهای گرافیکی نصب استفاده می‌شود. همچنین هنگام جستجوی مخزن دوردست برای تأمین محیط زمان اجرای یک برنامه به کار می‌رود. مبدا برنامه پیش از سایر مخازن با اولویت یکسان بررسی می‌شود.

--subset=SUBSET

محدود کردن ارجاع‌های (refs) در دسترس از مخزن دوردست به آن‌هایی که بخشی از زیرمجموعهٔ نام‌برده هستند.

--no-enumerate

علامت‌گذاری مخزن دوردست به‌عنوان شمارش‌نشده (not enumerated). این بدان معناست که این مخزن دوردست برای فهرست‌کردن برنامه‌ها (مثلاً در ابزارهای گرافیکی نصب) استفاده نخواهد شد.

--no-use-for-deps

علامت‌گذاری مخزن دوردست برای عدم استفاده در حل خودکار وابستگی‌های محیط زمان اجرا.

--if-not-exists

اگر مخزن دوردست ارائه‌شده از قبل وجود دارد، هیچ عملیاتی انجام ندهد.

--disable

غیرفعال کردن مخزن دوردست افزوده‌شده.

--title=TITLE

یک عنوان برای مخزن دوردست، مثلاً برای نمایش در واسط کاربری.

--comment=COMMENT

یک توضیح تک‌خطی برای مخزن دوردست، مثلاً برای نمایش در واسط کاربری.

--description=DESCRIPTION

یک توضیح کامل در قالب یک پاراگراف برای مخزن دوردست، مثلاً برای نمایش در واسط کاربری.

--homepage=URL

نشانی اینترنتی (URL) وب‌سایت مخزن دوردست، مثلاً برای نمایش در واسط کاربری.

--icon=URL

نشانی اینترنتی (URL) آیکون مخزن دوردست، مثلاً برای نمایش در واسط کاربری.

--default-branch=BRANCH

شاخهٔ پیش‌فرض برای مخزن دوردست، عمدتاً برای استفاده در واسط کاربری.

--filter=PATH

افزودن یک فیلتر محلی به مخزن دوردست. یک فایل فیلتر فهرستی از خطوط است که هر خط با «allow» یا «deny» شروع می‌شود و سپس یک الگوی منطبق‌سازی (glob) برای ارجاعِ مجاز یا غیرمجاز می‌آید. الگوها یک ارجاع جزئی را مشخص می‌کنند (یعنی می‌توانید بخش‌های انتهایی را حذف کنید که در این صورت با همه چیز مطابقت می‌یابد)، و تنها نویسهٔ «*» دارای عملکرد ویژه است که با هر چیزی در آن بخش از ارجاع مطابقت دارد.

به‌طور پیش‌فرض همهٔ ارجاع‌ها مجاز هستند، اما اگر یک ارجاع با یک قانون deny مطابقت داشته باشد ممنوع می‌شود، مگر اینکه به‌طور مشخص با یک قانون allow مطابقت یابد. این بدان معناست که می‌توانید از آن برای پیاده‌سازی فهرست مجاز (allowlist) و فهرست مسدودشده (blocklist) استفاده کنید.

نمونه‌ای از یک فایل فیلتر در زیر آورده شده است:

# 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

--gpg-import=FILE

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

--signature-lookaside=URL

مشخص کردن یک نشانی اینترنتی (URL) برای جستجوی امضاها در این مخزن دوردست (فقط مخازن OCI).

--authenticator-name=NAME

مشخص کردن احرازهویت‌کننده (authenticator) برای استفاده در مخزن دوردست.

--authenticator-option=KEY=VALUE

مشخص کردن یک گزینه برای احرازهویت‌کننده در مخزن دوردست.

--authenticator-install

فعال‌سازی نصب خودکار احرازهویت‌کننده.

--no-authenticator-install

غیرفعال‌سازی نصب خودکار احرازهویت‌کننده.

--no-follow-redirect

پیروی نکردن از xa.redirect-url تعریف‌شده در فایل خلاصه (summary).

-v, --verbose

چاپ اطلاعات اشکال‌زدایی هنگام پردازش دستور.

--ostree-verbose

چاپ اطلاعات اشکال‌زدایی OSTree هنگام پردازش دستور.

$ flatpak remote-add gnome https://sdk.gnome.org/gnome.flatpakrepo

$ flatpak --user remote-add --no-gpg-verify test-repo https://people.gnome.org/~alexl/gnome-sdk/repo

flatpak(1), flatpak-remote-modify(1), flatpak-remote-delete(1), flatpak-remotes(1), flatpakrepo(5)

flatpak