.TH FIRECFG 1 "Mar 2026" "0.9.80" "firecfg man page"
.SH "نام (NAME)"
firecfg \- ابزار یکپارچه‌سازی میزکار برای نرم‌افزار Firejail
.SH "خلاصه دستور (SYNOPSIS)"
firecfg [OPTIONS]
.SH "توضیحات (DESCRIPTION)"
دستور Firecfg ابزار یکپارچه‌سازی میزکار برای محیط ایزوله (sandbox) نرم‌افزار Firejail است.
این ابزار به کاربر اجازه می‌دهد تا برنامه‌ها را با کلیک بر روی آیکون‌ها و منوهای مدیر میزکار به طور خودکار در محیط ایزوله اجرا کند.

این یکپارچه‌سازی موارد زیر را پوشش می‌دهد:
.br
.PP
.RS
\- برنامه‌های آغاز شده در ترمینال \- تایپ کردن «firefox» برای راه‌اندازی مرورگر Firefox در محیط ایزوله کافی خواهد بود
.br

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

.br
\- برنامه‌های آغاز شده با کلیک بر روی آیکون فایل‌ها در مدیر فایل \- در حال حاضر فقط مدیرهای میزکار Cinnamon، KDE، LXDE/LXQT، MATE و XFCE پشتیبانی می‌شوند
.RE
.PP
نکته: در مثال‌ها از \fBsudo\fR استفاده شده است، اما \fBdoas\fR نیز پشتیبانی می‌شود.
.PP
برای راه‌اندازی، پس از نصب نرم‌افزار Firejail، دستور «sudo firecfg» را اجرا کنید.
همین دستور باید پس از نصب برنامه‌های جدید نیز اجرا شود. اگر برنامه توسط Firejail پشتیبانی شود، پیوند نمادین (symbolic link) در /usr/local/bin ایجاد خواهد شد.
.PP
برای پیکربندی فهرست برنامه‌هایی که firecfg هنگام ایجاد پیوندهای نمادین از آن‌ها استفاده می‌کند، بخش‌های \fBفایل‌ها (FILES)\fR و \fBسینتکس (SYNTAX)\fR را ببینید.
.PP
برای یکپارچه‌سازی دستی توسط کاربر، بخش \fBDESKTOP INTEGRATION\fR را در \fBman 1 firejail\fR ببینید.
.SH "عملیات‌های پیش‌فرض (DEFAULT ACTIONS)"
عملیات‌های زیر به طور پیش‌فرض با اجرای sudo firecfg انجام می‌شوند:

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

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

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

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-add-users user [user]
افزودن فهرست کاربران به پایگاه‌داده دسترسی کاربران Firejail.

مثال:
.br
$ sudo firecfg \-\-add-users dustin lucas mike eleven

.TP
\fB\-\-bindir=directory
ایجاد و جستجوی پیوندهای نمادین در directory به جای مکان پیش‌فرض /usr/local/bin.
این دایرکتوری در متغیر محیطی PATH باید قبل از /usr/bin و /bin قرار داشته باشد.

.TP
\fB\-\-clean
حذف تمام پیوندهای نمادین firejail.

.TP
\fB\-\-fix
اصلاح فایل‌های .desktop. برخی از فایل‌های .desktop از مسیر کامل به فایل اجرایی استفاده می‌کنند. Firecfg فایل‌های .desktop را در /usr/share/applications/ بررسی کرده، مسیر کامل را در صورت وجود در PATH با نام فایل اجرایی جایگزین می‌کند، و نتیجه را در $HOME/.local/share/applications/ می‌نویسد.
این کار هنگام اجرای «sudo firecfg» به طور پیش‌فرض انجام می‌شود. این مورد به عنوان گزینه‌ای مجزا برای کاربران عادی نیز قرار داده شده است.

.TP
\fB\-\-fix-sound
ایجاد یک فایل مناسب ~/.config/pulse/client.conf بدون پشتیبانی از shm. در برخی نسخه‌های PulseAudio، پشتیبانی از حافظه اشتراکی (shm) فضای‌نام شناسه فرایند (PID namespace) را دچار اختلال می‌کند. نرم‌افزار PulseAudio مدت‌ها پیش طراحی شده است و معرفی فضای‌نام PID در هسته لینوکس طراحی آن را با مشکل مواجه کرد. طبق گزارش‌ها، این مشکل در نسخه ۹ PulseAudio برطرف شده است. اگر در سیستم خود مشکلات صدا دارید، دستور «firecfg --fix-sound» را در یک ترمینال اجرا کنید و سپس برای اعمال تغییرات از حساب خارج و مجدداً وارد شوید (logout/login).
.TP
\fB\-\-guide
پیکربندی گام‌به‌گام و هدایت‌شده برای کاربران جدید.
.br

