.TH w0vncserver 1 "" "TigerVNC" "TigerVNC Manual"
.SH "نام (NAME)"
w0vncserver \- سرور TigerVNC برای کامپوزیتورهای Wayland
.SH "خلاصه دستور (SYNOPSIS)"
.B w0vncserver
.RI [ گزینه‌ها ]
.br
.B w0vncserver -version
.SH "توضیحات (DESCRIPTION)"
.B w0vncserver
یک سرور TigerVNC است که امکان دسترسی از راه دور به یک کامپوزیتور Wayland مبتنی بر wlroots یا مجهز به پورتال RemoteDesktop را از طریق VNC،‏ TigerVNC یا نمایش‌دهنده‌های سازگار فراهم می‌کند. این ابزار یک نمایشگر مجازی ایجاد نمی‌کند، بلکه نمایشگر موجود فعلی (معمولاً نمایشگری که به صفحه فیزیکی متصل است) را به اشتراک می‌گذارد.

.SH "گزینه‌ها (OPTIONS)"
.B w0vncserver
خط فرمان را به‌صورت فهرستی از پارامترها با مقادیر اختیاری تفسیر می‌کند.
اجرای \fBw0vncserver \-h\fP فهرستی از تمام پارامترهای معتبر را همراه با توضیحات کوتاه نمایش می‌دهد. همه پارامترها اختیاری هستند، اما معمولاً باید از پارامتر \fBPasswordFile\fP استفاده کنید (توضیحات آن را در ادامه ببینید).
.PP
چندین روش برای تعیین پارامترها در خط فرمان وجود دارد (در اینجا ما از «\fISomeParameter\fP» به عنوان نام نمونه پارامتر استفاده می‌کنیم):

.TP
.B -\fISomeParameter\fP
فعال کردن پارامتر، روشن کردن ویژگی. این شیوه می‌تواند برای پارامترهایی استفاده شود که صرفاً ویژگی خاصی را فعال یا غیرفعال می‌کنند.
.
.TP
.B -\fISomeParameter\fP=0
غیرفعال کردن پارامتر، خاموش کردن ویژگی.
.
.TP
.B -\fISomeParameter\fP=\fIvalue\fP
اختصاص مقدار مشخص‌شده \fIvalue\fP به پارامتر. خط تیره ابتدایی می‌تواند حذف شود، یا در صورت تمایل دو برابر گردد (مانند گزینه‌های طولانی در سبک GNU).
.PP
نام پارامترها به حروف بزرگ و کوچک حساس نیست و ترتیب قرارگیری آنها در خط فرمان می‌تواند دلخواه باشد.

.SH "پارامترها (PARAMETERS)"

