.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "QEMU-VNC" "1" "Aug 28, 2026" "11.1.1" "QEMU" .SH "نام (NAME)" qemu\-vnc \- کارساز مستقل VNC برای QEMU .SH "خلاصه دستور (SYNOPSIS)" .sp \fBqemu\-vnc\fP [\fIOPTION\fP]... .SH "توضیحات (DESCRIPTION)" .sp \fBqemu\-vnc\fP یک کارساز مستقل VNC است که از طریق رابط نمایشگر D\-Bus (نمایشگر D\-Bus \%<#\:dbus-display>) به یک نمونه در حال اجرای QEMU متصل می‌شود. این برنامه نمایشگر مهمان، ورودی، صدا، بریده‌دان و chardevهای کنسول سریال را بر بستر پروتکل VNC ارائه می‌دهد، و به کلاینت‌های VNC امکان می‌دهد بدون نیاز به ایجاد سوکت VNC توسط خود QEMU، با ماشین مجازی تعامل داشته باشند. .SH "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-h, \-\-help نمایش راهنما و خروج. .UNINDENT .INDENT 0.0 .TP .B \-V, \-\-version چاپ اطلاعات نسخه و خروج. .UNINDENT .INDENT 0.0 .TP .B \-a ADDRESS, \-\-dbus\-address=ADDRESS آدرس D\-Bus جهت اتصال. در صورت عدم تعیین، \fBqemu\-vnc\fP به گذرگاه نشست (session bus) متصل می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-p FD, \-\-dbus\-p2p\-fd=FD توصیف‌کننده فایل (FD) مربوط به یک سوکت Unix به ارث‌رسیده برای اتصال نظیربه‌نظیر D\-Bus به QEMU. این گزینه با \fB\-\-dbus\-address\fP و \fB\-\-bus\-name\fP ناسازگار (مانعة‌الجمع) است. .UNINDENT .INDENT 0.0 .TP .B \-n NAME, \-\-bus\-name=NAME نام گذرگاه D\-Bus مربوط به نمونه QEMU جهت اتصال. پیش‌فرض \fBorg.qemu\fP است. هنگامی که یک \fB\-\-dbus\-address\fP سفارشی بدون نام گذرگاه داده شود، D\-Bus نظیربه‌نظیر به کار گرفته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-W, \-\-wait انتظار برای ظاهر شدن نام گذرگاه D\-Bus. فقط برای اتصالات گذرگاه معتبر است. .UNINDENT .INDENT 0.0 .TP .B \-\-password الزام کلاینت‌های متصل‌شونده به احراز هویت با گذرواژه VNC. گذرواژه در زمان اجرا از طریق متد D\-Bus به نام \fBSetPassword\fP تنظیم می‌شود (ببینید D\-Bus VNC \%<>). کلاینت‌ها تا زمانی که گذرواژه‌ای تعیین نشده باشد قادر به اتصال نخواهند بود. .sp این گزینه هنگامی که گذرواژه اعتبارنامه‌ای systemd موجود باشد نادیده گرفته می‌شود، زیرا در این حالت احراز هویت با گذرواژه از قبل توسط \fBpassword\-secret\fP فعال شده است. .UNINDENT .INDENT 0.0 .TP .B \-l ADDR, \-\-vnc\-addr=ADDR آدرس شنود VNC با همان قالبی که در گزینه \fB\-vnc\fP دستور QEMU استفاده می‌شود (پیش‌فرض \fBlocalhost:0\fP، یعنی درگاه TCP شماره 5900). .UNINDENT .INDENT 0.0 .TP .B \-w ADDR, \-\-websocket=ADDR فعال‌سازی انتقال WebSocket روی آدرس داده‌شده. \fIADDR\fP می‌تواند یک شماره درگاه یا جفت \fIaddress:port\fP باشد. .UNINDENT .INDENT 0.0 .TP .B \-O OBJDEF, \-\-object=OBJDEF ایجاد یک شیء قابل ساخت توسط کاربر (user\-creatable) در QEMU. آرگومان \fIOBJDEF\fP از همان نحو key=value مشابه گزینه \fB\-object\fP در QEMU استفاده می‌کند. این گزینه می‌تواند چندین بار مشخص شود؛ برای مثال برای ایجاد اشیاء مجوزدهی که در \fB\-\-tls\-authz\fP به آن‌ها ارجاع داده شده، لازم است. .UNINDENT .INDENT 0.0 .TP .B \-t DIR, \-\-tls\-creds=DIR دایرکتوری حاوی اعتبارنامه‌های TLS x509 (\fBca\-cert.pem\fP، \fBserver\-cert.pem\fP، \fBserver\-key.pem\fP). در صورت تعیین، کارساز VNC از کلاینت‌های متصل‌شونده استفاده از TLS را الزامی خواهد کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-tls\-authz=ID شناسه (ID) یک شیء \fBQAuthZ\fP که پیش‌تر با \fB\-\-object\fP برای مجوزدهی گواهی کلاینت TLS ایجاد شده است. در صورت تعیین، اعتبارنامه‌های TLS با \fBverify\-peer=yes\fP ساخته می‌شوند تا کلاینت‌های متصل‌شونده ملزم به ارائه یک گواهی معتبر باشند. پس از دست‌تکانی TLS، نام متمایز (Distinguished Name) گواهی کلاینت در برابر شیء مجوزدهی بررسی می‌شود. این گزینه نیازمند \fB\-\-tls\-creds\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-sasl الزام کلاینت به استفاده از SASL برای احراز هویت با کارساز VNC. انتخاب دقیق روش احراز هویت استفاده‌شده، از طریق فایل پیکربندی SASL سیستم/کاربر برای سرویس \(aqqemu\(aq کنترل می‌شود. این فایل معمولاً در \fB/etc/sasl2/qemu.conf\fP قرار دارد. در صورت اجرای QEMU به عنوان یک کاربر غیرممتاز، می‌توان از متغیر محیطی \fBSASL_CONF_PATH\fP استفاده کرد تا مسیرهای جایگزین برای پیکربندی سرویس جستجو شوند. با وجود اینکه برخی از روش‌های احراز هویت SASL می‌توانند رمزنگاری داده‌ها را نیز فراهم کنند (مانند GSSAPI)، توصیه می‌شود که SASL همواره با تنظیمات \(aqtls\(aq و \(aqx509\(aq ترکیب شود تا استفاده از SSL و گواهی‌های کارساز ممکن گردد. این کار رمزنگاری داده‌ها را تضمین کرده و از فاش شدن اعتبارنامه‌های احراز هویت جلوگیری می‌کند. برای جزئیات مربوط به استفاده از احراز هویت SASL، بخش امنیت VNC (\%<#\:vnc-security>) را در راهنمای کاربری شبیه‌سازی سیستم (System Emulation Users Guide) ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-sasl\-authz=ID شناسه (ID) یک شیء \fBQAuthZ\fP که پیش‌تر با \fB\-\-object\fP برای مجوزدهی نام کاربری SASL ایجاد شده است. پس از احراز هویت موفقیت‌آمیز SASL، نام کاربری احراز هویت‌شده در برابر شیء مجوزدهی بررسی می‌شود. در صورت رد شدن بررسی، اتصال کلاینت قطع می‌شود. این گزینه نیازمند \fB\-\-sasl\fP است. .UNINDENT .INDENT 0.0 .TP .B \-s POLICY, \-\-share=POLICY تنظیم سیاست اشتراک‌گذاری نمایشگر. آرگومان \fIPOLICY\fP یکی از مقادیر \fBallow\-exclusive\fP، \fBforce\-shared\fP، یا \fBignore\fP است. .sp سیاست \fBallow\-exclusive\fP به کلاینت‌ها امکان می‌دهد تا درخواست دسترسی انحصاری کنند. طبق پیشنهاد ارائه‌شده در مشخصات RFB، این کار با قطع سایر اتصالات پیاده‌سازی می‌شود. اتصال هم‌زمان چند کلاینت نیازمند آن است که تمام کلاینت‌ها درخواست نشست اشتراکی داشته باشند (سوئیچ \-shared در vncviewer). این مقدار پیش‌فرض است. .sp سیاست \fBforce\-shared\fP دسترسی انحصاری کلاینت را غیرفعال می‌سازد. این حالت برای نشست‌های میزکار اشتراکی مفید است؛ جایی که مایل نیستید فراموش کردن تعیین \-shared توسط یک کاربر، اتصال دیگران را قطع کند. .sp سیاست \fBignore\fP پرچم اشتراک‌گذاری (shared) را کاملاً نادیده می‌گیرد و به همه اجازه می‌دهد بدون قید و شرط متصل شوند. این رفتار با مشخصات RFB سازگار نیست اما رفتار سنتی QEMU به شمار می‌رود. .UNINDENT .INDENT 0.0 .TP .B \-C NAME, \-\-vt\-chardev=NAME نام نوع chardev جهت ارائه به عنوان کنسول متنی VNC. این گزینه می‌تواند چندین بار مشخص شود تا چندین chardev در دسترس قرار گیرند. در صورت عدم تعیین، مقادیر پیش‌فرض \fBorg.qemu.console.serial.0\fP و \fBorg.qemu.monitor.hmp.0\fP استفاده می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-N, \-\-no\-vt عدم ارائه هیچ‌یک از chardevها به عنوان کنسول متنی. این گزینه فهرست پیش‌فرض chardev و تمامی گزینه‌های \fB\-\-vt\-chardev\fP را لغو می‌کند. .UNINDENT .INDENT 0.0.TP .B \-k LAYOUT, \-\-keyboard\-layout=LAYOUT چیدمان صفحه‌کلید (مانند \fBen\-us\fP). جهت ترجمهٔ کدهای کلید (key\-code) به کارساز VNC فرستاده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-lossy فعال‌سازی روش‌های فشرده‌سازی با اتلاف (gradient، JPEG و...). در صورت فعال بودن این گزینه، کلاینت VNC ممکن است بسته به تنظیمات کدگذاری خود، به‌روزرسانی‌های بافرفریم را با اتلاف دریافت کند. فعال کردن این گزینه می‌تواند به بهای افت کیفیت، پهنای باند قابل توجهی را صرفه‌جویی کند. .UNINDENT .INDENT 0.0 .TP .B \-\-non\-adaptive غیرفعال‌سازی کدگذاری‌های انطباقی. کدگذاری‌های انطباقی به‌طور پیش‌فرض فعال هستند. یک کدگذاری انطباقی تلاش می‌کند بخش‌هایی از صفحه را که مکرراً به‌روزرسانی می‌شوند شناسایی کرده و به‌روزرسانی‌های این نواحی را با استفاده از یک کدگذاری با اتلاف (مانند JPEG) ارسال کند. این قابلیت هنگام پخش ویدیو برای کاهش مصرف پهنای باند بسیار کاربردی است. غیرفعال‌سازی کدگذاری‌های انطباقی، رفتار ایستا و اولیهٔ کدگذاری‌هایی مانند Tight را بازیابی می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-T, \-\-trace [[enable=]PATTERN][,events=FILE][,file=FILE] مشخص کردن گزینه‌های ردیابی (trace). .sp \fB[enable=]PATTERN\fP .INDENT 7.0 .INDENT 3.5 رویدادهای منطبق با \fIPATTERN\fP را بی‌درنگ فعال می‌کند (خواه نام یک رویداد یا یک الگوی تطابق/globbing باشد). این گزینه تنها در صورتی در دسترس است که QEMU با یکی از بک‌اند‌های ردیابی \fBsimple\fP، \fBlog\fP یا \fBftrace\fP کامپایل شده باشد. برای تعیین چندین رویداد یا الگو، گزینهٔ \fB\-trace\fP را چندین بار مشخص کنید. .sp برای چاپ فهرستی از نام‌های نقاط ردیابی از \fB\-trace help\fP استفاده کنید. .UNINDENT .UNINDENT .sp \fBevents=FILE\fP .INDENT 7.0 .INDENT 3.5 رویدادهای فهرست‌شده در \fIFILE\fP را بی‌درنگ فعال می‌کند\&. این فایل باید در هر سطر شامل یک نام رویداد (همان‌گونه که در فایل \fBtrace\-events\-all\fP فهرست شده است) باشد؛ الگوهای globbing نیز پذیرفته می‌شوند. این گزینه تنها در صورتی در دسترس است که QEMU با یکی از بک‌اند‌های ردیابی \fBsimple\fP، \fBlog\fP یا \fBftrace\fP کامپایل شده باشد. .UNINDENT .UNINDENT .sp \fBfile=FILE\fP .INDENT 7.0 .INDENT 3.5 ردیابی‌های خروجی را در \fIFILE\fP ثبت (log) می‌کند\&. این گزینه تنها در صورتی در دسترس است که QEMU با بک‌اند ردیابی \fBsimple\fP کامپایل شده باشد. .UNINDENT .UNINDENT .UNINDENT .SH "مثال‌ها (EXAMPLES)" .sp اجرای QEMU با بک‌اند نمایش D\-Bus: .INDENT 0.0 .INDENT 3.5 .sp .EX qemu\-system\-x86_64 \-display dbus ... .EE .UNINDENT .UNINDENT .sp سپس متصل کردن \fBqemu\-vnc\fP: .INDENT 0.0 .INDENT 3.5 .sp .EX qemu\-vnc .EE .UNINDENT .UNINDENT .sp اکنون یک کلاینت VNC می‌تواند به \fBlocalhost:5900\fP متصل شود\&. .sp برای شنود روی درگاهی متفاوت همراه با TLS: .INDENT 0.0 .INDENT 3.5 .sp .EX qemu\-vnc \-\-vnc\-addr localhost:1 \-\-tls\-creds /etc/pki/qemu\-vnc .EE .UNINDENT .UNINDENT .sp برای الزامی کردن TLS همراه با اعتبارسنجی گواهی کلاینت: .INDENT 0.0 .INDENT 3.5 .sp .EX qemu\-vnc \-\-object authz\-list\-file,id=auth0,filename=/etc/qemu/vnc.acl,refresh=on \e \-\-tls\-creds /etc/pki/qemu\-vnc \-\-tls\-authz auth0 .EE .UNINDENT .UNINDENT .sp برای فعال‌سازی احراز هویت SASL با TLS: .INDENT 0.0 .INDENT 3.5 .sp .EX qemu\-vnc \-\-tls\-creds /etc/pki/qemu\-vnc \-\-sasl .EE .UNINDENT .UNINDENT.SH "احراز هویت با گذرواژه VNC (VNC PASSWORD AUTHENTICATION)" .sp دو راه برای فعال‌سازی احراز هویت با گذرواژه VNC وجود دارد: .INDENT 0.0 .IP 1. 3 پرچم \fB\-\-password\fP \-\- آغاز \fBqemu\-vnc\fP با \fB\-\-password\fP و سپس تنظیم گذرواژه در زمان اجرا با استفاده از متد \fBSetPassword\fP در D\-Bus. تا زمانی که گذرواژه‌ای تعیین نشود، کلاینت‌ها رد خواهند شد. .IP 2. 3 اعتبارنامه‌های systemd \-\- اگر متغیر محیطی \fBCREDENTIALS_DIRECTORY\fP تنظیم شده باشد (\fBsystemd.exec(5)\fP را ببینید) و شامل فایلی با نام \fBvnc\-password\fP باشد، کارساز VNC به‌طور خودکار از محتویات آن فایل به عنوان گذرواژه استفاده خواهد کرد. در این حالت نیازی به پرچم \fB\-\-password\fP نیست. .UNINDENT .SH "رابط D-BUS (D-BUS INTERFACE)" .sp \fBqemu\-vnc\fP یک رابط D\-Bus را برای مدیریت و پایش اتصالات VNC ارائه می‌دهد. برای مرجع کامل رابط به D\-Bus VNC \%<> مراجعه کنید. .SH "همچنین ببینید (SEE ALSO)" .sp \fBqemu(1)\fP, D\-Bus display \%<>, D\-Bus VNC \%<>, The RFB Protocol \% .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2026, The QEMU Project Developers .\" End of generated man page.