'\" t
.\"     Title: cockpit-tls
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-08-27
.\"    Manual: cockpit
.\"    Source: cockpit
.\"  Language: Persian
.\"
.TH "COCKPIT\-TLS" "8" "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-tls \- پروکسی TLS برای سرویس وب Cockpit
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcockpit\-tls\fP [\fB\-\-help\fP] [\fB\-\-port\fP \fIPORT\fP] [\fB\-\-no\-tls\fP] [\fB\-\-idle\-timeout\fP \fISECONDS\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامهٔ \fBcockpit\-tls\fP یک پروکسی HTTP خاتمه‌دهندهٔ TLS برای \fBcockpit\-ws\fP(8) است. این برنامه مجموعه‌ای از نمونه‌های ایزوله‌شدهٔ cockpit\-ws را مدیریت می‌کند: یک نمونه به ازای هر گواهی کلاینت TLS، به علاوه یک نمونه برای TLS بدون گواهی کلاینت، و یک نمونه برای HTTP رمزگذاری‌نشده. بدین ترتیب، هیچ نشستی نمی‌تواند از طریق سوءاستفاده از آسیب‌پذیری‌های امنیتی احتمالی در نشست دیگر دستکاری یا تداخل ایجاد کند.
.sp
کاربران یا مدیران سیستم معمولاً هیچ‌گاه نیازی به اجرای دستی این برنامه ندارند، چرا که به طور خودکار توسط \fBsystemd\fP(1) از طریق فعال‌سازی سوکت (socket activation) آغاز به کار می‌کند.
.SH "امنیت انتقال (TRANSPORT SECURITY)"
.sp
برای مشخص کردن گواهی TLS که سرویس وب باید استفاده کند، کافی است فایلی با پسوند \fB.cert\fP را در دایرکتوری \fB/etc/cockpit/ws\-certs.d\fP، یا در صورت تنظیم بودن در زیرشاخهٔ \fB$XDG_CONFIG_DIRS\fP قرار دهید (به \fBcockpit.conf\fP(5) مراجعه کنید). اگر چند فایل در این دایرکتوری وجود داشته باشد، پس از مرتب‌سازی، فایلی با بالاترین اولویت انتخاب می‌شود.
.sp
فایل \fB.cert\fP باید حداقل شامل دو بلوک PEM به سبک OpenSSL باشد: نخست یک یا چند بلوک \f(CRBEGIN CERTIFICATE\fP برای گواهی سرور و مراجع صدور گواهی میانی (intermediate CAs)، و دومین بلوک شامل \f(CRBEGIN PRIVATE KEY\fP یا موارد مشابه. کلید نباید رمزگذاری‌شده باشد.
.sp
اگر هیچ گواهی TLS موجود نباشد، یک گواهی خودامضا (self\-signed) به طور خودکار با استفاده از \fBsscg\fP (در صورت در دسترس بودن) یا \fBopenssl\fP ایجاد شده و در فایل \fB0\-self\-signed.cert\fP ذخیره می‌شود.
.sp
هنگام پیوستن به یک دامنهٔ FreeIPA، یک گواهی SSL از سرور IPA درخواست شده و در \fB10\-ipa.cert\fP ذخیره می‌گردد.
.sp
برای بررسی اینکه \fBcockpit\-ws\fP از کدام گواهی استفاده خواهد کرد، دستور زیر را اجرا کنید:
.sp
.if n .RS 4
.nf
.fam C
$ sudo /usr/libexec/cockpit\-certificate\-ensure \-\-check
.fam
.fi
.if n .RE
.sp
یا در سیستم‌های مبتنی بر دبیان:
.sp
.if n .RS 4
.nf
.fam C
$ sudo /usr/lib/cockpit/cockpit\-certificate\-ensure \-\-check
.fam
.fi
.if n .RE
.sp
در صورت استفاده از \fBcertmonger\fP برای مدیریت گواهی‌ها، می‌توان از دستور زیر برای ایجاد یک جفت گواهی/کلید استفاده کرد:
.sp
.if n .RS 4
.nf
.fam C
CERT_FILE=/etc/cockpit/ws\-certs.d/50\-certmonger.crt
KEY_FILE=/etc/cockpit/ws\-certs.d/50\-certmonger.key

getcert request \-f ${CERT_FILE} \-k ${KEY_FILE} \-D $(hostname \-\-fqdn)
.fam
.fi
.if n .RE
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-\-help\fP
.RS 4
نمایش گزینه‌های راهنما.
.RE
.sp
\fB\-\-port\fP \fIPORT\fP
.RS 4
پاسخ‌گویی به درخواست‌های HTTP روی \fIPORT\fP به جای درگاه ۹۰۹۰. معمولاً Cockpit بر حسب تقاضا توسط فعال‌سازی سوکت \fBsystemd\fP راه‌اندازی می‌شود و این گزینه اثری ندارد. برای تغییر پورت، دستورالعمل \fBListenStream\fP را در فایل \fBcockpit.socket\fP به روش معمول \fBsystemd\fP به‌روزرسانی کنید.
.RE
.sp
\fB\-\-no\-tls\fP
.RS 4
عدم استفاده از TLS. گواهی‌ها خوانده نمی‌شوند و اتصالات https رد خواهند شد. در این حالت \fBcockpit\-tls\fP تنها یک نمونهٔ cockpit\-ws را مدیریت می‌کند و بنابراین عملکرد متفاوتی نسبت به اجرای مستقیم \fBcockpit\-ws \-\-no\-tls\fP نخواهد داشت. از این گزینه فقط برای اشکال‌زدایی یا آزمایش استفاده کنید.
.RE
.sp
\fB\-\-idle\-timeout\fP \fISECONDS\fP
.RS 4
اگر بزرگتر از ۰ باشد، در صورتی که برای تعداد ثانیه‌های مشخص‌شده هیچ اتصالی برقرار نشود (یعنی سرور بیکار باشد)، برنامه خاتمه می‌یابد. در صورت عدم تعیین، مقدار پیش‌فرض ۹۰ ثانیه است.
.RE
.SH "محیط (ENVIRONMENT)"
.sp
برنامهٔ \fBcockpit\-tls\fP انتظار دارد متغیر محیطی \fBRUNTIME_DIRECTORY\fP روی یک دایرکتوری خالی (ترجیحاً در \fB/run/\fP) تنظیم شده باشد که فقط برای کاربر سیستمی اجراکنندهٔ آن قابل دسترسی باشد. این مسیر شامل سوکت‌های یونیکس برای ارتباط با نمونه‌های \fBcockpit\-ws\fP و در آینده، اطلاعات وضعیت مربوط به گواهی‌های کلاینت است. این متغیر معمولاً توسط واحد systemd به نام \fBcockpit.service\fP تنظیم می‌شود.
.sp
علاوه بر این، \fBcockpit\-tls\fP از متغیر محیطی \fBXDG_CONFIG_DIRS\fP برگرفته از \c
.URL "https://specifications.freedesktop.org/basedir\-spec/basedir\-spec\-latest.html" "مشخصات دایرکتوری پایه XDG"
برای یافتن گواهی‌های خود و فایل پیکربندی \fBcockpit.conf\fP(5) استفاده خواهد کرد.
.SH "اشکالات (BUGS)"
.sp
لطفاً گزارش‌های باگ را به سیستم ردیابی باگ توزیع یا به \c
.URL "https://github.com/cockpit\-project/cockpit/issues/new" "ردیاب باگ بالادست"
ارسال کنید.
.SH "نویسنده (AUTHOR)"
.sp
نرم‌افزار Cockpit توسط
.URL "https://github.com/cockpit\-project/cockpit" "مشارکت‌کنندگان"
بسیاری نوشته شده است.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBcockpit\-ws\fP(8) , \fBcockpit.conf\fP(5) , \fBsystemd\fP(1)