.br
مثال:
.br
$ sudo firecfg \-\-guide
.br
.TP
\fB\-\-debug
چاپ پیام‌های اشکال‌زدایی (debug).
.TP
\fB\-?\fR, \fB\-\-help\fR
چاپ گزینه‌ها و خروج.
.TP
\fB\-\-list
فهرست کردن تمام پیوندهای نمادین firejail.
.TP
\fB\-\-version
چاپ نسخه برنامه و خروج.


.PP
مثال:
.br

.br
$ sudo firecfg
.br
/usr/local/bin/firefox created
.br
/usr/local/bin/vlc created
.br
[...]
.br
$ firecfg --list
.br
/usr/local/bin/firefox
.br
/usr/local/bin/vlc
.br
[...]
.br
$ sudo firecfg --clean
.br
/usr/local/bin/firefox removed
.br
/usr/local/bin/vlc removed
.br
[...]
.SH "سینتکس (SYNTAX)"
نحو فایل پیکربندی:
.PP
خطی که با \fB#\fR آغاز شود یک توضیح (کامنت) در نظر گرفته می‌شود.
.br
خطی که با \fB!PROGRAM\fR آغاز شود به معنای نادیده گرفتن «PROGRAM» هنگام ایجاد پیوندهای نمادین و اصلاح فایل‌های .desktop است.
.br
خطی که با هر چیز دیگری آغاز شود به عنوان نام یک فایل اجرایی در نظر گرفته می‌شود و firecfg تلاش خواهد کرد برای آن یک پیوند نمادین ایجاد کند.
.PP
به عنوان مثال، برای جلوگیری از ایجاد پیوندهای نمادین توسط firecfg برای «firefox» و «patch» ضمن تلاش برای ایجاد پیوند نمادین برای «myprog»، می‌توان خطوط زیر را به /etc/firejail/firecfg.d/10-my.conf افزود:
.PP
.RS
!firefox
.br
!patch
.br

.br
myprog
.RE
.PP
توجه داشته باشید که برخی از برنامه‌ها ممکن است شیوه‌های نام‌گذاری متفاوتی را برای فایل .desktop خود در مقایسه با فایل اجرایی اصلی به کار ببرند.
برای اطمینان از این که هر دو فایل به روشی یکسان مدیریت می‌شوند، توصیه می‌شود هر دو نام در پیکربندی درج شوند.
به عنوان مثال، اگر Spectacle فایل اجرایی اصلی خود را در /usr/bin/spectacle و فایل \&.desktop خود را در /usr/share/applications/org.kde.spectacle.desktop داشته باشد، می‌توان از خطوط زیر برای نادیده گرفتن هر دو استفاده کرد:
.PP
.RS
!org.kde.spectacle
.br
!spectacle
.RE
.SH "فایل‌ها (FILES)"
.PP
فایل‌های پیکربندی در مسیرهای زیر جستجو و تجزیه می‌شوند:
.PP
.RS
1. /etc/firejail/firecfg.d/*.conf (به ترتیب الفبایی)
.br
2. /etc/firejail/firecfg.config
.RE
.PP
برنامه‌هایی که به طور پیش‌فرض پشتیبانی می‌شوند در /etc/firejail/firecfg.config فهرست شده‌اند.
توصیه می‌شود این فایل دست‌نخورده باقی بماند و تمام سفارشی‌سازی‌ها درون /etc/firejail/firecfg.d/ قرار گیرند.
.PP
فایل‌های نمایه (profile) نیز در دایرکتوری پیکربندی کاربر جستجو می‌شوند:
.PP
.RS
3. ~/.config/firejail/*.profile
.RE
.PP
به ازای هر فایل \fBPROGRAM.profile\fR یافت‌شده، firecfg تلاش می‌کند یک پیوند نمادین برای «PROGRAM» ایجاد کند، دقیقاً به صورتی که گویی «PROGRAM» در یک فایل پیکربندی فهرست شده است.
.SH "مجوز (LICENSE)"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU General Public License) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ پروانه و چه (به انتخاب خودتان) هر نسخه بعدی دیگری، بازتوزیع کرده یا تغییر دهید.
.PP
صفحه خانگی:
.UR https://firejail.wordpress.com
.UE
.SH "همچنین ببینید (SEE ALSO)"
.BR firejail (1),
.BR firemon (1),
.BR firejail-profile (5),
.BR firejail-login (5),
.BR firejail-users (5),
.BR jailcheck (1)
.\" vim: set filetype=groff :