نام (NAME)

firecfg - ابزار یکپارچه‌سازی میزکار برای نرم‌افزار Firejail

خلاصه دستور (SYNOPSIS)

firecfg [OPTIONS]

توضیحات (DESCRIPTION)

دستور Firecfg ابزار یکپارچه‌سازی میزکار برای محیط ایزوله (sandbox) نرم‌افزار Firejail است. این ابزار به کاربر اجازه می‌دهد تا برنامه‌ها را با کلیک بر روی آیکون‌ها و منوهای مدیر میزکار به طور خودکار در محیط ایزوله اجرا کند.

این یکپارچه‌سازی موارد زیر را پوشش می‌دهد:

- برنامه‌های آغاز شده در ترمینال - تایپ کردن «firefox» برای راه‌اندازی مرورگر Firefox در محیط ایزوله کافی خواهد بود

- برنامه‌های آغاز شده با کلیک بر روی منوهای مدیر میزکار - تمام مدیرهای میزکار اصلی پشتیبانی می‌شوند

- برنامه‌های آغاز شده با کلیک بر روی آیکون فایل‌ها در مدیر فایل - در حال حاضر فقط مدیرهای میزکار Cinnamon، KDE، LXDE/LXQT، MATE و XFCE پشتیبانی می‌شوند

نکته: در مثال‌ها از sudo استفاده شده است، اما doas نیز پشتیبانی می‌شود.

برای راه‌اندازی، پس از نصب نرم‌افزار Firejail، دستور «sudo firecfg» را اجرا کنید. همین دستور باید پس از نصب برنامه‌های جدید نیز اجرا شود. اگر برنامه توسط Firejail پشتیبانی شود، پیوند نمادین (symbolic link) در /usr/local/bin ایجاد خواهد شد.

برای پیکربندی فهرست برنامه‌هایی که firecfg هنگام ایجاد پیوندهای نمادین از آن‌ها استفاده می‌کند، بخش‌های فایل‌ها (FILES) و سینتکس (SYNTAX) را ببینید.

برای یکپارچه‌سازی دستی توسط کاربر، بخش DESKTOP INTEGRATION را در man 1 firejail ببینید.

عملیات‌های پیش‌فرض (DEFAULT ACTIONS)

عملیات‌های زیر به طور پیش‌فرض با اجرای sudo firecfg انجام می‌شوند:

- تنظیم یا به‌روزرسانی پیوندهای نمادین برای یکپارچه‌سازی میزکار؛

- افزودن کاربر فعلی به پایگاه‌داده دسترسی کاربران Firejail (دستور firecfg --add-users)؛

- اصلاح فایل‌های desktop در $HOME/.local/share/applications/ (دستور firecfg --fix).
- بارگیری و اعمال خودکار و اجباری نمایه (profile) مربوط به AppArmor با نام «firejail-default».

گزینه‌ها (OPTIONS)

--add-users user [user]: افزودن فهرست کاربران به پایگاه‌داده دسترسی کاربران Firejail.
مثال:
$ sudo firecfg --add-users dustin lucas mike eleven
--bindir=directory: ایجاد و جستجوی پیوندهای نمادین در directory به جای مکان پیش‌فرض /usr/local/bin. این دایرکتوری در متغیر محیطی PATH باید قبل از /usr/bin و /bin قرار داشته باشد.
--clean: حذف تمام پیوندهای نمادین firejail.
--fix: اصلاح فایل‌های .desktop. برخی از فایل‌های .desktop از مسیر کامل به فایل اجرایی استفاده می‌کنند. Firecfg فایل‌های .desktop را در /usr/share/applications/ بررسی کرده، مسیر کامل را در صورت وجود در PATH با نام فایل اجرایی جایگزین می‌کند، و نتیجه را در $HOME/.local/share/applications/ می‌نویسد. این کار هنگام اجرای «sudo firecfg» به طور پیش‌فرض انجام می‌شود. این مورد به عنوان گزینه‌ای مجزا برای کاربران عادی نیز قرار داده شده است.
--fix-sound: ایجاد یک فایل مناسب ~/.config/pulse/client.conf بدون پشتیبانی از shm. در برخی نسخه‌های PulseAudio، پشتیبانی از حافظه اشتراکی (shm) فضای‌نام شناسه فرایند (PID namespace) را دچار اختلال می‌کند. نرم‌افزار PulseAudio مدت‌ها پیش طراحی شده است و معرفی فضای‌نام PID در هسته لینوکس طراحی آن را با مشکل مواجه کرد. طبق گزارش‌ها، این مشکل در نسخه ۹ PulseAudio برطرف شده است. اگر در سیستم خود مشکلات صدا دارید، دستور «firecfg --fix-sound» را در یک ترمینال اجرا کنید و سپس برای اعمال تغییرات از حساب خارج و مجدداً وارد شوید (logout/login).
--guide: پیکربندی گام‌به‌گام و هدایت‌شده برای کاربران جدید.
مثال:
$ sudo firecfg --guide
--debug: چاپ پیام‌های اشکال‌زدایی (debug).
-?, --help: چاپ گزینه‌ها و خروج.
--list: فهرست کردن تمام پیوندهای نمادین firejail.
--version: چاپ نسخه برنامه و خروج.

