نام (NAME)

cockpit-ws - وب‌سرویس کاک‌پیت

خلاصه دستور (SYNOPSIS)

cockpit-ws [--help] [--port PORT] [--address ADDRESS] [--no-tls] [--for-tls-proxy] [--local-ssh] [--local-session BRIDGE]

توضیحات (DESCRIPTION)

برنامه cockpit-ws جزء وب‌سرویس است که برای ارتباط میان برنامه مرورگر و ابزارها و سرویس‌های مختلف پیکربندی مانند cockpit-bridge(1) استفاده می‌شود.

کاربران یا مدیران سیستم معمولاً نیازی به اجرای مستقیم این برنامه ندارند، زیرا هنگام راه‌اندازی سیستم (boot up) به‌طور خودکار توسط systemd(1) و از طریق cockpit-tls(8) شروع به کار می‌کند.

امنیت لایه انتقال (TRANSPORT SECURITY)

cockpit-ws معمولاً در پشت پروکسی پایان‌دهنده TLS به نام cockpit-tls اجرا می‌شود و به خودی خود فقط با HTTP رمزگذاری‌نشده کار می‌کند. اما به منظور سازگاری با گذشته (backwards compatibility)، در صورت اجرای مستقیم می‌تواند اتصالات TLS را نیز خودش مدیریت کند. برای جزئیات نحوه پیکربندی گواهی‌ها، لطفاً به مستندات cockpit-tls(8) مراجعه کنید.

مهلت زمانی (TIMEOUT)

هنگامی که cockpit-ws از طریق systemd(1) راه‌اندازی می‌شود، در صورتی که هیچ کاربری وارد سیستم نشود یا پس از قطع اتصال آخرین کاربر، پس از ۹۰ ثانیه خارج خواهد شد.

گزینه‌ها (OPTIONS)

--help

نمایش گزینه‌های راهنما.

--port PORT

پاسخ‌گویی به درخواست‌های HTTP روی پورت PORT به جای پورت 9090. معمولاً کاک‌پیت بر اساس تقاضا توسط فعال‌سازی سوکت systemd راه‌اندازی می‌شود و این گزینه اثری ندارد. در این صورت، دستورالعمل ListenStream را در فایل cockpit.socket به روش معمول systemd به‌روزرسانی کنید.

--address ADDRESS

اتصال (Bind) به آدرس ADDRESS به جای اتصال به همه آدرس‌های موجود. معمولاً کاک‌پیت بر اساس تقاضا توسط فعال‌سازی سوکت systemd راه‌اندازی می‌شود و این گزینه اثری ندارد. در این حالت، دستورالعمل ListenStream را در فایل cockpit.socket به روش معمول systemd به‌روزرسانی کنید.

--no-tls

غیرفعال کردن تغییر مسیر خودکار از http به https.

--for-tls-proxy

به cockpit-ws اعلام می‌کند که در پشت یک پروکسی معکوس محلی که پایان‌دهی TLS را انجام می‌دهد در حال اجرا است. در این حالت، کاک‌پیت URLهای https:// را در Content-Security-Policy پیش‌فرض قرار می‌دهد و به‌طور پیش‌فرض فقط مبداهای https:// را به جای http: می‌پذیرد. با این حال، اگر Origins در فایل پیکربندی cockpit.conf(5) تنظیم شده باشد، این پیش‌فرض را بازنویسی (override) خواهد کرد.

--local-ssh

به‌طور معمول cockpit-ws از cockpit-session و PAM برای احراز هویت کاربر و شروع نشست کاربر استفاده می‌کند. با فعال بودن این گزینه، احراز هویت به جای آن از طریق SSH روی آدرس 127.0.0.1 و پورت 22 انجام می‌شود.

--local-session BRIDGE

صرف‌نظر کردن از تمام مراحل احراز هویت و cockpit-session، و اجرای cockpit-bridge مشخص‌شده در BRIDGE در نشست محلی. اگر BRIDGE به‌صورت - مشخص شود، انتظار یک بریج از پیش در حال اجرا را دارد که به ورودی و خروجی استاندارد (stdin و stdout) این فرایند cockpit-ws متصل است. این امر به وب‌سرور اجازه می‌دهد تا به عنوان هر کاربر بدون امتیاز (unprivileged) در یک نشست از پیش در حال اجرا، اجرا شود.

این حالت مستلزم --no-tls است، بنابراین همراه با آن باید از نشانی‌های http:// استفاده کنید.

هشدار (Warning)

همراه با --local-session BRIDGE، شما باید پورت باز شده TCP را به گونه‌ای ایزوله و جداسازی کنید (برای نمونه در یک فضای نام شبکه یا network namespace)، در غیر این صورت سایر کاربران (یا حتی ماشین‌های راه دور اگر پورت فقط روی localhost شنود نکند) می‌توانند به این نشست دسترسی پیدا کنند!

محیط (ENVIRONMENT)

فرایند cockpit-ws از متغیر محیطی XDG_CONFIG_DIRS برگرفته از مشخصات دایرکتوری پایه XDG https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html برای یافتن فایل پیکربندی cockpit.conf(5) خود استفاده می‌کند.

علاوه بر این، متغیر محیطی XDG_DATA_DIRS برگرفته از مشخصات دایرکتوری پایه XDG https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html می‌تواند برای بازنویسی مکان ارائه فایل‌های استاتیک استفاده شود. این‌ها فایل‌هایی هستند که به کاربر واردنشده به سیستم ارائه می‌شوند.

اشکالات (BUGS)

لطفاً گزارش‌های اشکال را به سیستم ردیابی اشکال توزیع یا به ردیاب اشکالات بالادست https://github.com/cockpit-project/cockpit/issues/new.

نویسنده (AUTHOR)

کاک‌پیت توسط مشارکت‌کنندگان https://github.com/cockpit-project/cockpit بسیاری نوشته شده است.

همچنین ببینید (SEE ALSO)

cockpit-tls(8) , cockpit.conf(5) , systemd(1)