spice-app[,gl=on|off]

將 QEMU 作為 Spice 服務(wù)器啟動(dòng)，并啟動(dòng)默認(rèn)的 Spice 客戶端應(yīng)用程序。Spice 服務(wù)器將重定向串行控制臺和 QEMU 監(jiān)視器。（自 4.0 起）

dbus

通過 D 總線接口導(dǎo)出顯示。（自 7.0 起）

連接使用“org.qemu”名稱注冊（并在已擁有時(shí)排隊(duì)）。

addr=<dbusaddr>：要連接到的 D 總線地址。

p2p=yes|no：使用通過 QMP 接受的對等連接。add_client

gl=on|off|core|es：使用 OpenGL 進(jìn)行渲染（D-Bus 接口將與 DMABUF 文件描述符共享幀緩沖器）。

sdl

通過 SDL 顯示視頻輸出（通常在單獨(dú)的圖形窗口中;有關(guān)其他可能性，請參閱 SDL 文檔）。有效參數(shù)包括：

grab-mod=<mods>：用于選擇修飾鍵，以便與“g”鍵一起切換鼠標(biāo)抓取。 可以是 或 。<mods>lshift-lctrl-laltrctrl

gl=on|off|core|es：使用 OpenGL 進(jìn)行顯示

show-cursor=on|off：強(qiáng)制顯示鼠標(biāo)光標(biāo)

window-close=on|off：允許退出 qemu 與窗口關(guān)閉按鈕

gtk

在 GTK 窗口中顯示視頻輸出。此接口提供下拉菜單和其他 UI 元素，用于在運(yùn)行時(shí)配置和控制 VM。有效參數(shù)包括：

full-screen=on|off：以全屏模式啟動(dòng)

gl=on|off：使用 OpenGL 進(jìn)行顯示

grab-on-hover=on|off：鼠標(biāo)懸停時(shí)抓取鍵盤輸入

show-cursor=on|off：強(qiáng)制顯示鼠標(biāo)光標(biāo)

window-close=on|off：允許退出 qemu 與窗口關(guān)閉按鈕

curses[,charset=<encoding>]

通過詛咒顯示視頻輸出。對于支持文本模式的圖形設(shè)備型號，QEMU 可以使用 curses/ncurses 接口顯示此輸出。當(dāng)圖形設(shè)備處于圖形模式或圖形設(shè)備不支持文本模式時(shí)，不顯示任何內(nèi)容。通常只有 VGA 設(shè)備型號支持文本模式?？蛻魴C(jī)使用的字體字符集可以使用該選項(xiàng)指定，例如，用于 IBM CP850 編碼。缺省值為 。charsetcharset=CP850CP437

cocoa

在可可窗口中顯示視頻輸出。僅限 Mac。此接口提供下拉菜單和其他 UI 元素，用于在運(yùn)行時(shí)配置和控制 VM。有效參數(shù)包括：

show-cursor=on|off：強(qiáng)制顯示鼠標(biāo)光標(biāo)

left-command-key=on|off：禁用將左命令鍵轉(zhuǎn)發(fā)到主機(jī)

egl-headless[,rendernode=<file>]

將所有 OpenGL 操作卸載到本地 DRI 設(shè)備。對于任何圖形顯示器，此顯示器需要與 VNC 或 SPICE 顯示器配對。

vnc=<display>

在顯示<顯示>啟動(dòng) VNC 服務(wù)器

none

不顯示視頻輸出。來賓仍將看到模擬圖形卡，但其輸出不會(huì)顯示給 QEMU 用戶。此選項(xiàng)與 -nographic 選項(xiàng)的不同之處在于，它只影響視頻輸出的操作。-nographic 還會(huì)更改串行和并行端口數(shù)據(jù)的目標(biāo)。

port=<nr>

Set the TCP port spice is listening on for plaintext channels.

addr=<addr>

Set the IP address spice is listening on. Default is any address.

ipv4=on|off;?ipv6=on|off;?unix=on|off

Force using the specified IP version.

password=<string>

Set the password you need to authenticate.

This option is deprecated and insecure because it leaves the password visible in the process listing. Use?instead.password-secret

password-secret=<secret-id>

Set the ID of the?object containing the password you need to authenticate.secret

sasl=on|off

Require that the client use SASL to authenticate with the spice. The exact choice of authentication method used is controlled from the system / user’s SASL configuration file for the ‘qemu’ service. This is typically found in /etc/sasl2/qemu.conf. If running QEMU as an unprivileged user, an environment variable SASL_CONF_PATH can be used to make it search alternate locations for the service config. While some SASL auth methods can also provide data encryption (eg GSSAPI), it is recommended that SASL always be combined with the ‘tls’ and ‘x509’ settings to enable use of SSL and server certificates. This ensures a data encryption preventing compromise of authentication credentials.

disable-ticketing=on|off

Allow client connects without authentication.

disable-copy-paste=on|off

Disable copy paste between the client and the guest.

disable-agent-file-xfer=on|off

Disable spice-vdagent based file-xfer between the client and the guest.

