| w0vncserver(1) | TigerVNC Manual | w0vncserver(1) |
نام (NAME)
w0vncserver - سرور TigerVNC برای کامپوزیتورهای Wayland
خلاصه دستور (SYNOPSIS)
w0vncserver
[گزینه‌ها]
w0vncserver -version
توضیحات (DESCRIPTION)
w0vncserver یک سرور TigerVNC است که امکان دسترسی از راه دور به یک کامپوزیتور Wayland مبتنی بر wlroots یا مجهز به پورتال RemoteDesktop را از طریق VNC، TigerVNC یا نمایش‌دهنده‌های سازگار فراهم می‌کند. این ابزار یک نمایشگر مجازی ایجاد نمی‌کند، بلکه نمایشگر موجود فعلی (معمولاً نمایشگری که به صفحه فیزیکی متصل است) را به اشتراک می‌گذارد.
گزینه‌ها (OPTIONS)
w0vncserver خط فرمان را به‌صورت فهرستی از پارامترها با مقادیر اختیاری تفسیر می‌کند. اجرای w0vncserver -h فهرستی از تمام پارامترهای معتبر را همراه با توضیحات کوتاه نمایش می‌دهد. همه پارامترها اختیاری هستند، اما معمولاً باید از پارامتر PasswordFile استفاده کنید (توضیحات آن را در ادامه ببینید).
چندین روش برای تعیین پارامترها در خط فرمان وجود دارد (در اینجا ما از «SomeParameter» به عنوان نام نمونه پارامتر استفاده می‌کنیم):
- -SomeParameter
- فعال کردن پارامتر، روشن کردن ویژگی. این شیوه می‌تواند برای پارامترهایی استفاده شود که صرفاً ویژگی خاصی را فعال یا غیرفعال می‌کنند.
- -SomeParameter=0
- غیرفعال کردن پارامتر، خاموش کردن ویژگی.
- -SomeParameter=value
- اختصاص مقدار مشخص‌شده value به پارامتر. خط تیره ابتدایی می‌تواند حذف شود، یا در صورت تمایل دو برابر گردد (مانند گزینه‌های طولانی در سبک GNU).
نام پارامترها به حروف بزرگ و کوچک حساس نیست و ترتیب قرارگیری آنها در خط فرمان می‌تواند دلخواه باشد.
پارامترها (PARAMETERS)
- -AcceptKeyEvents
- پذیرش رویدادهای فشرده شدن و رها کردن کلیدها از سمت کلاینت‌ها. پیش‌فرض فعال است.
- -AcceptPointerEvents
- پذیرش رویدادهای حرکت نشانگر و دکمه‌های ماوس از سمت کلاینت‌ها. پیش‌فرض فعال است.
- همیشه اتصال‌های ورودی را، صرف‌نظر از تنظیمات مشخص‌شده توسط کلاینت، به‌صورت اشتراکی در نظر بگیرد. پیش‌فرض غیرفعال است.
- -BlacklistThreshold count
- تعداد دفعات مجاز تلاش برای اتصال بدون احراز هویت از سوی هر میزبان، پیش از قرار گرفتن آن میزبان در فهرست سیاه (black-list). پیش‌فرض 5 است.
- -BlacklistTimeout seconds
- مدت‌زمان وقفه اولیه که با اولین ورود یک میزبان به فهرست سیاه اعمال می‌شود. میزبان تا زمان پایان این مهلت نمی‌تواند مجدداً برای اتصال تلاش کند. پیش‌فرض 10 است.
- -CompareFB mode
- انجام مقایسه پیکسل‌ها روی فریم‌بافر به منظور کاهش به‌روزرسانی‌های غیرضروری. می‌تواند 0 (غیرفعال)، 1 (همیشه) یا 2 (خودکار) باشد. پیش‌فرض 2 است.
- -desktop desktop-name
- هر میزکار نامی دارد که ممکن است توسط بیننده (viewer) نمایش داده شود. مقدار پیش‌فرض آن "<user>@<hostname>" است.
- -DisconnectClients
- قطع اتصال کلاینت‌های فعلی در صورت ورود یک اتصال غیراشتراکی. پیش‌فرض فعال است. اگر DisconnectClients غیرفعال باشد، تا زمانی که یک کلاینت فعال وجود دارد، اتصال غیراشتراکی جدید رد خواهد شد. در صورت ترکیب با NeverShared، این بدان معناست که در هر زمان تنها یک کلاینت مجاز است.
- -FrameRate fps
- حداکثر تعداد به‌روزرسانی‌های ارسالی در هر ثانیه به هر کلاینت. اگر صفحه نمایش سریع‌تر به‌روز شود، آن تغییرات تجمیع شده و در قالب یک به‌روزرسانی واحد به کلاینت فرستاده می‌شوند. توجه داشته باشید که این گزینه فقط حداکثر نرخ را تعیین می‌کند و کلاینت ممکن است در شرایط محدودیت منابع، نرخ پایین‌تری دریافت کند. پیش‌فرض 60 است.
- -GnuTLSPriority priority
- رشته اولویت GnuTLS که الگوریتم‌های دست‌تکانی (handshake) نشست TLS را کنترل می‌کند. برای مشاهده مقادیر مجاز به راهنمای GnuTLS مراجعه کنید. پیش‌فرض NORMAL است.
- -IdleTimeout seconds
- تعداد ثانیه‌هایی که پس از آن یک اتصال VNC بدون فعالیت قطع خواهد شد. پیش‌فرض 0 است، به این معنی که اتصال‌های بدون فعالیت هرگز قطع نخواهند شد.
- -ImprovedHextile
- استفاده از الگوریتم فشرده‌سازی بهبودیافته برای کدگذاری Hextile که نرخ فشرده‌سازی بهتری را به بهای مصرف اندکی زمان پردازنده (CPU) بیشتر به دست می‌آورد. پیش‌فرض فعال است.
- -interface IP address
- شنود روی رابط شبکه مشخص‌شده. به‌طور پیش‌فرض w0vncserver روی تمام رابط‌های شبکه موجود شنود می‌کند.
- -localhost
- فقط اجازه اتصال از همان رایانه را می‌دهد. این قابلیت زمانی مفید است که از SSH استفاده می‌کنید و می‌خواهید اتصالات غیر SSH را از سایر میزبان‌ها مسدود کنید.
- -Log logname:dest:level[, ...]
- تنظیمات لاگ اشکال‌زدایی را پیکربندی می‌کند. dest در حال حاضر می‌تواند stderr، stdout یا syslog باشد، و level عددی بین 0 تا 100 است که 100 به معنای پرجزئیات‌ترین خروجی است. logname معمولاً * به معنای همه است، اما در صورت دانستن نام "LogWriter" می‌توانید یک فایل مبدأ خاص را هدف قرار دهید. پیش‌فرض *:stderr:30 است.
- -MaxConnectionTime seconds
- خاتمه دادن به کار برنامه زمانی که یک کلاینت به مدت N ثانیه متصل بوده است. پیش‌فرض 0 است.
- -MaxDisconnectionTime seconds
- خاتمه دادن به کار برنامه زمانی که هیچ کلاینتی به مدت N ثانیه متصل نبوده است. پیش‌فرض 0 است.
- -MaxIdleTime seconds
- خاتمه دادن به کار برنامه پس از N ثانیه عدم فعالیت کاربر. پیش‌فرض 0 است.
- هرگز اتصال‌های ورودی را، صرف‌نظر از تنظیمات مشخص‌شده توسط کلاینت، به‌صورت اشتراکی در نظر نگیرد. پیش‌فرض غیرفعال است.
- -pam_service name, -PAMService name
- نام سرویس PAM مورد استفاده در احراز هویت کاربران هنگام استفاده از هر یک از انواع امنیتی "Plain". پیش‌فرض vnc است.
- -Password password
- کدگذاری دودویی مبهم‌شده از گذرواژه‌ای که کلاینت‌ها باید برای دسترسی به سرور ارائه دهند. استفاده از این پارامتر ناامن است؛ به‌جای آن از پارامتر PasswordFile استفاده کنید.
- -PasswordFile passwd-file, -rfbauth passwd-file
- فایل گذرواژه برای احراز هویت VNC. هیچ پیش‌فرضی وجود ندارد و باید فایل گذرواژه را صراحتاً مشخص کنید. این فایل باید با ابزار vncpasswd(1) ایجاد شود. فایل گذرواژه با هر بار برقراری اتصال خوانده می‌شود، بنابراین می‌توان آن را به‌طور زنده تغییر داد.
- -PlainUsers user-list
- فهرستی جداشده با کاما از نام‌های کاربری که مجاز به احراز هویت از طریق هر یک از انواع امنیتی "Plain" (مانند Plain، TLSPlain و غیره) هستند. مقدار * را برای مجاز کردن تمامی کاربران جهت احراز هویت با این نوع امنیتی تعیین کنید. مقدار %u را برای مجاز کردن کاربرِ فرایند سرور وارد کنید. پیش‌فرض، رد کردن تمام کاربران است.
- -Protocol3.3
- استفاده همیشگی از پروتکل نسخه 3.3 جهت سازگاری عقروعلی با کلاینت‌های ناسازگار یا قدیمی. پیش‌فرض غیرفعال است.
- -QueryConnect
- از کاربر میزکار می‌خواهد تا اتصالات ورودی را صراحتاً بپذیرد یا رد کند. پیش‌فرض غیرفعال است.
- -RawKeyboard
- ارسال مستقیم رویدادهای صفحه‌کلید بدون نگاشت آنها به چیدمان فعلی صفحه‌کلید. این کار باعث می‌شود صفحه‌کلید بر اساس چیدمان پیکربندی‌شده روی سرور رفتار کند، نه چیدمان تنظیم‌شده در سمت کلاینت. پیش‌فرض غیرفعال است.
- -RemapKeys mapping
- تنظیم نگاشت کلیدهای صفحه‌کلید. mapping رشته‌ای جداشده با کاما از نگاشت نویسه‌ها به صورت char->char یا char<>char است، که در آن char یک keysym در مبنای شانزده (hexadecimal) است. برای مثال، جهت جابجایی نمادهای " و @ می‌توانید مقدار زیر را مشخص کنید:
- -RememberDisplayChoice mode
- به خاطر سپردن انتخاب نمایشگر هنگام اتصال کاربر. می‌تواند یکی از مقادیر Always، Never یا Session باشد. انتخاب Never بدین معناست که با هر بار اتصال کاربر به سرور، یک پنجره اعلان نمایش داده می‌شود. Session یعنی اعلان فقط یک بار در طول اجرای برنامه نشان داده خواهد شد. با انتخاب Always، انتخاب شما به خاطر سپرده شده و ماندگار می‌شود. جهت بازنشانی انتخاب خود، به w0vncserver-forget(1) مراجعه کنید. پیش‌فرض Session است.
- -RequireUsername
- الزام وارد کردن نام کاربری برای انواع امنیتی RSA-AES. پیش‌فرض غیرفعال است.
- -rfbport port
- پورت TCP را تعیین می‌کند که w0vncserver روی آن برای دریافت اتصالات از بیننده‌ها شنود می‌کند (پروتکل مورد استفاده در VNC، RFB یا "remote framebuffer" نام دارد). برای غیرفعال کردن شنود روی پورت TCP مقدار -1 را مشخص کنید. پورت پیش‌فرض در صورت اجرای مستقیم 5900 است، و هنگامی که توسط سوکت systemd فعال شود برابر با -1 خواهد بود.
- -rfbunixmode mode
- حالت دسترسی (mode) سوکت دامنه یونیکس (Unix domain socket) را مشخص می‌کند. پیش‌فرض 0600 است.
- -rfbunixpath path
- مسیر سوکت دامنه یونیکس را مشخص می‌کند که w0vncserver روی آن برای دریافت اتصالات از بیننده‌ها شنود می‌کند. پیش‌فرض، عدم شنود روی هیچ سوکت دامنه یونیکسی است.
- -RSAKey path
- مسیر کلید RSA برای انواع امنیتی RSA-AES (RA2، RA2ne، RA2_256 و RA2ne_256) در قالب PEM.
- -SecurityTypes sec-types
- طرح امنیتی مورد استفاده برای اتصالات ورودی را تعیین می‌کند. مقادیر معتبر فهرستی جداشده با کاما از None، VncAuth، Plain، TLSNone، TLSVnc، TLSPlain، X509None، X509Vnc، X509Plain، RA2، RA2ne، RA2_256 و RA2ne_256 هستند. مقدار پیش‌فرض TLSVnc,VncAuth است.
- -UseBlacklist
- رد موقت اتصالات یک میزبان در صورتی که به طور متوالی در احراز هویت با شکست مواجه شود. پیش‌فرض فعال است.
- -UseIPv4
- استفاده از IPv4 برای اتصالات ورودی و خروجی. پیش‌فرض فعال است.
- -UseIPv6
- استفاده از IPv6 برای اتصالات ورودی و خروجی. پیش‌فرض فعال است.
- -X509Cert path
- مسیر گواهی X509 در قالب PEM که برای تمامی انواع امنیتی مبتنی بر X509 (X509None، X509Vnc و غیره) استفاده می‌شود.
- -X509Key path
- کلید خصوصی متناظر با گواهی ارائه‌شده در X509Cert. این کلید نیز باید در قالب PEM باشد.
همچنین ببینید (SEE ALSO)
w0vncserver-forget(1), x0vncserver(1),
Xvnc(1), vncpasswd(1),
https://www.tigervnc.org
نویسندگان (AUTHORS)
تیم TigerVNC
پروتکل VNC در ابتدا توسط تیم RealVNC در Olivetti Research Ltd / AT&T Laboratories Cambridge توسعه داده شد. قابلیت‌های افزوده TightVNC توسط Constantin Kaplinsky پیاده‌سازی شدند. از آن زمان افراد بسیار دیگری در توسعه، آزمایش و پشتیبانی آن مشارکت داشته‌اند. این راهنما بخشی از مجموعه نرم‌افزاری TigerVNC است.
| TigerVNC |