مثال:

$ sudo firecfg
/usr/local/bin/firefox created
/usr/local/bin/vlc created
[...]
$ firecfg --list
/usr/local/bin/firefox
/usr/local/bin/vlc
[...]
$ sudo firecfg --clean
/usr/local/bin/firefox removed
/usr/local/bin/vlc removed
[...]

سینتکس (SYNTAX)

نحو فایل پیکربندی:

خطی که با # آغاز شود یک توضیح (کامنت) در نظر گرفته می‌شود.
خطی که با !PROGRAM آغاز شود به معنای نادیده گرفتن «PROGRAM» هنگام ایجاد پیوندهای نمادین و اصلاح فایل‌های .desktop است.
خطی که با هر چیز دیگری آغاز شود به عنوان نام یک فایل اجرایی در نظر گرفته می‌شود و firecfg تلاش خواهد کرد برای آن یک پیوند نمادین ایجاد کند.

به عنوان مثال، برای جلوگیری از ایجاد پیوندهای نمادین توسط firecfg برای «firefox» و «patch» ضمن تلاش برای ایجاد پیوند نمادین برای «myprog»، می‌توان خطوط زیر را به /etc/firejail/firecfg.d/10-my.conf افزود:

!firefox
!patch

myprog

توجه داشته باشید که برخی از برنامه‌ها ممکن است شیوه‌های نام‌گذاری متفاوتی را برای فایل .desktop خود در مقایسه با فایل اجرایی اصلی به کار ببرند. برای اطمینان از این که هر دو فایل به روشی یکسان مدیریت می‌شوند، توصیه می‌شود هر دو نام در پیکربندی درج شوند. به عنوان مثال، اگر Spectacle فایل اجرایی اصلی خود را در /usr/bin/spectacle و فایل .desktop خود را در /usr/share/applications/org.kde.spectacle.desktop داشته باشد، می‌توان از خطوط زیر برای نادیده گرفتن هر دو استفاده کرد:

!org.kde.spectacle
!spectacle

فایل‌ها (FILES)

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

1. /etc/firejail/firecfg.d/*.conf (به ترتیب الفبایی)
2. /etc/firejail/firecfg.config

برنامه‌هایی که به طور پیش‌فرض پشتیبانی می‌شوند در /etc/firejail/firecfg.config فهرست شده‌اند. توصیه می‌شود این فایل دست‌نخورده باقی بماند و تمام سفارشی‌سازی‌ها درون /etc/firejail/firecfg.d/ قرار گیرند.

فایل‌های نمایه (profile) نیز در دایرکتوری پیکربندی کاربر جستجو می‌شوند:

3. ~/.config/firejail/*.profile

به ازای هر فایل PROGRAM.profile یافت‌شده، firecfg تلاش می‌کند یک پیوند نمادین برای «PROGRAM» ایجاد کند، دقیقاً به صورتی که گویی «PROGRAM» در یک فایل پیکربندی فهرست شده است.

مجوز (LICENSE)

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU General Public License) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ پروانه و چه (به انتخاب خودتان) هر نسخه بعدی دیگری، بازتوزیع کرده یا تغییر دهید.

صفحه خانگی: https://firejail.wordpress.com

همچنین ببینید (SEE ALSO)

firejail(1), firemon(1), firejail-profile(5), firejail-login(5), firejail-users(5), jailcheck(1)