tls-port=<nr>

Set the TCP port spice is listening on for encrypted channels.

x509-dir=<dir>

Set the x509 file directory. Expects same filenames as -vnc $display,x509=$dir

x509-key-file=<file>;?x509-key-password=<file>;?x509-cert-file=<file>;?x509-cacert-file=<file>;?x509-dh-key-file=<file>

The x509 file names can also be configured individually.

tls-ciphers=<list>

Specify which ciphers to use.

tls-channel=[main|display|cursor|inputs|record|playback];?plaintext-channel=[main|display|cursor|inputs|record|playback]

Force specific channel to be used with or without TLS encryption. The options can be specified multiple times to configure multiple channels. The special name “default” can be used to set the default mode. For channels which are not explicitly forced into one mode the spice client is allowed to pick tls/plaintext as he pleases.

image-compression=[auto_glz|auto_lz|quic|glz|lz|off]

Configure image compression (lossless). Default is auto_glz.

jpeg-wan-compression=[auto|never|always];?zlib-glz-wan-compression=[auto|never|always]

Configure wan image compression (lossy for slow links). Default is auto.

streaming-video=[off|all|filter]

Configure video stream detection. Default is off.

agent-mouse=[on|off]

Enable/disable passing mouse events via vdagent. Default is on.

playback-compression=[on|off]

Enable/disable audio stream compression (using celt 0.5.1). Default is on.

seamless-migration=[on|off]

Enable/disable spice seamless migration. Default is off.

gl=[on|off]

Enable/disable OpenGL context. Default is off.

rendernode=<file>

DRM render node for OpenGL rendering. If not specified, it will pick the first available. (Since 2.9)

reverse=on|off

通過“反向”連接連接到偵聽 VNC 客戶端?？蛻舳擞娠@示器指定。對于反向網(wǎng)絡(luò)連接（host：d，'reverse''），d 參數(shù)是 TCP 端口號，而不是顯示號。

websocket=on|off

打開專用于 VNC Websocket 連接的附加 TCP 偵聽端口。如果給出了裸 websocket 選項(xiàng)，則 Websocket 端口為 5700+display?？梢允褂谜Z法 =port 指定備用端口。websocket

如果指定了主機(jī)，則僅允許來自此主機(jī)的連接。可以使用語法 =host：port 獨(dú)立控制 websocket 偵聽地址。websocket

如果未提供 TLS 憑據(jù)，則 websocket 連接將在未加密模式下運(yùn)行。如果提供了 TLS 憑據(jù)，則 websocket 連接需要加密的客戶端連接。

password=on|off

要求對客戶端連接使用基于密碼的身份驗(yàn)證。

必須使用?QEMU 監(jiān)視器中的命令單獨(dú)設(shè)置密碼。更改密碼的語法是：其中<protocol>可以是“vnc”或“spice”。set_passwordset_password?<protocol>?<password>

如果要更改<protocol>密碼過期，則應(yīng)使用過期時(shí)間可以是以下選項(xiàng)之一的位置：now、never、+seconds 或 UNIX 過期時(shí)間，例如 +60 使密碼在 60 秒后過期，或者1335196800使密碼在“Mon 23 12：00：00 EDT 2012”（此日期和時(shí)間的 UNIX 時(shí)間）過期。expire_password?<protocol>?<expiration-time>

您還可以使用關(guān)鍵字“now”或“never”作為過期時(shí)間，以允許<protocol>密碼立即過期或永不過期。

password-secret=<secret-id>

要求使用 由 標(biāo)識的對象提供的密碼對客戶端連接使用基于密碼的身份驗(yàn)證。secretsecret-id

tls-creds=ID

提供一組用于保護(hù) VNC 服務(wù)器的 TLS 憑據(jù)的 ID。它們將同時(shí)應(yīng)用于正常的 VNC 服務(wù)器套接字和 websocket 套接字（如果已啟用）。設(shè)置 TLS 憑據(jù)將導(dǎo)致 VNC 服務(wù)器套接字啟用 VeNCrypt 身份驗(yàn)證機(jī)制。憑據(jù)應(yīng)以前使用該參數(shù)創(chuàng)建。-object?tls-creds

tls-authz=ID

提供將驗(yàn)證客戶端的 x509 可分辨名稱的 QAuthZ 授權(quán)對象的 ID。此對象僅在使用時(shí)解析，因此可以在 VNC 服務(wù)器處于活動(dòng)狀態(tài)時(shí)動(dòng)態(tài)刪除和重新創(chuàng)建。如果丟失，它將默認(rèn)拒絕訪問。

sasl=on|off