.TP
.B \-AcceptKeyEvents
پذیرش رویدادهای فشرده شدن و رها کردن کلیدها از سمت کلاینت‌ها. پیش‌فرض فعال است.
.
.TP
.B \-AcceptPointerEvents
پذیرش رویدادهای حرکت نشانگر و دکمه‌های ماوس از سمت کلاینت‌ها. پیش‌فرض فعال است.
.
.TP
.B \-AlwaysShared
همیشه اتصال‌های ورودی را، صرف‌نظر از تنظیمات مشخص‌شده توسط کلاینت، به‌صورت اشتراکی در نظر بگیرد. پیش‌فرض غیرفعال است.
.
.TP
.B \-BlacklistThreshold \fIcount\fP
تعداد دفعات مجاز تلاش برای اتصال بدون احراز هویت از سوی هر میزبان، پیش از قرار گرفتن آن میزبان در فهرست سیاه (black-list). پیش‌فرض 5 است.
.
.TP
.B \-BlacklistTimeout \fIseconds\fP
مدت‌زمان وقفه اولیه که با اولین ورود یک میزبان به فهرست سیاه اعمال می‌شود. میزبان تا زمان پایان این مهلت نمی‌تواند مجدداً برای اتصال تلاش کند. پیش‌فرض 10 است.
.
.TP
.B \-CompareFB \fImode\fP
انجام مقایسه پیکسل‌ها روی فریم‌بافر به منظور کاهش به‌روزرسانی‌های غیرضروری. می‌تواند \fB0\fP (غیرفعال)، \fB1\fP (همیشه) یا \fB2\fP (خودکار) باشد. پیش‌فرض \fB2\fP است.
.
.TP
.B \-desktop \fIdesktop-name\fP
هر میزکار نامی دارد که ممکن است توسط بیننده (viewer) نمایش داده شود. مقدار پیش‌فرض آن "<user>@<hostname>" است.
.
.TP
.B \-DisconnectClients
قطع اتصال کلاینت‌های فعلی در صورت ورود یک اتصال غیراشتراکی. پیش‌فرض فعال است. اگر \fBDisconnectClients\fP غیرفعال باشد، تا زمانی که یک کلاینت فعال وجود دارد، اتصال غیراشتراکی جدید رد خواهد شد. در صورت ترکیب با \fBNeverShared\fP، این بدان معناست که در هر زمان تنها یک کلاینت مجاز است.
.
.TP
.B \-FrameRate \fIfps\fP
حداکثر تعداد به‌روزرسانی‌های ارسالی در هر ثانیه به هر کلاینت. اگر صفحه نمایش سریع‌تر به‌روز شود، آن تغییرات تجمیع شده و در قالب یک به‌روزرسانی واحد به کلاینت فرستاده می‌شوند. توجه داشته باشید که این گزینه فقط حداکثر نرخ را تعیین می‌کند و کلاینت ممکن است در شرایط محدودیت منابع، نرخ پایین‌تری دریافت کند. پیش‌فرض \fB60\fP است.
.
.TP
.B \-GnuTLSPriority \fIpriority\fP
رشته اولویت GnuTLS که الگوریتم‌های دست‌تکانی (handshake) نشست TLS را کنترل می‌کند. برای مشاهده مقادیر مجاز به راهنمای GnuTLS مراجعه کنید. پیش‌فرض \fBNORMAL\fP است.
.
.TP
.B \-IdleTimeout \fIseconds\fP
تعداد ثانیه‌هایی که پس از آن یک اتصال VNC بدون فعالیت قطع خواهد شد. پیش‌فرض 0 است، به این معنی که اتصال‌های بدون فعالیت هرگز قطع نخواهند شد.
.
.TP
.B \-ImprovedHextile
استفاده از الگوریتم فشرده‌سازی بهبودیافته برای کدگذاری Hextile که نرخ فشرده‌سازی بهتری را به بهای مصرف اندکی زمان پردازنده (CPU) بیشتر به دست می‌آورد. پیش‌فرض فعال است.
.
.TP
.B \-interface \fIIP address\fP
شنود روی رابط شبکه مشخص‌شده. به‌طور پیش‌فرض w0vncserver روی تمام رابط‌های شبکه موجود شنود می‌کند.
.
.TP
.B \-localhost
فقط اجازه اتصال از همان رایانه را می‌دهد. این قابلیت زمانی مفید است که از SSH استفاده می‌کنید و می‌خواهید اتصالات غیر SSH را از سایر میزبان‌ها مسدود کنید.
.
.TP
.B \-Log \fIlogname\fP:\fIdest\fP:\fIlevel\fP[, ...]
تنظیمات لاگ اشکال‌زدایی را پیکربندی می‌کند. \fIdest\fP در حال حاضر می‌تواند \fBstderr\fP، \fBstdout\fP یا \fBsyslog\fP باشد، و \fIlevel\fP عددی بین 0 تا 100 است که 100 به معنای پرجزئیات‌ترین خروجی است. \fIlogname\fP معمولاً \fB*\fP به معنای همه است، اما در صورت دانستن نام "LogWriter" می‌توانید یک فایل مبدأ خاص را هدف قرار دهید. پیش‌فرض \fB*:stderr:30\fP است.
.
.TP
.B \-MaxConnectionTime \fIseconds\fP
خاتمه دادن به کار برنامه زمانی که یک کلاینت به مدت \fIN\fP ثانیه متصل بوده است. پیش‌فرض 0 است.
.
.TP
.B \-MaxDisconnectionTime \fIseconds\fP
خاتمه دادن به کار برنامه زمانی که هیچ کلاینتی به مدت \fIN\fP ثانیه متصل نبوده است. پیش‌فرض 0 است.
.
.TP
.B \-MaxIdleTime \fIseconds\fP
خاتمه دادن به کار برنامه پس از \fIN\fP ثانیه عدم فعالیت کاربر. پیش‌فرض 0 است.
.
.TP
.B \-NeverShared
هرگز اتصال‌های ورودی را، صرف‌نظر از تنظیمات مشخص‌شده توسط کلاینت، به‌صورت اشتراکی در نظر نگیرد. پیش‌فرض غیرفعال است.
.
.TP
.B \-pam_service \fIname\fP, \-PAMService \fIname\fP
نام سرویس PAM مورد استفاده در احراز هویت کاربران هنگام استفاده از هر یک از انواع امنیتی "Plain". پیش‌فرض \fBvnc\fP است.
.
.TP
.B \-Password \fIpassword\fP
کدگذاری دودویی مبهم‌شده از گذرواژه‌ای که کلاینت‌ها باید برای دسترسی به سرور ارائه دهند. استفاده از این پارامتر ناامن است؛ به‌جای آن از پارامتر \fBPasswordFile\fP استفاده کنید.
.
.TP
.B \-PasswordFile \fIpasswd-file\fP, \-rfbauth \fIpasswd-file\fP
فایل گذرواژه برای احراز هویت VNC. هیچ پیش‌فرضی وجود ندارد و باید فایل گذرواژه را صراحتاً مشخص کنید. این فایل باید با ابزار \fBvncpasswd\fP(1) ایجاد شود. فایل گذرواژه با هر بار برقراری اتصال خوانده می‌شود، بنابراین می‌توان آن را به‌طور زنده تغییر داد.
.
.TP
.B \-PlainUsers \fIuser-list\fP
فهرستی جداشده با کاما از نام‌های کاربری که مجاز به احراز هویت از طریق هر یک از انواع امنیتی "Plain" (مانند Plain،‏ TLSPlain و غیره) هستند. مقدار \fB*\fP را برای مجاز کردن تمامی کاربران جهت احراز هویت با این نوع امنیتی تعیین کنید. مقدار \fB%u\fP را برای مجاز کردن کاربرِ فرایند سرور وارد کنید. پیش‌فرض، رد کردن تمام کاربران است.
.
.TP
.B \-Protocol3.3
استفاده همیشگی از پروتکل نسخه 3.3 جهت سازگاری عقروعلی با کلاینت‌های ناسازگار یا قدیمی. پیش‌فرض غیرفعال است.
.
.TP
.B \-QueryConnect
از کاربر میزکار می‌خواهد تا اتصالات ورودی را صراحتاً بپذیرد یا رد کند. پیش‌فرض غیرفعال است.
.
.TP
.B \-RawKeyboard
ارسال مستقیم رویدادهای صفحه‌کلید بدون نگاشت آنها به چیدمان فعلی صفحه‌کلید. این کار باعث می‌شود صفحه‌کلید بر اساس چیدمان پیکربندی‌شده روی سرور رفتار کند، نه چیدمان تنظیم‌شده در سمت کلاینت. پیش‌فرض غیرفعال است.
.
.TP
.B \-RemapKeys \fImapping
تنظیم نگاشت کلیدهای صفحه‌کلید.
.I mapping
رشته‌ای جداشده با کاما از نگاشت نویسه‌ها به صورت
.IR char -> char
یا
.IR char <> char
است، که در آن
.I char
یک keysym در مبنای شانزده (hexadecimal) است. برای مثال، جهت جابجایی نمادهای " و @ می‌توانید مقدار زیر را مشخص کنید:

