'\" t
.\"     Title: cockpit-ws
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-08-27
.\"    Manual: cockpit
.\"    Source: cockpit
.\"  Language: Persian
.\"
.TH "COCKPIT\-WS" "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-ws \- وب‌سرویس کاک‌پیت
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcockpit\-ws\fP [\fB\-\-help\fP] [\fB\-\-port\fP \fIPORT\fP] [\fB\-\-address\fP \fIADDRESS\fP] [\fB\-\-no\-tls\fP]
[\fB\-\-for\-tls\-proxy\fP] [\fB\-\-local\-ssh\fP] [\fB\-\-local\-session\fP \fIBRIDGE\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBcockpit\-ws\fP جزء وب‌سرویس است که برای ارتباط میان برنامه مرورگر و ابزارها و سرویس‌های مختلف پیکربندی مانند \fBcockpit\-bridge\fP(1) استفاده می‌شود.
.sp
کاربران یا مدیران سیستم معمولاً نیازی به اجرای مستقیم این برنامه ندارند، زیرا هنگام راه‌اندازی سیستم (boot up) به‌طور خودکار توسط \fBsystemd\fP(1) و از طریق \fBcockpit\-tls\fP(8) شروع به کار می‌کند.
.SH "امنیت لایه انتقال (TRANSPORT SECURITY)"
.sp
\fBcockpit\-ws\fP معمولاً در پشت پروکسی پایان‌دهنده TLS به نام \fBcockpit\-tls\fP اجرا می‌شود و به خودی خود فقط با HTTP رمزگذاری‌نشده کار می‌کند. اما به منظور سازگاری با گذشته (backwards compatibility)، در صورت اجرای مستقیم می‌تواند اتصالات TLS را نیز خودش مدیریت کند. برای جزئیات نحوه پیکربندی گواهی‌ها، لطفاً به مستندات \fBcockpit\-tls\fP(8) مراجعه کنید.
.SH "مهلت زمانی (TIMEOUT)"
.sp
هنگامی که \fBcockpit\-ws\fP از طریق \fBsystemd\fP(1) راه‌اندازی می‌شود، در صورتی که هیچ کاربری وارد سیستم نشود یا پس از قطع اتصال آخرین کاربر، پس از ۹۰ ثانیه خارج خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-\-help\fP
.RS 4
نمایش گزینه‌های راهنما.
.RE
.sp
\fB\-\-port\fP \fIPORT\fP
.RS 4
پاسخ‌گویی به درخواست‌های HTTP روی پورت \fIPORT\fP به جای پورت \fB9090\fP. معمولاً کاک‌پیت بر اساس تقاضا توسط فعال‌سازی سوکت \fBsystemd\fP راه‌اندازی می‌شود و این گزینه اثری ندارد. در این صورت، دستورالعمل \fBListenStream\fP را در فایل \fBcockpit.socket\fP به روش معمول \fBsystemd\fP به‌روزرسانی کنید.
.RE
.sp
\fB\-\-address\fP \fIADDRESS\fP
.RS 4
اتصال (Bind) به آدرس \fIADDRESS\fP به جای اتصال به همه آدرس‌های موجود. معمولاً کاک‌پیت بر اساس تقاضا توسط فعال‌سازی سوکت \fBsystemd\fP راه‌اندازی می‌شود و این گزینه اثری ندارد. در این حالت، دستورالعمل \fBListenStream\fP را در فایل \fBcockpit.socket\fP به روش معمول \fBsystemd\fP به‌روزرسانی کنید.
.RE
.sp
\fB\-\-no\-tls\fP
.RS 4
غیرفعال کردن تغییر مسیر خودکار از http به https.
.RE
.sp
\fB\-\-for\-tls\-proxy\fP
.RS 4
به \fBcockpit\-ws\fP اعلام می‌کند که در پشت یک پروکسی معکوس محلی که پایان‌دهی TLS را انجام می‌دهد در حال اجرا است. در این حالت، کاک‌پیت URLهای https:// را در \fBContent\-Security\-Policy\fP پیش‌فرض قرار می‌دهد و به‌طور پیش‌فرض فقط مبداهای https:// را به جای http: می‌پذیرد. با این حال، اگر \fBOrigins\fP در فایل پیکربندی \fBcockpit.conf\fP(5) تنظیم شده باشد، این پیش‌فرض را بازنویسی (override) خواهد کرد.
.RE
.sp
\fB\-\-local\-ssh\fP
.RS 4
به‌طور معمول \fBcockpit\-ws\fP از \fBcockpit\-session\fP و PAM برای احراز هویت کاربر و شروع نشست کاربر استفاده می‌کند. با فعال بودن این گزینه، احراز هویت به جای آن از طریق SSH روی آدرس \fB127.0.0.1\fP و پورت \fB22\fP انجام می‌شود.
.RE
.sp
\fB\-\-local\-session\fP \fIBRIDGE\fP
.RS 4
صرف‌نظر کردن از تمام مراحل احراز هویت و \fBcockpit\-session\fP، و اجرای \fBcockpit\-bridge\fP مشخص‌شده در \fIBRIDGE\fP در نشست محلی. اگر \fIBRIDGE\fP به‌صورت \f(CR\-\fP مشخص شود، انتظار یک بریج از پیش در حال اجرا را دارد که به ورودی و خروجی استاندارد (stdin و stdout) این فرایند \fBcockpit\-ws\fP متصل است. این امر به وب‌سرور اجازه می‌دهد تا به عنوان هر کاربر بدون امتیاز (unprivileged) در یک نشست از پیش در حال اجرا، اجرا شود.
.br

.br
این حالت مستلزم \fB\-\-no\-tls\fP است، بنابراین همراه با آن باید از نشانی‌های http:// استفاده کنید.
.RE
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B هشدار (Warning)
.ps -1
.br
.sp
همراه با \fB\-\-local\-session\fP \fIBRIDGE\fP، شما \fIباید پورت باز شده TCP را به گونه‌ای ایزوله و جداسازی کنید\fP (برای نمونه در یک فضای نام شبکه یا network namespace)، در غیر این صورت سایر کاربران (یا حتی ماشین‌های راه دور اگر پورت فقط روی localhost شنود نکند) می‌توانند به این نشست دسترسی پیدا کنند!
.sp .5v
.RE
.SH "محیط (ENVIRONMENT)"
.sp
فرایند \fBcockpit\-ws\fP از متغیر محیطی \fBXDG_CONFIG_DIRS\fP برگرفته از \c
.URL "https://specifications.freedesktop.org/basedir\-spec/basedir\-spec\-latest.html" "مشخصات دایرکتوری پایه XDG"
برای یافتن فایل پیکربندی \fBcockpit.conf\fP(5) خود استفاده می‌کند.
.sp
علاوه بر این، متغیر محیطی \fBXDG_DATA_DIRS\fP برگرفته از \c
.URL "https://specifications.freedesktop.org/basedir\-spec/basedir\-spec\-latest.html" "مشخصات دایرکتوری پایه XDG"
می‌تواند برای بازنویسی مکان ارائه فایل‌های استاتیک استفاده شود. این‌ها فایل‌هایی هستند که به کاربر واردنشده به سیستم ارائه می‌شوند.
.SH "اشکالات (BUGS)"
.sp
لطفاً گزارش‌های اشکال را به سیستم ردیابی اشکال توزیع یا به \c
.URL "https://github.com/cockpit\-project/cockpit/issues/new" "ردیاب اشکالات بالادست" "."
.SH "نویسنده (AUTHOR)"
.sp
کاک‌پیت توسط \c
.URL "https://github.com/cockpit\-project/cockpit" "مشارکت‌کنندگان" " "
بسیاری نوشته شده است.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBcockpit\-tls\fP(8) , \fBcockpit.conf\fP(5) , \fBsystemd\fP(1)