SPICE-CLIENT(1) Spice-GTK Documentation SPICE-CLIENT(1)

Spice-GTK - کتابخانه‌ای سمت کلاینت برای دسترسی به نمایشگرهای راه دور SPICE

کتابخانهٔ Spice-GTK امکان دسترسی به نمایشگرهای راه دور را از طریق پروتکل SPICE فراهم می‌کند. در حال حاضر کاربرد اصلی آن دسترسی به ماشین‌های مجازی راه دور است.

کتابخانهٔ Spice-GTK مجموعه‌ای از گزینه‌های خط فرمان را ارائه می‌دهد که می‌توان از آن‌ها برای سفارشی‌سازی برخی تنظیمات خاص SPICE استفاده کرد.

برای برقراری یک اتصال معمولی SPICE (اتصال رمزگذاری‌نشده خواهد بود) به hostname.example.com و پورت 5900، از URI زیر استفاده کنید:

spice://hostname.example.com:5900

برای آغاز یک اتصال TLS، باید از این ساختار استفاده شود:

spice+tls://hostname.example.com:5900

نکته: پروتکل 'spice+tls' از نسخهٔ v0.35 در دسترس است؛ پیش از آن باید از رشته پرس‌وجوی spice:// به همراه پارامتر 'tls-port' استفاده کنید.

نشانی spice رشته‌های پرس‌وجو (query string) را می‌پذیرد. در صورت جداسازی با & یا ; می‌توان چندین پارامتر را هم‌زمان مشخص کرد:

spice://hostname.example.com?port=5900;tls-port=5901

هنگام استفاده از 'tls-port'، توصیه می‌شود هیچ پورت غیر TLS مشخص نشود. در صورتی که هر دو گزینهٔ 'port' و 'tls-port' را مشخص می‌کنید، حتماً از گزینهٔ --spice-secure-channels برای تعیین کانال‌هایی که باید امن باشند استفاده نمایید. در غیر این صورت، Spice-GTK ابتدا تلاش می‌کند به پورت غیر TLS متصل شود و سپس پورت TLS را امتحان می‌کند. این بدان معناست که یک حمله‌کنندهٔ میانی (man-in-the-middle) می‌تواند بدون توجه به تنظیمات TLS سرور SPICE، کل نشست SPICE را وادار به ارسال متن رمزنشده (clear text) کند.

سایر پارامترهای معتبر URI عبارتند از 'username' و 'password'. توجه داشته باشید که ارسال گذرواژه از طریق URI در SPICE ممکن است باعث شود گذرواژه برای هر کاربر محلی دیگری از طریق دستور 'ps' قابل مشاهده باشد.

هنگام اجرای یک کلاینت SPICE که از گزینه‌های پیش‌فرض Spice-GTK استفاده می‌کند، گزینه‌های زیر پذیرفته می‌شوند:

اجبار کانال‌های مشخص‌شده به برقراری ارتباط امن

این گزینه به کلاینت SPICE اعلام می‌کند که برای این کانال‌ها الزاماً باید از یک اتصال TLS استفاده کند. اگر سرور برای این کانال‌ها تنها اتصالات غیر TLS ارائه دهد، کلاینت از آن‌ها استفاده نخواهد کرد. مقدار ویژهٔ «all» مشخص می‌کند که تمامی کانال‌های SPICE باید رمزگذاری شوند.

کانال‌های فعلی SPICE عبارتند از: main، display، inputs، cursor، playback، record، smartcard، usbredir.

غیرفعال‌سازی جلوه‌های بصری سیستم‌عامل مهمان

این گزینه به کلاینت SPICE اعلام می‌کند که برای کاهش مصرف پهنای باند، تلاش کند برخی از قابلیت‌های سیستم‌عامل مهمان را غیرفعال کند. این قابلیت نیاز به پشتیبانی در سیستم‌عامل مهمان دارد که معمولاً از طریق یک SPICE agent فراهم می‌شود. در حال حاضر این قابلیت تنها در مهمان‌های Windows پشتیبانی می‌شود.

مقدار «wallpaper» تصویر پس‌زمینهٔ مهمان را غیرفعال می‌کند، «font-smooth» سیستم یکدست‌سازی قلم‌ها (antialiasing) را خاموش می‌کند، و «animation» تلاش می‌کند برخی پویانمایی‌های محیط میزکار را غیرفعال سازد. مقدار «all» تلاش می‌کند هر آنچه قابلیت غیرفعال‌سازی دارد را غیرفعال کند.

عمق رنگ نمایشگر مهمان - منسوخ‌شده

این گزینه به کلاینت SPICE می‌گوید که تلاش کند عمق رنگ سیستم‌عامل مهمان را اجبار کند. عمق رنگ کمتر مصرف پهنای باند را کاهش می‌دهد. این مورد نیاز به پشتیبانی در مهمان دارد که معمولاً از طریق یک SPICE agent مهیا می‌شود. در حال حاضر این قابلیت تنها در ویندوز ۷ و نسخه‌های قدیمی‌تر پشتیبانی می‌شود.