要求客戶端使用 SASL 向 VNC 服務(wù)器進(jìn)行身份驗(yàn)證。所使用的身份驗(yàn)證方法的確切選擇由系統(tǒng)/用戶的 SASL 配置文件控制，用于“qemu”服務(wù)。這通?？梢栽?/etc/sasl2/qemu.conf 中找到。如果以非特權(quán)用戶身份運(yùn)行 QEMU，則可以使用環(huán)境變量SASL_CONF_PATH來使其搜索服務(wù)配置的備用位置。雖然一些 SASL 身份驗(yàn)證方法也可以提供數(shù)據(jù)加密（例如 GSSAPI），但建議 SASL 始終與“tls”和“x509”設(shè)置結(jié)合使用，以啟用 SSL 和服務(wù)器證書。這可確保數(shù)據(jù)加密，防止身份驗(yàn)證憑據(jù)泄露。有關(guān)使用 SASL 身份驗(yàn)證的詳細(xì)信息，請參閱《系統(tǒng)仿真用戶指南》中的“VNC 安全性”部分。

sasl-authz=ID

提供將驗(yàn)證客戶端的 SASL 用戶名的 QAuthZ 授權(quán)對象的 ID。此對象僅在使用時(shí)解析，因此可以在 VNC 服務(wù)器處于活動(dòng)狀態(tài)時(shí)動(dòng)態(tài)刪除和重新創(chuàng)建。如果丟失，它將默認(rèn)拒絕訪問。

acl=on|off

用于針對 x509 可分辨名稱和 SASL 用戶名啟用客戶端授權(quán)的舊方法。它會(huì)導(dǎo)致創(chuàng)建兩個(gè) ID 為 和 的對象。這些對象的規(guī)則必須使用 HMP ACL 命令進(jìn)行配置。authz-listvnc.usernamevnc.x509dname

此選項(xiàng)已棄用，不應(yīng)再使用。新的和選項(xiàng)是替代的。sasl-authztls-authz

lossy=on|off

啟用有損壓縮方法（漸變、JPEG 等）。如果設(shè)置了此選項(xiàng)，VNC 客戶端可能會(huì)收到有損幀緩沖器更新，具體取決于其編碼設(shè)置。啟用此選項(xiàng)可以節(jié)省大量帶寬，但會(huì)犧牲質(zhì)量。

non-adaptive=on|off

禁用自適應(yīng)編碼。默認(rèn)情況下，自適應(yīng)編碼處于啟用狀態(tài)。自適應(yīng)編碼將嘗試檢測頻繁更新的屏幕區(qū)域，并使用有損編碼（如 JPEG）在這些區(qū)域中發(fā)送更新。這對于在播放視頻時(shí)節(jié)省帶寬非常有幫助。禁用自適應(yīng)編碼會(huì)恢復(fù)編碼（如 Tight）的原始靜態(tài)行為。

share=[allow-exclusive|force-shared|ignore]

設(shè)置顯示共享策略?！霸试S-獨(dú)占”允許客戶端請求獨(dú)占訪問。正如 rfb 規(guī)范所建議的那樣，這是通過刪除其他連接來實(shí)現(xiàn)的。并行連接多個(gè)客戶端需要所有客戶端請求共享會(huì)話（vncviewer：-shared switch）。這是默認(rèn)設(shè)置?！皬?qiáng)制共享”禁用獨(dú)占客戶端訪問。對于共享桌面會(huì)話很有用，您不希望有人忘記指定 - 共享斷開其他所有人的連接?！昂雎浴蓖耆雎怨蚕順?biāo)志，并允許每個(gè)人無條件連接。不符合 rfb 規(guī)范，但屬于傳統(tǒng)的 QEMU 行為。

key-delay-ms

設(shè)置鍵盤延遲，用于按鍵關(guān)閉和鍵上事件，以毫秒為單位。默認(rèn)值為 10。鍵盤是低帶寬設(shè)備，因此這種減速可以幫助設(shè)備和來賓跟上速度，并且在事件批量到達(dá)時(shí)不會(huì)丟失事件。后者的可能原因是不穩(wěn)定的網(wǎng)絡(luò)連接或用于自動(dòng)測試的腳本。

audiodev=audiodev

當(dāng) VNC 客戶端請求音頻傳輸時(shí)，請使用指定的音頻開發(fā)。不使用 -audiodev 參數(shù)時(shí)，必須省略此選項(xiàng)，否則必須存在此選項(xiàng)并指定有效的 audiodev。

power-control=on|off

允許遠(yuǎn)程客戶端發(fā)出關(guān)機(jī)、重新啟動(dòng)或重置電源控制請求。

to=L

使用此選項(xiàng)，QEMU將嘗試下一個(gè)可用的VNC顯示器，直到數(shù)字L，如果原始定義的“-vnc顯示器”不可用，例如端口5900 +顯示器已被另一個(gè)應(yīng)用程序使用。默認(rèn)情況下，to=0。

host:d

僅允許來自顯示 d 的主機(jī)的 TCP 連接。按照慣例，TCP 端口為 5900+d。（可選）可以省略 host，在這種情況下，服務(wù)器將接受來自任何主機(jī)的連接。

unix:path

將允許通過 UNIX 域套接字進(jìn)行連接，其中 path 是用于偵聽連接的 unix 套接字的位置。

none

VNC 已初始化但未啟動(dòng)。監(jiān)視命令可用于稍后啟動(dòng) VNC 服務(wù)器。change