'\" t
.\"     Title: cockpit.conf
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-08-27
.\"    Manual: cockpit
.\"    Source: cockpit
.\"  Language: Persian
.\"
.TH "COCKPIT.CONF" "5" "2026-08-27" "cockpit" "cockpit"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
cockpit.conf \- فایل پیکربندی Cockpit
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه Cockpit می‌تواند از طریق /etc/cockpit/cockpit.conf پیکربندی شود. اگر
متغیر \fB$XDG_CONFIG_DIRS\fP تنظیم شده باشد، نخستین مسیری که حاوی
\fB../cockpit/cockpit.conf\fP باشد به جای آن استفاده می‌شود. سایر فایل‌ها
و دایرکتوری‌های پیکربندی نیز به همین شیوه جستجو می‌شوند.
.sp
این فایل الزامی نیست و ممکن است نیاز باشد به صورت دستی ایجاد شود. این فایل
دارای ساختار INI است و بنابراین شامل جفت‌های کلید / مقدار است که در
گروه‌های موضوعی دسته‌بندی شده‌اند. برای جزئیات به مثال‌های زیر مراجعه کنید.
.sp
نکته: پورتی که cockpit روی آن گوش می‌دهد را نمی‌توان در این فایل تغییر داد.
برای تغییر پورت، فایل \fBcockpit.socket\fP مربوط به systemd را ویرایش کنید.
.SH "سرویس وب (WEBSERVICE)"
.sp
\fBOrigins\fP
.RS 4
به طور پیش‌فرض cockpit اتصالات وب‌سوکت میان‌دامنه‌ای (crossdomain) را نمی‌پذیرد.
از این تنظیم برای مجاز کردن دسترسی از دامنه‌های جایگزین استفاده کنید. مبداها (Origins)
باید در صورت نیاز شامل طرح (scheme)، میزبان (host) و پورت باشند. استفاده از نویسه‌های
عمومی (wildcards) و عبارات گلوب (glob) مجاز است. براکت‌های آدرس‌های IPv6 باید با بک‌اسلش
اسکیپ شوند (مانند \f(CR\(rs[::1\(rs]\fP) چرا که با استفاده از \f(CRfnmatch()\fP تطبیق داده می‌شوند.

.br
.RE
.sp
.if n .RS 4
.nf
.fam C
[WebService]
Origins = https://somedomain1.com https://somedomain2.com:9090 https://*.somedomain3.com https://\(rs[::1\(rs]:9090
.fam
.fi
.if n .RE
.sp
\fBProtocolHeader\fP
.RS 4
پیکربندی cockpit برای بررسی محتوای این هدر به منظور تعیین اینکه آیا اتصال
از tls استفاده می‌کند یا خیر. این مورد فقط باید زمانی استفاده شود که cockpit
پشت یک پراکسی معکوس (reverse proxy) قرار دارد، و باید مراقبت شود که درخواست‌های
ورودی نتوانند این هدر را دستکاری و تنظیم کنند.

.br
.RE
.sp
.if n .RS 4
.nf
.fam C
[WebService]
ProtocolHeader = X\-Forwarded\-Proto
.fam
.fi
.if n .RE
.sp
\fBForwardedForHeader\fP
.RS 4
پیکربندی cockpit برای بررسی محتوای این هدر به منظور تعیین مبدا واقعی یک اتصال.
این مورد فقط باید زمانی استفاده شود که cockpit پشت یک پراکسی معکوس قرار دارد،
و باید مراقبت شود که درخواست‌های ورودی نتوانند این هدر را تنظیم کنند.

.br
.RE
.sp
.if n .RS 4
.nf
.fam C
[WebService]
ForwardedForHeader = X\-Forwarded\-For
.fam
.fi
.if n .RE
.sp
\fBLoginTitle\fP
.RS 4
تنظیم عنوان مرورگر برای صفحه ورود.
.RE
.sp
\fBLoginTo\fP
.RS 4
هنگامی که روی \f(CRtrue\fP تنظیم شود، گزینه \fIConnect to\fP در صفحه ورود قابل
مشاهده خواهد بود و امکان ورود به یک سرور دیگر را فراهم می‌کند. هنگامی که روی
\f(CRfalse\fP تنظیم شود، ورودهای مستقیم از راه دور غیرمجاز می‌شوند. اگر این گزینه
مشخص نشده باشد، بر اساس اینکه آیا بسته \fBcockpit\-bridge\fP نصب است و برنامه
\fBssh\fP در دسترس قرار دارد یا خیر، به طور خودکار تشخیص داده می‌شود.
.br

.br
اگر cockpit\-ws در معرض اینترنت عمومی قرار دارد و هم‌زمان به یک شبکه خصوصی
داخلی نیز دسترسی دارد، توصیه می‌شود که صراحتاً \fBLoginTo=false\fP تنظیم شود.
این کار از اسکن شبکه داخلی توسط مهاجمان احراز هویت‌نشده از راه دور برای یافتن
ماشین‌های موجود و پورت‌های باز جلوگیری می‌کند.
.RE
.sp
\fBRequireHost\fP
.RS 4
هنگامی که روی \f(CRtrue\fP تنظیم شود، cockpit کاربران را ملزم می‌کند تا از گزینه
\fIConnect to\fP برای مشخص کردن میزبانی که قصد ورود به آن را دارند استفاده کنند.
.RE
.sp
\fBAllowMultiHost\fP
.RS 4
هنگامی که روی \f(CRtrue\fP تنظیم شود، cockpit به کاربران اجازه می‌دهد در یک نشست
به چندین میزبان متصل شوند. مقدار پیش‌فرض به سیستم‌عامل بستگی دارد.
.br

.br
هنگام اتصال به چندین سرور، جاوااسکریپت (JavaScript) بدون ایزوله‌سازی اجرا می‌شود.
همه سیستم‌ها در معرض حملات احتمالی از سوی سایر میزبان‌های متصل خواهند بود. این
گزینه را \fIفقط\fP زمانی فعال کنید که به تمام میزبان‌ها کاملاً اعتماد دارید.
.RE
.sp
\fBMaxStartups\fP
.RS 4
مشابه گزینه پیکربندی هم‌نام در \fBsshd\fP است. حداکثر تعداد تلاش‌های هم‌زمان برای
ورود را مشخص می‌کند. اتصالات اضافی تا زمان موفقیت احراز هویت یا بسته شدن اتصالات
قطع خواهند شد. مقدار پیش‌فرض 10 است.
.br

.br
همچنین می‌توان با مشخص کردن سه مقدار جدا شده با دو نقطه \fBstart:rate:full\fP
(برای مثال "10:30:60")، قابلیت قطع زودهنگام تصادفی (random early drop) را فعال کرد.
اگر در حال حاضر \fBstart\fP (10) اتصال احراز هویت‌نشده وجود داشته باشد، Cockpit
با احتمال \fBrate/100\fP (30%) شروع به رد تلاش‌های احراز هویت خواهد کرد. این احتمال
به صورت خطی افزایش می‌یابد و در صورتی که تعداد اتصالات احراز هویت‌نشده به
\fBfull\fP (60) برسد، تمام تلاش‌های اتصال رد می‌شوند.
.RE
.sp
\fBAllowUnencrypted\fP
.RS 4
اگر true باشد، cockpit اتصالات رمزگذاری‌نشده HTTP را می‌پذیرد. در غیر این صورت،
تمام اتصالات HTTP را به HTTPS هدایت می‌کند. اتصالات از localhost و برای برخی
نشانی‌های خاص (مانند \fB/ping\fP) از این قاعده مستثنی هستند. مقدار پیش‌فرض false است.
.RE
.sp
\fBUrlRoot\fP
.RS 4
نشانی ریشه (Root URL) که Cockpit روی آن ارائه خواهد شد. در صورت مشخص شدن،
cockpit انتظار دارد تمام درخواست‌ها با نشانی وب داده شده پیشوند شوند. این تنظیم بیشتر
زمانی مفید است که از cockpit پشت یک پراکسی معکوس مانند nginx استفاده می‌کنید.
مفاهیم \f(CR/cockpit/\fP و \f(CR/cockpit+\fP رزرو شده هستند و نباید استفاده شوند.
برای مثال \f(CR/cockpit\-new/\fP مجاز است، اما \f(CR/cockpit/\fP و
\f(CR/cockpit+new/\fP مجاز نیستند.
.RE
.sp
\fBClientCertAuthentication\fP
.RS 4
اگر true باشد، گواهی‌های کلاینت TLS را برای احراز هویت کاربران فعال می‌کند.
معمولاً این گواهی‌ها توسط کارت هوشمند (smart card) ارائه می‌شوند، اما وارد کردن
مستقیم گواهی‌ها به داخل مرورگر وب نیز امکان‌پذیر است. لطفاً برای جزئیات به بخش \c
.URL "https://docs.cockpit\-project.org/cockpit\-guide/latest/guide/cert\-authentication.html" "احراز هویت با گواهی/کارت هوشمند (Certificate/smart card authentication)" ""
 در راهنمای Cockpit مراجعه کنید.
.RE
.sp
\fBShell\fP
.RS 4
نشانی وب نسبی به مؤلفه سطح بالا که پس از ورود در Cockpit نمایش داده می‌شود.
پیش‌فرض \f(CR/shell/index.html\fP است.
.RE
.sp
\fBCustomLoginPage\fP
.RS 4
بارگذاری صفحه ورود از یک دایرکتوری جایگزین. این دایرکتوری باید حاوی یک فایل
\f(CRlogin.html\fP و به صورت اختیاری یک فایل \f(CRpo.js\fP برای ترجمه‌ها باشد.
در صورت عدم تنظیم، از دایرکتوری ثابت \f(CR$prefix/share/cockpit/static\fP استفاده می‌شود.
.RE
.SH "گزارش‌گیری (LOG)"
.sp
\fBFatal\fP
.RS 4
نوع پیام‌های لاگ در bridge که باید بحرانی (fatal) تلقی شوند. مقادیر متعدد را با
فاصله جدا کنید. مقادیر مرتبط عبارتند از: \fBcriticals\fP و \fBwarnings\fP.
.RE
.SH "اوآث (OAUTH)"
.sp
Cockpit می‌تواند برای پشتیبانی از جریان مجوزدهی OAuth با \c
.URL "https://tools.ietf.org/html/rfc6749#section\-4.2" "اعطای ضمنی (implicit grant)" ""
 پیکربندی شود. در صورت موفقیت، توکن oauth حاصل با استفاده از روش احراز هویت
\fBBearer\fP به cockpit\-ws ارسال خواهد شد. برای ورود موفقیت‌آمیز، cockpit همچنین
باید برای اعتبارسنجی و مجاز دانستن توکن‌های \fBBearer\fP پیکربندی شده باشد.
.sp
\fBURL\fP
.RS 4
نشانی وبی است که cockpit هنگام نیاز به دریافت توکن oauth، مرورگر کاربر را به آن
هدایت می‌کند. Cockpit یک پارامتر redirect_uri با مشخص کردن مقصدی که ارائه‌دهنده oauth
باید پس از دریافت توکن کاربر را به آن هدایت کند، به نشانی وب اضافه خواهد کرد.
.RE
.sp
\fBErrorParam\fP
.RS 4
هنگامی که ارائه‌دهنده oauth کاربر را به cockpit بازمی‌گرداند، این پارامتر را در
رشته پرس‌وجو (querystring) یا بخش فرگمنت نشانی وب برای یافتن پیام خطا جستجو می‌کند.
در صورت عدم ارائه، مقدار پیش‌فرض \fBerror_description\fP خواهد بود.
.RE
.sp
\fBTokenParam\fP
.RS 4
هنگامی که ارائه‌دهنده oauth کاربر را به cockpit بازمی‌گرداند، این پارامتر را در
رشته پرس‌وجو یا بخش فرگمنت نشانی وب برای یافتن توکن دسترسی جستجو می‌کند. در صورت
عدم ارائه، مقدار پیش‌فرض \fBaccess_token\fP خواهد بود.
.RE
.SH "نشست (SESSION)"
.sp
\fBBanner\fP
.RS 4
محتوای فایل مشخص شده (معمولاً \fB/etc/issue\fP) در صفحه ورود نشان داده می‌شود.
به طور پیش‌فرض، هیچ بنری نمایش داده نمی‌شود.
.RE
.sp
\fBIdleTimeout\fP
.RS 4
مدت زمان بر حسب دقیقه که پس از آن در صورت عدم انجام فعالیتی از سوی کاربر،
نشست منقضی شده و کاربر خارج می‌شود. این مهلت بی‌کاری فقط برای ورودهای تعاملی
با گذرواژه اعمال می‌شود. در روش‌های احراز هویت غیرتعاملی مانند Kerberos، OAuth
یا ورود با گواهی، مرورگر نمی‌تواند اعتبارنامه‌ها را فراموش کند و بنابراین خروج‌های
خودکار برای محافظت از اعتبارنامه‌های نشست‌های فراموش‌شده کارایی ندارند. مقدار را
روی \fB0\fP تنظیم کنید تا زمان انقضای نشست غیرفعال شود.

.br
.RE
.sp
.if n .RS 4
.nf
.fam C
[Session]
IdleTimeout=15
.fam
.fi
.if n .RE
.sp

.RS 4
در صورت عدم تعیین، به طور پیش‌فرض هیچ مهلت زمانی بی‌کاری وجود ندارد.
.RE
.sp
\fBWarnBeforeConnecting\fP
.RS 4
تعیین اینکه آیا پیش از اتصال به میزبان‌های راه دور از طریق Shell هشدار داده شود
یا خیر. مقدار پیش‌فرض true است.

.br
.RE
.sp
.if n .RS 4
.nf
.fam C
[Session]
WarnBeforeConnecting=false
.fam
.fi
.if n .RE
.SH "گزارش باگ‌ها (BUGS)"
.sp
لطفاً گزارش‌های باگ را به سامانه ردیابی خطای توزیع یا \c
.URL "https://github.com/cockpit\-project/cockpit/issues/new" "ردیاب باگ بالادست (upstream)" ""
 ارسال کنید.
.SH "نویسندگان (AUTHORS)"
.sp
برنامه Cockpit توسط \c
.URL "https://github.com/cockpit\-project/cockpit" "مشارکت‌کنندگان" ""
 بسیاری توسعه یافته است.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBcockpit\-ws\fP(8), \fBcockpit\-tls\fP(8)