فایل مخزن گواهی‌های معتبر (Truststore) برای اتصالات امن

این گزینه برای مشخص کردن یک فایل .crt حاوی گواهی CA که گواهی‌های TLS سرور SPICE با آن امضا شده‌اند استفاده می‌شود. این گزینه هنگام استفاده از گواهی‌های TLS خودامضاشده (self-signed) به جای گواهی‌های صادرشده توسط مراجع رسمی CA بسیار کاربردی است.

موضوع (Subject) گواهی میزبان (جفت‌های field=value تفکیک‌شده با کاما)

هنگام استفاده از گواهی‌های خودامضاشده، یا هنگامی که سیستم‌عامل مهمان میان میزبان‌های مختلف جابه‌جا (migrate) می‌شود، subject یا altSubject گواهی TLS که توسط سرور SPICE ارائه می‌شود لزوماً با نام میزبانی (hostname) که به آن متصل می‌شویم یکسان نخواهد بود. این گزینه امکان بازنویسی موضوع مورد انتظار گواهی TLS را فراهم می‌کند.

موضوع باید مطابق با خط «Subject:» باشد که توسط دستور زیر خروجی داده می‌شود:
openssl x509 -noout -text -in server-cert.pem

فعال‌سازی اشکال‌زدایی در Spice-GTK. این حالت را می‌توان از طریق متغیر محیطی SPICE_DEBUG یا با استفاده از G_MESSAGES_DEBUG=all نیز فعال کرد.
غیرفعال‌سازی پشتیبانی از صدا
غیرفعال‌سازی پشتیبانی از هدایت مجدد USB
فیلتر انتخاب دستگاه‌های USB برای هدایت خودکار هنگام اتصال

این فیلتر مشخص می‌کند در زمان فعال بودن نشست SPICE، کدام دستگاه‌های USB باید به محض اتصال به‌طور خودکار هدایت مجدد شوند.

قالب یک قاعده به صورت زیر است: "class,vendor,product,version,allow"

می‌توان از مقدار -1 به جای class، vendor، product یا version برای پذیرش هر مقداری استفاده کرد. می‌توان چندین قاعده را با نویسهٔ '|' ادغام نمود: "rule1|rule2|rule3"

فیلتر انتخاب دستگاه‌های USB برای هدایت مجدد هنگام برقراری اتصال

این فیلتر مشخص می‌کند پس از برقراری موفق اتصال SPICE به یک نمایشگر راه دور، کدام دستگاه‌های USB باید فوراً بازهدایت شوند.

نمایش اطلاعات نسخهٔ Spice-GTK
فعال‌سازی پشتیبانی از کارت هوشمند
مسیر پایگاه‌دادهٔ محلی گواهی برای استفاده در گواهی‌های نرم‌افزاری کارت هوشمند

این گزینه تنها برای مقاصد آزمایشی سودمند است. به جای داشتن یک کارت‌خوان سخت‌افزاری و یک کارت هوشمند فیزیکی، می‌توانید فایلی حاوی ۳ گواهی را مشخص کنید که برای شبیه‌سازی کارت هوشمند در سطح نرم‌افزار استفاده خواهد شد. برای جزئیات بیشتر در خصوص نحوهٔ ساخت این گواهی‌ها به نشانی "http://www.spice-space.org/page/SmartcardUsage#Using_a_software_smartcard" مراجعه نمایید.

گواهی‌های مورد استفاده برای کارت‌های هوشمند نرم‌افزاری (جفت‌های field=values تفکیک‌شده با کاما)

این گزینه تنها برای مقاصد آزمایشی مفید است و امکان تعیین این را می‌دهد که کدام گواهی‌ها از پایگاه‌دادهٔ گواهی مشخص‌شده توسط --spice-smartcard-db برای شبیه‌سازی کارت هوشمند استفاده شوند.

اندازهٔ حافظهٔ موقت (کَش) تصویر - منسوخ‌شده

از این گزینه تنها باید برای آزمون و اشکال‌زدایی استفاده شود.

اندازهٔ تاریخچه فشرده‌سازی Glz - منسوخ‌شده

از این گزینه تنها باید برای آزمون و اشکال‌زدایی استفاده شود.

باگ‌ها را به فهرست پستی "http://lists.freedesktop.org/mailman/listinfo/spice-devel" گزارش دهید.

حق نشر (C) ۲۰۱۱، ۲۰۱۴ شرکت .Red Hat, Inc و مشارکت‌کنندگان مختلف. این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید رونوشت‌های آن را تحت شرایط «مجوز عمومی همگانی کاهش‌یافته گنو» (GNU Lesser General Public License) "https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html" بازتوزیع نمایید. تا جایی که قانون مجاز می‌داند، هیچ‌گونه ضمانتی برای آن وجود ندارد.

"virt-viewer(1)"، وبگاه پروژه "http://spice-space.org"

2025-12-07 perl v5.42.0