.RS 10
RemapKeys=0x22<>0x40
.RE
.
.TP
.B \-RememberDisplayChoice \fImode\fP
به خاطر سپردن انتخاب نمایشگر هنگام اتصال کاربر. می‌تواند یکی از مقادیر
\fBAlways\fP، \fBNever\fP یا \fBSession\fP باشد. انتخاب \fBNever\fP بدین معناست که با هر بار اتصال کاربر به سرور، یک پنجره اعلان نمایش داده می‌شود. \fBSession\fP یعنی اعلان فقط یک بار در طول اجرای برنامه نشان داده خواهد شد. با انتخاب \fBAlways\fP، انتخاب شما به خاطر سپرده شده و ماندگار می‌شود. جهت بازنشانی انتخاب خود، به \fBw0vncserver-forget\fP(1) مراجعه کنید. پیش‌فرض \fBSession\fP است.
.
.TP
.B \-RequireUsername
الزام وارد کردن نام کاربری برای انواع امنیتی RSA-AES. پیش‌فرض غیرفعال است.
.
.TP
.B \-rfbport \fIport\fP
پورت TCP را تعیین می‌کند که w0vncserver روی آن برای دریافت اتصالات از بیننده‌ها شنود می‌کند (پروتکل مورد استفاده در VNC،‏ RFB یا "remote framebuffer" نام دارد). برای غیرفعال کردن شنود روی پورت TCP مقدار \fB-1\fP را مشخص کنید. پورت پیش‌فرض در صورت اجرای مستقیم 5900 است، و هنگامی که توسط سوکت systemd فعال شود برابر با -1 خواهد بود.
.
.TP
.B \-rfbunixmode \fImode\fP
حالت دسترسی (mode) سوکت دامنه یونیکس (Unix domain socket) را مشخص می‌کند. پیش‌فرض 0600 است.
.
.TP
.B \-rfbunixpath \fIpath\fP
مسیر سوکت دامنه یونیکس را مشخص می‌کند که w0vncserver روی آن برای دریافت اتصالات از بیننده‌ها شنود می‌کند. پیش‌فرض، عدم شنود روی هیچ سوکت دامنه یونیکسی است.
.
.TP
.B \-RSAKey \fIpath\fP
مسیر کلید RSA برای انواع امنیتی RSA-AES‏ (\fBRA2\fP، \fBRA2ne\fP، \fBRA2_256\fP و \fBRA2ne_256\fP) در قالب PEM.
.
.TP
.B \-SecurityTypes \fIsec-types\fP
طرح امنیتی مورد استفاده برای اتصالات ورودی را تعیین می‌کند. مقادیر معتبر فهرستی جداشده با کاما از \fBNone\fP، \fBVncAuth\fP، \fBPlain\fP، \fBTLSNone\fP، \fBTLSVnc\fP، \fBTLSPlain\fP، \fBX509None\fP، \fBX509Vnc\fP، \fBX509Plain\fP، \fBRA2\fP، \fBRA2ne\fP، \fBRA2_256\fP و \fBRA2ne_256\fP هستند. مقدار پیش‌فرض \fBTLSVnc,VncAuth\fP است.
.
.TP
.B \-UseBlacklist
رد موقت اتصالات یک میزبان در صورتی که به طور متوالی در احراز هویت با شکست مواجه شود. پیش‌فرض فعال است.
.
.TP
.B \-UseIPv4
استفاده از IPv4 برای اتصالات ورودی و خروجی. پیش‌فرض فعال است.
.
.TP
.B \-UseIPv6
استفاده از IPv6 برای اتصالات ورودی و خروجی. پیش‌فرض فعال است.
.
.TP
.B \-X509Cert \fIpath\fP
مسیر گواهی X509 در قالب PEM که برای تمامی انواع امنیتی مبتنی بر X509‏ (X509None،‏ X509Vnc و غیره) استفاده می‌شود.
.
.TP
.B \-X509Key \fIpath\fP
کلید خصوصی متناظر با گواهی ارائه‌شده در \fBX509Cert\fP. این کلید نیز باید در قالب PEM باشد.

.SH "همچنین ببینید (SEE ALSO)"
.BR w0vncserver-forget (1),
.BR x0vncserver (1),
.BR Xvnc (1),
.BR vncpasswd (1),
.br
https://www.tigervnc.org

.SH "نویسندگان (AUTHORS)"
تیم TigerVNC

پروتکل VNC در ابتدا توسط تیم RealVNC در Olivetti Research Ltd / AT&T Laboratories Cambridge توسعه داده شد. قابلیت‌های افزوده TightVNC توسط Constantin Kaplinsky پیاده‌سازی شدند. از آن زمان افراد بسیار دیگری در توسعه، آزمایش و پشتیبانی آن مشارکت داشته‌اند. این راهنما بخشی از مجموعه نرم‌افزاری TigerVNC است.