'\" t
.\"     Title: cockpit-desktop
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-08-27
.\"    Manual: cockpit
.\"    Source: cockpit
.\"  Language: Persian
.\"
.TH "COCKPIT\-DESKTOP" "1" "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-desktop \- یکپارچه‌سازی میزکار Cockpit
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcockpit\-desktop\fP \fIURLPATH\fP [\fISSH_HOST\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامهٔ \fBcockpit\-desktop\fP دسترسی امن به صفحات Cockpit را در یک نشست فعال میزکار فراهم می‌کند. این ابزار یک وب‌سرور (\fBcockpit\-ws\fP) و یک مرورگر وب را در یک فضای نام شبکهٔ ایزوله‌شده اجرا می‌کند و یک \fBcockpit\-bridge\fP(1) را در نشست کاربر جاری راه‌اندازی می‌نماید.
.sp
این کار از لزوم ورود به Cockpit و فعال‌سازی \fBcockpit.socket\fP در کل سیستم جلوگیری می‌کند. جداسازی شبکه تضمین می‌کند که هیچ کاربر دیگری و حتی سایر فرایندهای نشست کاربر نمی‌توانند به این وب‌سرور محلی دسترسی داشته باشند.
.sp
متغیر \fBURLPATH\fP صفحهٔ Cockpit مورد نظر برای باز شدن است، یعنی بخش مسیر نشانی‌های Cockpit. اکیداً توصیه می‌شود که فقط یک
.URL "https://docs.cockpit\-project.org/cockpit\-guide/latest/guide/embedding.html" "فریم صفحهٔ خاص" ","
باز شود نه کل ناوبری و منوی Cockpit. برای نمونه، مسیر \f(CR/cockpit/@localhost/storage/index.html\fP صفحهٔ فضای ذخیره‌سازی (Storage) را باز می‌کند. همچنین امکان ارائه شکل‌های اختصاری نشانی‌ها وجود دارد، مانند \(lq/storage\(rq یا \(lq/network/firewall\(rq.
.sp
متغیر \fISSH_HOST\fP مشخصهٔ اختیاری میزبان راه دور SSH است (\fIhostname\fP یا \fIusername@hostname\fP). در صورت ارائه، \fBcockpit\-bridge\fP به جای آن روی میزبان راه دور از طریق \fBssh(1)\fP اجرا می‌شود، یعنی مرورگر وب Cockpit آن میزبان راه دور را نشان خواهد داد. توجه داشته باشید که این ویژگی بیشتر جنبهٔ آزمایشی/نمایشی دارد.
.SH "متغیرهای محیطی (ENVIRONMENT)"
.sp
متغیر محیطی \fBBROWSER\fP دستور مرورگر (و احتمالاً گزینه‌های آن) را مشخص می‌کند که برای باز کردن صفحهٔ درخواست‌شدهٔ Cockpit استفاده خواهد شد. در صورت عدم تنظیم، \fBcockpit\-desktop\fP تلاش می‌کند از یک مرورگر درونی و کمینهٔ WebKit استفاده کند، و در صورت شکست، شناسایی برخی گزینه‌های منطقی دیگر را امتحان می‌کند.
.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\-bridge\fP(1)