本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Amazon DCV Server 參數參考
下表列出可設定為自訂 Amazon DCV 伺服器的參數。
注意
每個表格的重新載入情況欄指出何時重新載入參數。可能的情況包括：
-
server- 當伺服器啟動時， 參數會載入一次。如果更新參數值，則在重新啟動伺服器時載入新的值。 -
session- 參數會在建立工作階段時載入。如果更新參數值，則在後續工作階段中載入新的值。 -
connection- 參數會在建立新的用戶端連線時載入。如果更新參數值，則後續的用戶端連線會使用新的值。 -
custom- 參數載入的情況對於此參數是唯一的。如需詳細資訊，請參閱參數描述。
主題
audio 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [audio]區段中的組態參數，以及 Windows Amazon DCV 伺服器的audio登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| avsync-support | string | 工作階段 | 'auto' | 判斷用戶端是否可以啟用音訊/視訊同步 — 允許連接的用戶端啟用音訊/視訊同步。有效值為 'enabled'、'disabled' 或 'auto' (default='auto')。如果指定「自動」，則僅在主控台工作階段上啟用音訊/視訊同步，並且只有在加速視訊壓縮可用時啟用。— 自 2021.1-10557 版開始提供。 |
| source-channels | integer - DWORD (32 位元） | 工作階段 | 2 | Linux 上喇叭裝置的頻道數量 — 設定 Linux 喇叭裝置的頻道數量。值必須小於或等於裝置支援的頻道數量。允許的值為：2 （立體聲）、4 (4.0 四面音）、6 (5.1 環繞）、8 (7.1 環繞）。預設值為 2 （立體聲）。— 自 2020.0-8428 版開始提供。 |
clipboard 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [clipboard]區段中的組態參數，以及 Windows Amazon DCV 伺服器的clipboard登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| enabled | true 或 false - DWORD (32 位元） | 工作階段 | Linux： true - Windows： 1 | 是否應該啟用剪貼簿功能 — 指定是否已啟用剪貼簿功能。如果停用剪貼簿功能，使用者將無法使用剪貼簿移除。剪貼簿監控也會停用。— 從 2020.0-8428 版開始提供。 |
| max-image-area | integer - DWORD (32 位元） | 工作階段 | -1 | 剪貼簿影像的最大區域 — 指定可在伺服器和用戶端之間傳輸的剪貼簿影像的最大區域 （像素數）。如果此值遺失或設定為 -1，則不會套用限制。— 從 2017.0-4334 版開始提供。 |
| max-payload-size | integer - DWORD (32 位元） | 工作階段 | 20971520 | 剪貼簿資料的大小上限 — 指定可在伺服器和用戶端之間傳輸的剪貼簿資料大小上限 （以位元組為單位）。支援的值上限為 20 MB。如果缺少此值，則會強制執行上限。— 自 2017.0-4334 版開始提供。 |
| max-text-len | integer - DWORD (32 位元） | 工作階段 | -1 | 剪貼簿文字的字元數上限 — 指定可以從伺服器傳輸到用戶端的剪貼簿文字字元數上限。多餘的字元將被截斷。如果此值遺失或設定為 -1，則不會套用限制。— 自 2017.0-4334 版開始提供。 |
| primary-selection-copy | true 或 false - DWORD (32 位元） | 工作階段 | Linux：false - Windows：0 | 從 linux 啟用主要選取項目複本：Linux 桌面支援多個剪貼簿：一般剪貼簿和主要選取項目。選取內容時會更新或複製主要選擇。接著，可使用滑鼠的中間按鈕或 Shift+Insert 按鍵組合來貼上。啟用時會監控主要選擇，並將更新傳播到用戶端。— 自 2019.0-7318 版開始提供。 |
| primary-selection-paste | true 或 false - DWORD (32 位元） | 工作階段 | Linux：false - Windows：0 | 在 linux 上啟用主要選取項目貼圖：Linux 桌面支援多個剪貼簿：一般剪貼簿和主要選取項目。選取內容時會更新或複製主要選擇。接著，可使用滑鼠的中間按鈕或 Shift+Insert 按鍵組合來貼上。啟用時，用戶端的剪貼簿內容也會插入主要選擇中。— 從 2019.0-7318 版開始提供。 |
| update-timeout | integer - DWORD (32 位元） | 工作階段 | 200 | 更新事件通知逾時 — 指定從上次更新事件傳送通知到用戶端的等待時間，以毫秒為單位。預設值 200 毫秒。— 自 2020.1-8942 版開始提供。 |
connectivity 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [connectivity]區段中的組態參數，以及 Windows Amazon DCV 伺服器的connectivity登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| disconnect-on-lock | true 或 false - DWORD (32 位元） | 自訂 | Linux：false - Windows：0 | 用戶端是否在作業系統工作階段鎖定上中斷連線 — 啟用此選項可在遠端作業系統工作階段鎖定時強制中斷連線用戶端。否則，用戶端將繼續串流遠端工作階段。目前僅主控台工作階段支援 。此參數值會在每次遠端作業系統工作階段鎖定時讀取。— 自 2023.1-16220 版開始提供。 |
| disconnect-on-logout | true 或 false - DWORD (32 位元） | 自訂 | Linux：false - Windows：0 | 用戶端是否在作業系統使用者登出時中斷連線 — 啟用此選項可在遠端作業系統使用者登出 （即作業系統工作階段已關閉） 時強制中斷用戶端連線。否則，用戶端將繼續串流遠端工作階段。目前僅主控台工作階段支援 。此參數值會在每個遠端作業系統使用者登出時讀取。— 自 2023.1-16220 版開始提供。 |
| enable-quic-frontend | true 或 false - DWORD (32 位元） | 伺服器 | Linux： true - Windows： 1 | 是否啟用 QUIC 前端 — 指定是否應啟用 QUIC 前端。— 從 2020.2-9508 版開始提供。 |
| idle-timeout | integer - DWORD (32 位元） | 自訂 | 60 | 閒置逾時 — 指定中斷閒置用戶端的連線之前要等待的分鐘數。指定 0 則永遠不會中斷閒置用戶端。此參數值每秒讀取一次。— 自 2017.0-4100 版開始提供。 |
| idle-timeout-warning | integer - DWORD (32 位元） | 自訂 | 350 | 閒置逾時警告 — 指定閒置逾時的相對等待秒數，然後再警告閒置用戶端閒置逾時中斷連線。指定 0 永遠不會警告閒置用戶端。— 從 2017.4-6898 版開始提供。 |
| quic-listen-endpoints | string | 伺服器 | 【'0.0.0.0'， '：：'】 | 指定 DCV 接聽傳入 QUIC 連線的端點 — 指定 DCV 將接聽傳入 QUIC 連線的端點清單。端點可以是本機可繫結的 IPv4 地址清單 (「0.0.0.0」用於萬用字元所有可能的地址），或可繫結的 IPv6 地址 ('：：' 用於萬用字元所有可能的地址），其選用連接埠以冒號 ('：') 分隔。例如，'1.2.3.4：5678' 會在與 '1.2.3.4' 地址相關聯的介面上接聽傳入連線，連接埠為 5678。如果未指定連接埠，則 'quic-port' 中的設定將用作預設值。若要指定具有 IPv6 地址的連接埠，請以方括號括住地址 （例如 '【：：1】：8443')。也支援包含明確界面的 IPv6 地址 （例如 '【：：%eth1】：8443')。— 自 2022.0-11954 版開始提供。 |
| quic-port | integer - DWORD (32 位元） | 伺服器 | 8443 | QUIC 前端的 UDP 連接埠 — 指定 DCV 伺服器接聽用戶端連線的 UDP 連接埠。連接埠號碼必須為介於 1024 到 65535 的數字。如需如何套用此設定的詳細資訊，請參閱「quic-listen-endpoints」設定。— 自 2020.2-9508 版開始提供。 |
| web-extra-http-headers | string | 伺服器 | [] | 設定要新增至 HTTP/HTTPS 標頭的額外標頭陣列 — 用來新增額外的標頭。陣列應填充如下的耦合：【('header_name'，'header_content')】。可以新增多個標頭。— 從 2017.2-6182 版開始提供。 |
| web-listen-endpoints | string | 伺服器 | 【'0.0.0.0'， '：：'】 | 指定 DCV 接聽傳入 Web 連線的端點 — 指定 DCV 接聽傳入 Web 連線的端點清單。端點可以是本機可繫結的 IPv4 地址清單 (「0.0.0.0」用於萬用字元所有可能的地址），或可繫結的 IPv6 地址 ('：：' 用於萬用字元所有可能的地址），其選用連接埠以冒號 ('：') 分隔。例如，'1.2.3.4：5678' 會在與 '1.2.3.4' 地址相關聯的介面上接聽傳入連線，連接埠為 5678。如果未指定連接埠，則 'web-port' 中的設定將用作預設值。若要指定具有 IPv6 地址的連接埠，請以方括號括住地址 （例如 '【：：1】：8443')。也支援包含明確界面的 IPv6 地址 （例如 '【：：%eth1】：8443')。— 自 2022.0-11954 版開始提供。 |
| web-port | integer - DWORD (32 位元） | 伺服器 | 8443 | 用戶端的 TCP 連接埠 — 指定 DCV 伺服器接聽用戶端連線的 TCP 連接埠。連接埠號碼必須為介於 1024 到 65535 的數字。如需如何套用此設定的詳細資訊，請參閱「web-listen-endpoints」設定。— 從 2017.0-4100 版開始提供。 |
| web-root | string | 伺服器 | '' | 內嵌 Web 伺服器的文件根 — 指定內嵌 Web 伺服器的文件根。— 從 2017.0-4100 版開始提供。 |
| web-url-path | string | 伺服器 | '/' | 內嵌 Web 伺服器的 URL 路徑 — 指定內嵌 Web 伺服器的 URL 路徑，必須以 '/' 開頭。例如，設定為 /test/foo 表示 Web 伺服器可在 https://host:port/test/foo 存取。— 自 2017.0-4100 版開始提供。 |
| web-use-hsts | true 或 false - DWORD (32 位元） | 伺服器 | Linux： true - Windows： 1 | 是否使用 HSTS — 讓此動作強制瀏覽器防止透過 HTTP 傳送任何通訊。完全改用 HTTPS 來傳輸到網頁 (以及所有子網域)。— 自 2017.0-4100 版開始提供。 |
| web-x-frame-options | string | 伺服器 | 'DENY' | 設定 X-Frame-Options 值 — 預設值設定為 DENY。如果您變更此設定，則必須引進另一種形式的保護，以避免點擊劫持攻擊。如果您沒有其他保護，請勿變更此設定。— 從 2017.1-5870 版開始提供。 |
| ws-keepalive-interval | integer - DWORD (32 位元） | 伺服器 | 10 | Websocket 保持連線間隔 — 指定傳送保持連線訊息的間隔 （以秒為單位）。如果設定為 0，則會停用保持連線訊息。— 從 2017.0-4100 版開始提供。 |
display 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [display]區段中的組態參數，以及 Windows Amazon DCV 伺服器的display登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| console-session-default-layout | string | 工作階段 | [] | 主控台工作階段的預設螢幕解析度和位置 — 指定主控台工作階段的預設螢幕解析度和位置。如果設定此項，DCV 會在啟動時設定所請求的配置。可以為每台監視器設定解析度 (w,h) 和位置 (x,y)。將會啟用所有指定的監視器。預設配置範例值：【{'w'：<800>、'h'：<600>、'x'：<0>、'y'：<0>}、{'w'：<1024>、'h'：<768>、'x'：<800>、'y'：<0>}】 — 自 2017.0-5600 版開始提供。 |
| cuda-devices | string | 連線 | [] | 用於串流編碼的 CUDA 裝置 — 指定 DCV 用來分發編碼和 CUDA 工作負載的本機 CUDA 裝置清單。從 nvidia-smi 命令可擷取每個裝置的識別號碼。例如，cuda-devices=['0', '2'] 表示 DCV 使用兩個 GPU，ID 分別為 0 和 2。此設定類似於 CUDA_VISIBLE_DEVICES 環境變數，但僅適用於 DCV。如果未設定此選項，DCV 會使用從 0 開始的增量工作階段索引，以挑選下一個要使用的裝置。— 從 2017.2-6182 版開始提供。 |
| enable-client-resize | true 或 false - DWORD (32 位元） | 工作階段 | Linux： true - Windows： 1 | 是否允許用戶端設定顯示配置 — 指定是否允許用戶端設定顯示配置。— 從 2017.0-4100 版開始提供。 |
| enable-qu | true 或 false - DWORD (32 位元） | 工作階段 | Linux： true - Windows： 1 | 是否傳送品質更新 — 指定是否傳送品質更新。— 從 2017.0-4100 版開始提供。 |
| enable-yuv444-encoding | string | 工作階段 | 「default-off」 | 是否啟用 YUV444 編碼 — 啟用或停用 YUV444 編碼。如果「永遠開啟」，伺服器會偏好針對高色彩準確度進行最佳化的 YUV444 格式。如果「永遠關閉」，伺服器會偏好針對串流效能最佳化的格式。值 'default-on' 和 'default-off' 具有相同的語意，這可讓用戶端決定。允許的值：'always-on'、'always-off'、'default-on'、'default-off'。— 自 2022.0-11954 版開始提供。 |
| grabber-target-fps | integer - DWORD (32 位元） | 工作階段 | 0 | 每秒影格擷取器的目標影格數 — 將上限設定為每秒擷取影格數。值 0 預設為每個特定影格緩衝讀取器的標準行為，例如，回復到目標 Fps，或不要限制抓取。並非所有影格擷取後端都遵守此設定。— 自 2017.1-5870 版開始提供。 |
| max-compressor-threads | integer - DWORD (32 位元） | 工作階段 | 4 | 最大壓縮器執行緒 — 指定壓縮器執行緒的數量上限。— 自 2017.0-4100 版開始提供。 |
| max-head-resolution | string | 自訂 | (4096, 2160) | 最大頭部解析度 — 設定用戶端可請求的顯示頭部解析度上限。顯示蓋等同於主機監視器。此設定隨著每次的用戶端配置要求而重新載入。當用戶端要求較大的顯示蓋解析度時，伺服器會調整解析度，以確保符合此選項所設定的最大寬度和高度值。支援的解析度值上限為 (4096、4096)。— 從 2017.0-4100 版開始提供。 |
| max-layout-area | integer - DWORD (32 位元） | 自訂 | 0 | 以像素為單位的最大配置區域 — 設定用戶端可請求之顯示配置的最大區域。將會忽略超過此限制的配置。此最大值旨在提供必須傳送的顯示資料量上限，但不限制顯示器配置幾何。如果設為 0，則不限制配置面積。此設定隨著每次的用戶端配置要求而重新載入。— 從 2019.1-7423 版開始提供。 |
| max-num-heads | integer - DWORD (32 位元） | 自訂 | 4 | 頭部數量上限 — 指定用戶端可請求的顯示頭部數量上限。顯示蓋等同於主機監視器。此設定隨著每次的用戶端配置要求而重新載入。當用戶端要求更多的顯示蓋時，伺服器會調整顯示蓋數目，以避免值超過此選項所設定的值。— 從 2017.0-4100 版開始提供。 |
| min-head-resolution | string | 自訂 | (640, 480) | 最小頭解析度 — 設定用戶端可請求的顯示頭的最小解析度。顯示蓋等同於主機監視器。此設定隨著每次的用戶端配置要求而重新載入。當用戶端要求較小的顯示蓋解析度時，伺服器會調整解析度，以確保符合此選項所設定的最小寬度和高度值。— 從 2017.0-4100 版開始提供。 |
| target-fps | integer - DWORD (32 位元） | 工作階段 | -1 | 每秒目標影格數 — 指定每秒允許的影格數上限。值為 0 表示沒有限制。值 -1 表示目標-fps 值將根據伺服器特性和工作階段類型決定。當版本 < 2020.2 時，無法辨識 -1 值，預設值為 25。— 自 2017.0-4100 版開始提供。 |
| use-grabber-dirty-region | true 或 false - DWORD (32 位元） | 工作階段 | Linux： true - Windows： 1 | 是否使用骯髒區域 — 指定是否使用骯髒的螢幕區域。如果啟用，抓取器會嘗試計算來自螢幕廢棄區域的新影格。— 自 2017.0-4100 版開始提供。 |
| web-client-max-head-resolution | string | 自訂 | (1920, 1080) | Web 用戶端的最大頭解析度 — 設定 Web 用戶端可請求的顯示頭解析度上限。顯示蓋等同於主機監視器。此設定隨著每次的用戶端配置要求而重新載入。如果 Web 用戶端明確設定最大解析度，則會忽略此設定。max-head-resolution 限制選項優先於此選項所設定的最大寬度和高度值。如果值設為 (0, 0)，則會被忽略。— 從 2020.0-8428 版開始提供。 |
display/linux 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [display/linux]區段中的組態參數，以及 Windows Amazon DCV 伺服器的display/linux登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| disable-local-console | true 或 false - DWORD (32 位元） | 工作階段 | Linux： true - Windows： 1 | 突出本機畫面並禁止本機輸入 （僅限 Xorg 上的 Linux 主控台工作階段） — 突出本機連接的監視器 （以防止持續的 DCV 主控台工作階段顯示，並在遠端用戶端連線時停用本機輸入裝置）。監視器和輸入裝置會在最後一個用戶端中斷連線時重新啟用。這可防止本機使用者進入遠端主控台工作階段，並提高隱私權。名稱開頭為 'DCV ' （包含空格） 或 'Xdcv ' （包含空格） 的輸入裝置不會由 設定停用。— 自 2024.0 版開始提供。 |
| enable-console-scaling | true 或 false - DWORD (32 位元） | 工作階段 | Linux：false - Windows：0 | 啟用擴展影格緩衝區以支援任意解析度 （僅限 Xorg 上的 Linux 主控台工作階段） — 相應地將 XRandR 轉換從影格緩衝區設定為掃描輸出緩衝區，以允許主控台工作階段上的任意解析度。如果設為「false」 （預設為預設值），則預期舊版行為 （僅允許本機插入顯示器直接支援的解析度）。如果設為「true」，用戶端可以在伺服器上請求任意解析度，無論實體連線的顯示器是否支援。— 自 2024.0 版開始提供。 |
| gl-displays | string | 工作階段 | [':0.0'] | 3D 加速 X 顯示 — 指定本機 3D 加速 X 顯示和畫面的清單，供 DCV 用於虛擬工作階段中的 OpenGL 轉譯。如果缺漏此值，您無法在虛擬工作階段中執行 OpenGL 應用程式。主控台工作階段會忽略此設定。— 從 2017.0-4100 版開始提供。 |
extensions 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [extensions]區段中的組態參數，以及 Windows Amazon DCV 伺服器的extensions登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| enabled | true 或 false - DWORD (32 位元） | 連線 | Linux： true - Windows： 1 | 是否應該啟用延伸功能 — 指定是否啟用延伸功能。如果停用延伸功能，使用者將無法將第三方延伸模組用於 DCV。— 自 2023.0-14852 版開始提供。 |
input 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [input]區段中的組態參數，以及 Windows Amazon DCV 伺服器的input登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| enable-autorepeat | true 或 false - DWORD (32 位元） | 工作階段 | Linux： true - Windows： 1 | 是否在 Linux 上允許自動重複 — 指定是否允許單一金鑰的自動重複。— 自 2017.2-6182 版開始提供。 |
| enable-gamepad | true 或 false - DWORD (32 位元） | 工作階段 | Linux： true - Windows： 1 | 是否允許遊戲板輸入 — 指定是否啟用遊戲板。— 自 2022.0-11954 版開始提供。 |
| enable-relative-mouse | true 或 false - DWORD (32 位元） | 工作階段 | Linux： true - Windows： 1 | 是否允許相對滑鼠移動 — 指定是否允許相對滑鼠移動。— 從 2017.0-5121 版開始提供。 |
| enable-stylus | true 或 false - DWORD (32 位元） | 工作階段 | Linux： true - Windows： 1 | 是否允許手寫筆輸入 — 指定手寫筆是否已啟用。— 從 2019.0-7318 版開始提供。 |
| enable-touch | true 或 false - DWORD (32 位元） | 工作階段 | Linux： true - Windows： 1 | 是否允許觸控輸入 — 指定觸控是否已啟用。— 自 2017.3-6698 版開始提供。 |
license 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [license]區段中的組態參數，以及 Windows Amazon DCV 伺服器的license登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| license-file | string | 工作階段 | '' | 授權 — 指定在non-EC2 執行個體上執行時用於 DCV 伺服器的授權。授權是透過 RLM 授權授予。它可以包含授權規格清單，在 Windows 上以 '；' 分隔，在 Linux 上以 '：' 分隔。每個授權規格都可以是用於延伸評估授權的本機授權檔案，或是以 PORT@HOSTNAME 格式指定的 RLM 伺服器連接埠和主機名稱來進行浮動授權。如果指定多個授權，伺服器將輪流嘗試每個授權，直到第一個授權檔案經過驗證 （例如，授權檔案已正確識別或可聯絡遠端 RLM 伺服器）。如果未指定任何值，伺服器會在 Linux 上尋找預設授權檔案 '/usr/share/license.lic'，在 Windows 上尋找 'C：\Program Files\NICE\DCV\Server\license\license.lic'；如果找不到預設授權檔案，則會使用示範授權。EC2 執行個體上會忽略此參數。— 從 2017.0-4100 版開始提供。 |
log 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [log]區段中的組態參數，以及 Windows Amazon DCV 伺服器的log登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| directory | string | 伺服器 | '' | 日誌輸出目錄 — 指定儲存日誌的目的地。如果未指定，則在 Windows 上會預設為「C:\ProgramData\NICE\DCV\log\」，在 Linux 上會預設為「/var/log/dcv/」。— 從 2017.0-4100 版開始提供。 |
| enable-image-audit | true 或 false - DWORD (32 位元） | 伺服器 | Linux：false - Windows：0 | 啟用傳輸影像的內容稽核 — 指定是否必須將任何傳輸影像的內容儲存在單獨的檔案中。影像將存放在日誌子目錄中，而檔案名稱將報告在稽核 CSV 檔案中。如果停用 Transfer-audit，則會忽略該值。— 自 2023.0-14852 版開始提供。 |
| level | string | 自訂 | 'info' | 日誌層級 — 指定日誌檔案的真實性層級。具體程度 （依其提供的詳細資訊量排序） 為：'error'、'warn'、'info' 和 'debug'。新的值在組態上變更時會立即生效，並傳播到 DCV 代理程式程序。在 <= 2019.1 的版本中，DCV 代理程式程序只會在啟動時設定日誌層級。— 自 2017.0-4100 版開始提供。 |
| max-file-size | integer - DWORD (32 位元） | 伺服器 | 0 | 輪換前以 MegaBytes 為單位的日誌檔案大小上限 — 指定輪換觸發前的日誌檔案大小上限。如果值為 '0'，則會停用依大小輪換，而是在重新排序產生檔案的程序時輪換檔案。— 自 2022.1-13067 版開始提供。 |
| rotate | integer - DWORD (32 位元） | 伺服器 | 10 | 日誌檔案輪換次數 — 指定日誌檔案在移除之前輪換的次數。如果值為 0，會直接移除舊版本而不進行輪換。— 從 2017.0-4100 版開始提供。 |
| 旋轉間隔 | string | 伺服器 | 'none' | 兩個連續日誌檔案輪換之間的最大時間間隔 — 指定兩個連續日誌檔案輪換之間的最大時間間隔。如果值為「無」，則檔案不會根據時間輪換。其他可能的值包括「每分鐘」、「every-twenty-minutes」、「每小時」和「每天」。— 自 2022.1-13067 版開始提供。 |
| 輪換尾碼 | string | 伺服器 | '計數器' | 要附加到輪換日誌檔案的尾碼 — 指定要附加到輪換日誌檔案的尾碼。如果指定「計數器」，則每個輪換的日誌檔案都會附加一個簡單的增加計數器尾碼。如果指定 'timestamp'，格式 'YYYY-MM-DD-HH-MM' 的時間戳記會套用至日誌檔案。如果日誌資料夾中已存在具有該時間戳記的輪換檔案，則時間戳記會附加額外的數值計數器。— 自 2022.1-13067 版開始提供。 |
| transfer-audit | string | 伺服器 | 'none' | 轉移方向至稽核 — 指定要稽核的轉移方向。如果啟用此參數，則會在伺服器和用戶端之間傳輸新的 CSV 檔案日誌。允許使用的值為：'none'、'server-to-client'、'client-to-server' 和 'all'。如果這個值遺失或等於 'none'，則會停用傳輸稽核且不會建立任何檔案。— 自 2017.0-4100 版開始提供。 |
printer 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [printer]區段中的組態參數，以及 Windows Amazon DCV 伺服器的printer登錄機碼。
redirection 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [redirection]區段中的組態參數，以及 Windows Amazon DCV 伺服器的redirection登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| enable-timezone-redirection | string | 工作階段 | 'client-decides' | 允許或拒絕從用戶端到伺服器的時區重新導向 — 允許或拒絕從用戶端到伺服器的時區重新導向。接受的值為：'always-on'、'always-off' 和 'client-decides'。如果設定為「一律開啟」，優先順序使用者用戶端會將其時區傳送至伺服器，並成為伺服器的時區。如果設定為「永遠關閉」，伺服器會向用戶端顯示自己的時區。將捨棄任何用戶端時區訊息。如果設定為「client-decides」，則優先使用者用戶端可以將時區傳送至伺服器，並成為伺服器的時區。用戶端可以選擇不將其時區傳送至伺服器。預設值為 'client-decides'。— 自 2022.2-13907 版開始提供。 |
security 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [security]區段中的組態參數，以及 Windows Amazon DCV 伺服器的security登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| allowed-http-host-regex | string | 伺服器 | '^.+$' | 允許主機規則表達式 — 指定規則表達式模式，表示此 DCV 伺服器可以提供的主機名稱。如果傳入的 HTTP 請求之 Host 標頭不符合此模式，請求本身會失敗並出現 403 禁止狀態碼。這是一個安全措施，旨在阻擋 HTTP Host 標頭攻擊。模式必須為有效且與 Javascript 類似的規則表達式。模式中的字母與大寫和小寫字母相符。範例：'^(www\.)？example\.com$'。— 自 2017.0-4100 版開始提供。 |
| allowed-ws-origin-regex | string | 伺服器 | '^https://.+$' | 允許原始伺服器 — 指定表示此 DCV 伺服器接受之原始伺服器的規則表達式模式。建立 WebSocket 連線時，用戶端交握的 Origin 標頭欄位會指出建立連接的指令碼來源。如果傳入的 HTTP 請求之來源標頭不符合此模式，請求本身會失敗並出現 403 禁止狀態碼。這是一個安全措施，旨在防止跨網站 WebSocket 攔截 (CSWSH) 攻擊。模式必須為有效且與 Javascript 類似的規則表達式。模式中的字母與大寫和小寫字母相符。Origin 標頭的格式：<scheme> "://" <host> [ ":" <port> ]。範例：'^https://(www\.)?example\.com(:443)?$'. — 自 2017.0-4100 版開始提供。 |
| auth-connection-setup-timeout | integer - DWORD (32 位元） | 伺服器 | 120 | 身分驗證通道連線設定逾時 — 指定在逾時之前，允許完成身分驗證通道連線設定程序的時間量 （以秒為單位）。如果程序超過設定的時間，則會關閉該頻道。如果設定為 0，停用身分驗證頻道連線設定逾時。— 從 2017.0-4100 版開始提供。 |
| auth-token-verifier | string | 伺服器 | '' | 身分驗證字符驗證器的端點 — 指定 DCV 伺服器所使用的身分驗證字符驗證器的端點 (URL)。如果為空，則會使用內部身分驗證符記驗證器。如果不是空的，則會立即套用對端點的有效變更，而不需要重新啟動伺服器 （無法在未重新啟動的情況下變更為空）。— 從 2017.0-4100 版開始提供。 |
| auth-token-verifier-timeout | integer - DWORD (32 位元） | 伺服器 | 100 | 驗證字符驗證器的逾時 （以秒為單位）。— 指定等待 DCV 伺服器使用的身分驗證字符驗證器的時間 （以秒為單位）。— 自 2023.0-14852 版開始提供。 |
| authentication | string | 伺服器 | 'system' | 身分驗證方法 — 指定 DCV 伺服器使用的用戶端身分驗證方法。使用 'system' 以將用戶端身分驗證委派給基礎作業系統進行。使用 'none' 以停用用戶端身分驗證並將存取授權給所有用戶端。— 從 2017.0-4100 版開始提供。 |
| authentication-threshold | integer - DWORD (32 位元） | 伺服器 | 3 | 身分驗證閾值 — 指定每個用戶端在伺服器關閉連線之前，可以失敗身分驗證的次數。若要允許不限次數的身分驗證嘗試，請使用 0。— 從 2017.0-4100 版開始提供。 |
| ca-file | string | 自訂 | '' | CA 檔案 — 指定包含 DCV 伺服器信任之憑證授權單位 (CAs的檔案。如果為空，則會使用系統提供的預設信任存放區。— 從 2017.0-4100 版開始提供。 |
| certificate-to-user-file | string | 自訂 | '' | 使用者映射檔案的憑證 — 指定包含使用者映射清單憑證的檔案。— 自 2022.0-11954 版開始提供。 |
| ciphers | string | 伺服器 | 'ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384' | 用於 TLS 連線的加密清單 — 指定用於 TLS 連線的加密清單。加密清單必須以「:」字元分隔，且 openssl 和用戶端必須支援才能使用。— 從 2017.0-4100 版開始提供。 |
| connection-estab-timeout | integer - DWORD (32 位元） | 伺服器 | 5 | 連線建立逾時 — 指定在逾時之前，允許完成連線程序的時間量 （以秒為單位）。如果程序超過設定的時間，則會關閉該連線。如果設定為 0，連線建立不會逾時。— 從 2017.0-4100 版開始提供。 |
| connection-setup-timeout | integer - DWORD (32 位元） | 伺服器 | 5 | 通道連線設定逾時 — 指定在逾時之前，頻道連線設定程序允許的完成時間量 （以秒為單位）。如果程序超過設定的時間，則會關閉該頻道。如果設定為 0，頻道連線設定不會逾時。— 從 2017.0-4100 版開始提供。 |
| crl-file | string | 自訂 | '' | CRL 檔案 — 指定包含憑證撤銷清單 (CRL) 的檔案。— 從 2022.0-11954 版開始提供。 |
| enable-gssapi | true 或 false - DWORD (32 位元） | 伺服器 | Linux： false - Windows： 0 | 啟用 GSSAPI SASL 機制 — 啟用或停用允許使用 kerberos 進行 DCV 身分驗證的 GSSAPI SASL 機制。— 自 2017.3-6698 版開始提供。 |
| max-connections-per-user | integer - DWORD (32 位元） | 伺服器 | 10 | 使用者連線數目上限 — 指定每個使用者允許的並行連線數目上限。超過此數量的連線都會遭到拒絕。— 從 2017.0-4100 版開始提供。 |
| no-tls-strict | true 或 false - DWORD (32 位元） | 自訂 | Linux：false - Windows：0 | 啟用或停用嚴格的憑證驗證 — 啟用或停用連線至外部身分驗證字符驗證器時的嚴格憑證驗證。如果該身分驗證符記驗證器使用自簽憑證，則必須停用嚴格憑證驗證。此參數的變更會立即套用，而不需要重新啟動伺服器。— 從 2017.0-4100 版開始提供。 |
| os-auto-lock | true 或 false - DWORD (32 位元） | 工作階段 | Linux： true - Windows： 1 | 是否要在最後一個用戶端連線結束時鎖定作業系統工作階段 - 如果啟用，作業系統工作階段會在最後一個用戶端連線關閉時鎖定。— 從 2017.1-5777 版開始提供。 |
| pam-service-name | string | 伺服器 | 'dcv' | PAM 服務名稱 — 指定 DCV 使用的 PAM 組態檔案名稱。預設 PAM 服務名稱為 'dcv' 且對應到 '/etc/pam.d/dcv' 組態檔案。此參數只會在使用 'system' 身分驗證方法時使用。— 從 2017.0-4100 版開始提供。 |
| passwd-file | string | 伺服器 | '' | 密碼檔案 — 指定要用來檢查使用者登入資料的密碼檔案 （僅限 dcv 身分驗證模式）。如果為空，請使用此處的預設檔案：Linux 為 ${XDG_CONFIG_HOME}/NICE/dcv/passwd，Windows 為 %CSIDL_LOCAL_APPDATA%\NICE\dcv\passwd。— 從 2017.0-4100 版開始提供。 |
| server-fqdn | string | 伺服器 | '' | 伺服器 FQDN — 指定伺服器的完整網域名稱。空白表示 gethostname()。— 從 2017.3-6698 版開始提供。 |
| service-name | string | 伺服器 | 'dcv' | 服務名稱 — 服務的註冊名稱 （通常是通訊協定名稱）。— 從 2020.0-8428 版開始提供。 |
| supervisor-control | string | 自訂 | 'disabled' | 工作階段的監控控制類型 — 指定工作階段的監控控制類型。可能的值為 'disabled' 和 'enforced'。如果此值設為「強制執行」，則可以將無監督存取許可設定為允許或拒絕協作工作階段中使用者的無擁有者存取。如果允許使用者進行無監督存取，則使用者可以在沒有擁有者的情況下存取工作階段。預設會拒絕擁有者以外的所有使用者此許可。當此值設為「停用」 （預設） 時，伺服器不會強制執行此監控控制和許可。新值一旦在組態中變更，就會生效。— 自 2021.3-11591 版開始提供。 |
| user-realm | string | 伺服器 | '' | 伺服器使用者領域：指定伺服器的使用者領域。— 從 2017.3-6698 版開始提供。 |
session-management 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [session-management]區段中的組態參數，以及 Windows Amazon DCV 伺服器的session-management登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| create-session | true 或 false - DWORD (32 位元） | 伺服器 | Linux：false - Windows：0 | 在伺服器啟動時建立主控台工作階段 — 指定是否要在伺服器啟動時自動建立主控台工作階段 (ID 為「主控台」)。— 自 2017.0-4100 版開始提供。 |
| enable-gl-in-virtual-sessions | string | 工作階段 | 'default-on' | 是否使用 dcv-gl 功能 — 指定是否使用 dcv-gl 功能 （需要授權）。允許的值：'always-on'、'always-off'、'default-on'、'default-off'。— 自 2017.0-4100 版開始提供。 |
| max-concurrent-clients | integer - DWORD (32 位元） | 工作階段 | -1 | 每個工作階段的並行用戶端數量上限 — 指定每個工作階段的並行用戶端數量上限。如果設定為 -1，則無限制。若只要設定自動工作階段的限制，請使用 'session-management/automatic-console-session' 區段的 'max-concurrent-clients'。— 自 2017.0-4100 版開始提供。 |
| max-concurrent-sessions | integer - DWORD (32 位元） | 伺服器 | 0 | 並行工作階段數目上限 — 指定允許的並行工作階段數目上限。此限制目前僅適用於虛擬工作階段，因為主控台工作階段本質上僅限於一個工作階段。指定 0 不強制執行任何限制。— 從 2019.0-7318 版開始提供。 |
| max-sessions-per-user | integer - DWORD (32 位元） | 伺服器 | 0 | 每個使用者的工作階段數目上限 — 指定每個使用者可擁有的允許並行工作階段數目上限。此限制目前僅適用於虛擬工作階段。指定 0 不強制執行任何限制。— 自 2021.0-10242 版開始提供。 |
| 效能設定檔 | string | 自訂 | 'none' | 指定某些功能初始化期間使用的設定檔 — 根據執行個體的效能設定檔調整某些功能的預設設定。未選取設定檔時，會自動根據 CPUs 數量和 GPU 是否存在，來估計設定檔。允許的值為：'low'、'medium'、'high' 和 'none'。— 自 2024.0 版開始提供。 |
| virtual-session-default-layout | string | 工作階段 | [] | 虛擬工作階段的預設配置 — 如果設定此選項，Xdcv 會設定為在啟動時建立指定的配置。可以為每台監視器設定解析度 (w,h) 和位置 (x,y)。將會啟用所有指定的監視器。預設配置範例值：[{'w':<800>, 'h':<600>, 'x':<0>, 'y': <0>}, {'w':<1024>, 'h':<768>, 'x':<800>, 'y':<0>}] 對於此設定，監視器數目上限 (在 virtual-session-monitors 中設定) 優先於陣列中的元素數目。例如，如果已設定五個監視器，但監視器數目上限為四個，則只會建立前四個監視器。如果設定此機碼，則會忽略已啟用的監視器數目 (在 virtual-session-monitors 中指定)。— 從 2017.0-5600 版開始提供。 |
| virtual-session-font-path | string | 工作階段 | '' | 是否要新增特殊字型路徑 — 指定特殊字型的路徑。有些應用程式會需要將特殊字型傳遞到 X 伺服器。— 從 2017.0-4100 版開始提供。 |
| virtual-session-source-profile | true 或 false - DWORD (32 位元） | 工作階段 | Linux：false - Windows：0 | 是否要在工作階段入門中來源使用者設定檔 — 指定執行工作階段入門指令碼的 Shell 是否應來源使用者設定檔。根據預設，這是 false，DCV 將執行工作階段啟動器指令碼，其中包含「bash --noprofile --norc」，自 2021.3-11591 版開始提供。 |
| virtual-session-xdcv-args | string | 工作階段 | '' | 要傳遞給 Xdcv 的其他引數 — 指定要傳遞給 Xdcv 的任何其他引數。— 自 2017.0-4334 版開始提供。 |
session-management/automatic-console-session 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [session-management/automatic-console-session]區段中的組態參數，以及 Windows Amazon DCV 伺服器的session-management/automatic-console-session登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| client-eviction-policy | string | 伺服器 | 'reject-new-connection' | 指定達到限制時如何處理用戶端連線 — 指定要拒絕新連線，還是在每個工作階段的同時用戶端數量達到上限時自動關閉現有連線。允許的值為「reject-new-connection」 （傳入的連線將會關閉） 和「same-user-oldest-connection」 （伺服器會關閉與工作階段長時間未互動的相同使用者的連線，或缺少該資訊，且連線時間最長）。— 自 2022.1-13067 版開始提供。 |
| max-concurrent-clients | integer - DWORD (32 位元） | 伺服器 | -1 | 每個工作階段的並行用戶端數量上限 — 指定每個工作階段允許的並行用戶端數量上限。如果設定為 -1，則無限制。— 從 2017.0-5600 版開始提供。 |
| owner | string | 伺服器 | '' | 自動建立的「主控台」工作階段擁有者 — 指定「主控台」工作階段擁有者的使用者名稱。如果為空，擁有者會是啟動 DCV 伺服器的使用者。只有當 create-session 設定設為 true 時，此設定才會套用至伺服器啟動時自動建立的「主控台」工作階段。— 從 2017.0-5600 版開始提供。 |
| permissions-file | string | 伺服器 | '' | 自動「主控台」工作階段的許可檔案 — 指定要用來檢查使用者 DCV 功能存取的許可檔案路徑。如果為空，只有擁有者能夠完整存取工作階段。— 自 2017.0-5600 版開始提供。 |
| storage-root | string | 伺服器 | '' | 檔案儲存根資料夾的路徑 — 指定要用於主控台工作階段儲存之資料夾的完整路徑。如果 storage-root 空白或資料夾不存在，則會停用檔案儲存。— 自 2017.0-5600 版開始提供。 |
session-management/defaults 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [session-management/defaults]區段中的組態參數，以及 Windows Amazon DCV 伺服器的session-management/defaults登錄機碼。
smartcard 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [smartcard]區段中的組態參數，以及 Windows Amazon DCV 伺服器的smartcard登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| enable-cache | string | 自訂 | 'default-on' | 是否啟用智慧卡快取訊息 — 啟用或停用智慧卡快取。啟用時，DCV 伺服器會快取從用戶端智慧卡收到的最後一個值。後續的呼叫是直接從伺服器快取中擷取，而不是從用戶端。這有助於降低用戶端與伺服器之間的傳輸流量和改善效能。允許的值包括「always-on」、「always-off」、「default-on」和「default-off」。每次啟動用戶端智慧卡應用程式時會從組態中讀取此值。— 從 2017.2-6182 版開始提供。 |
webauthn 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [webauthn]區段中的組態參數，以及 Windows Amazon DCV 伺服器的webauthn登錄機碼。
webcam 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [webcam]區段中的組態參數，以及 Windows Amazon DCV 伺服器的webcam登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| 最大解析度 | string | 連線 | (0、0) | 最大網路攝影機解析度 — 指定可在公開至應用程式的用戶端提供的解析度之間選取的最大網路攝影機解析度。如果缺少此值或 (0、0)，則會使用預設值。預設值：1280x720 用於高和中等效能設定檔，640x480 用於低效能設定檔。— 自 2021.0-10242 版開始提供。 |
| preferred-resolution | string | 連線 | (0、0) | 偏好的網路攝影機解析度 — 在用戶端提供的解析度中指定偏好的網路攝影機解析度。如果不支援指定的解析度，則會選取最接近的相符解析度。如果缺少此值或 (0、0)，則會使用預設值。預設值：640x360 代表高和中等效能設定檔，424x240 代表低效能設定檔。— 自 2021.0-10242 版開始提供。 |
windows 參數
下表說明 Linux Amazon DCV 伺服器/etc/dcv/dcv.conf檔案 [windows]區段中的組態參數，以及 Windows Amazon DCV 伺服器的windows登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| disable-display-sleep | true 或 false - DWORD (32 位元） | 工作階段 | Linux： true - Windows： 1 | 防止顯示器進入省電模式 — 指定是否防止顯示器進入省電模式。— 從 2017.0-4100 版開始提供。 |
| printer | string | 工作階段 | '' | 要設為預設的印表機 — 指定虛擬 DCV 印表機的名稱。名稱用於變更系統上的預設印表機。如果設定為空字串，DCV 不會變更目前的預設印表機。已棄用：使用 'printer' 區段的 'file-printer-name'。— 從 2017.0-4100 版開始提供。 |
