本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
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 | 整數 - 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 | 整數 - DWORD（32 位元） | 工作階段 | -1 | 剪貼簿映像的最大區域 — 指定可在伺服器和用戶端之間傳輸的剪貼簿映像的最大區域 （像素數）。如果此值遺失或設定為 -1，則不會套用限制。— 自 2017.0-4334 版開始提供。 |
| max-payload-size | 整數 - DWORD（32 位元） | 工作階段 | 20971520 | 剪貼簿資料的大小上限 — 指定可在伺服器和用戶端之間傳輸的剪貼簿資料的大小上限 （以位元組為單位）。支援的值上限為 20 MB。如果遺失此值，則會強制執行上限。— 從 2017.0-4334 版開始提供。 |
| max-text-len | 整數 - 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 | 整數 - 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 | 整數 - DWORD（32 位元） | 自訂 | 60 | 閒置逾時 — 指定中斷閒置用戶端連線之前要等待的分鐘數。指定 0 則永遠不會中斷閒置用戶端。此參數值每秒讀取一次。— 自 2017.0-4100 版開始提供。 |
| idle-timeout-warning | 整數 - 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 | 整數 - DWORD（32 位元） | 伺服器 | 8443 | UDP 連接埠：QUIC指定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 | 整數 - 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 | 伺服器 | '/' | URL 內嵌式 Web 伺服器的路徑 — 指定內嵌式 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 | 整數 - 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使用兩個 GPUs，其中 為 IDs 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 | 整數 - DWORD（32 位元） | 工作階段 | 0 | 每秒影格擷取器的目標影格數 — 將上限設定為每秒擷取影格數。值 0 預設為每個特定影格緩衝讀取器的標準行為，例如退至目標 Fps 或不要限制抓取。並非所有影格擷取後端都會遵循此設定。— 從 2017.1-5870 版開始提供。 |
| max-compressor-threads | 整數 - DWORD（32 位元） | 工作階段 | 4 | 最大壓縮機執行緒 — 指定壓縮機執行緒的最大數量。— 從 2017.0-4100 版開始提供。 |
| max-head-resolution | string | 自訂 | (4096, 2160) | 最大頭解析度 — 設定用戶端可請求的顯示頭解析度上限。顯示蓋等同於主機監視器。此設定隨著每次的用戶端配置要求而重新載入。當用戶端要求較大的顯示蓋解析度時，伺服器會調整解析度，以確保符合此選項所設定的最大寬度和高度值。支援的解析度值上限為 （4096、4096）。— 從 2017.0-4100 版開始提供。 |
| max-layout-area | 整數 - DWORD（32 位元） | 自訂 | 0 | 以像素為單位的最大配置區域 — 設定用戶端可請求的顯示配置像素數的最大區域。將會忽略超過此限制的配置。此最大值旨在提供必須傳送的顯示資料量上限，但不限制顯示器配置幾何。如果設為 0，則不限制配置面積。此設定隨著每次的用戶端配置要求而重新載入。— 從 2019.1-7423 版開始提供。 |
| max-num-heads | 整數 - DWORD（32 位元） | 自訂 | 4 | 最大磁頭數 — 指定用戶端可請求的最大顯示磁頭數。顯示蓋等同於主機監視器。此設定隨著每次的用戶端配置要求而重新載入。當用戶端要求更多的顯示蓋時，伺服器會調整顯示蓋數目，以避免值超過此選項所設定的值。— 從 2017.0-4100 版開始提供。 |
| min-head-resolution | string | 自訂 | (640, 480) | 最小頭解析度 — 設定用戶端可請求的顯示頭的最小解析度。顯示蓋等同於主機監視器。此設定隨著每次的用戶端配置要求而重新載入。當用戶端要求較小的顯示蓋解析度時，伺服器會調整解析度，以確保符合此選項所設定的最小寬度和高度值。— 從 2017.0-4100 版開始提供。 |
| target-fps | 整數 - 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-解析度 | 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轉換至掃描輸出緩衝區，以允許主控台工作階段的任意解析度。如果設為「假」 （這是預設值），則預期舊有行為 （僅允許本機插入顯示器直接支援的解析度）。如果設為「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 | 是否允許 Gamepad 輸入 — 指定是否啟用 Gamepad。— 自 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 | 工作階段 | '' | 授權 — 指定在非EC2 執行個體上執行時要用於DCV伺服器的授權。授權是透過RLM授權授予。它可以包含授權規格清單，在 Windows 上以 '；' 分隔，在 Linux 上以 '：' 分隔。每個授權規格都可以是延伸評估授權的本機授權檔案，或是以 PORT@HOSTNAME 表示浮動授權的格式指定的RLM伺服器連接埠和主機名稱。如果指定多個授權，伺服器將輪流嘗試每個授權，直到第一個驗證 （例如，正確識別授權檔案或聯絡遠端RLM伺服器）。如果未指定任何值，伺服器會在 Linux 上尋找預設授權檔案 '/usr/share/license.lic'，在 Windows 上尋找 'C：\Program Files\NICEDCV\\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 | 整數 - DWORD（32 位元） | 伺服器 | 0 | 輪換 MegaBytes 前的最大日誌檔案大小 - 指定輪換觸發前的最大日誌檔案大小。如果值為 '0'，則會停用依大小輪換，而是在重新排序產生檔案的程序時輪換檔案。— 自 2022.1-13067 版開始提供。 |
| rotate | 整數 - DWORD（32 位元） | 伺服器 | 10 | 日誌檔案輪換次數 — 指定日誌檔案在移除之前輪換的次數。如果值為 0，會直接移除舊版本而不進行輪換。— 從 2017.0-4100 版開始提供。 |
| 輪換間隔 | string | 伺服器 | 'none' | 兩次連續日誌檔案輪換之間的最大時間間隔 — 指定兩次連續日誌檔案輪換之間的最大時間間隔。如果值為「無」，則檔案不會根據時間輪換。其他可能的值包括「每分鐘」、every-twenty-minutes「每小時」和「每天」。— 從 2022.1-13067 版開始提供。 |
| 輪換尾碼 | string | 伺服器 | '計數器' | 要附加到輪換日誌檔案的字尾 — 指定要附加到輪換日誌檔案的字尾。如果指定「計數器」，則每個輪換的日誌檔案都會附加一個簡單的增加計數器字尾。如果指定 '時間戳記'，格式 '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登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| file-printer-name | string | 自訂 | 'DCV印表機' | 用於檔案下載的虛擬DCV印表機名稱 — 代表DCV伺服器上虛擬DCV印表機名稱的字串。在 Linux 中，每次建立新的 Linux DCV工作階段時，都會從組態讀取此值。如果此設定為非空白，且字串PREFIX為值，則名稱為 'PREFIX - SESSION-NUMBER' 的新虛擬印表機將在 中註冊CUPS。如果此設定為空，則不會註冊DCV任何虛擬印表機。在 Windows 中，此設定用於變更系統上的預設印表機。如果設定為空字串， DCV 將不會變更目前的預設印表機。— 自 2022.0-11954 版開始提供。 |
| use-default-printer | string | 自訂 | 'client-decides' | 決定如何設定預設印表機 — 伺服器決定將哪個印表機設定為預設印表機。接受的值為 'client-decides'、'always-on'、'always-off'。如果此設定的值為 'ways-off'，伺服器不會將任何印表機設定為預設值。如果值為 'ways-on'，請在 'printerfile-printer-name' 區段下設定 '' 中指定的印表機。如果值為「client-decides」，則會設定從用戶端傳送的預設印表機。如果用戶端未傳送預設印表機，則會設定 'file-printer-name' 一節 'printer' 下指定的印表機。預設值為 'client-decides'。目前僅支援 Windows。— 從 2022.2-13907 版開始提供。 |
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請求的主機標頭與此模式不相符，請求本身會失敗，並顯示 403 禁止狀態碼。這是防止HTTP主機標頭攻擊的安全措施。模式必須為有效且與 Javascript 類似的規則表達式。模式中的字母與大寫和小寫字母相符。範例：'^（www\.）？example\.com$'。— 從 2017.0-4100 版開始提供。 |
| allowed-ws-origin-regex | string | 伺服器 | '^https://.+$' | 允許原始伺服器 — 指定規則運算式模式，表示此DCV伺服器接受的原始伺服器。建立 WebSocket 連線時，用戶端交握中的 Origin 標頭欄位會指出建立連線的指令碼的原始伺服器。如果傳入HTTP請求的 Origin 標頭與此模式不相符，請求本身會失敗，並顯示 403 禁止狀態碼。這是防止跨網站 WebSocket 劫持 （CSWSH） 攻擊的安全措施。模式必須為有效且與 Javascript 類似的規則表達式。模式中的字母與大寫和小寫字母相符。Origin 標頭的格式：<scheme> "://" <host> [ ":" <port> ]。範例：'^https://(www\.)?example\.com（：443）？$'。— 從 2017.0-4100 版開始提供。 |
| auth-connection-setup-timeout | 整數 - DWORD（32 位元） | 伺服器 | 120 | 身分驗證通道連線設定逾時 — 指定在逾時之前，驗證通道連線設定程序允許的完成時間量 （秒）。如果程序超過設定的時間，則會關閉該頻道。如果設定為 0，停用身分驗證頻道連線設定逾時。— 從 2017.0-4100 版開始提供。 |
| auth-token-verifier | string | 伺服器 | '' | 身分驗證字符驗證器的端點 — 指定DCV伺服器使用的身分驗證字符驗證器的端點 （URL）。如果為空，則會使用內部身分驗證符記驗證器。如果不是空的，則會立即套用對端點的有效變更，而不需要重新啟動伺服器 （無法在未重新啟動的情況下變更為空）。— 從 2017.0-4100 版開始提供。 |
| auth-token-verifier-timeout | 整數 - DWORD（32 位元） | 伺服器 | 100 | 驗證權杖驗證器的逾時 （秒）。— 指定等待DCV伺服器使用的身分驗證字符驗證器的時間 （秒）。— 從 2023.0-14852 版開始提供。 |
| authentication | string | 伺服器 | 'system' | 身分驗證方法 — 指定DCV伺服器使用的用戶端身分驗證方法。使用 'system' 以將用戶端身分驗證委派給基礎作業系統進行。使用 'none' 以停用用戶端身分驗證並將存取授權給所有用戶端。— 從 2017.0-4100 版開始提供。 |
| authentication-threshold | 整數 - 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 | 整數 - DWORD（32 位元） | 伺服器 | 5 | 連線建立逾時 — 指定逾時前允許完成連線程序的時間量 （以秒為單位）。如果程序超過設定的時間，則會關閉該連線。如果設定為 0，連線建立不會逾時。— 從 2017.0-4100 版開始提供。 |
| connection-setup-timeout | 整數 - 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 | 啟用GSSAPISASL機制 — 啟用或停用允許使用 kerberos DCV進行身分驗證的GSSAPISASL機制。— 從 2017.3-6698 版開始提供。 |
| max-connections-per-user | 整數 - 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 服務名稱 — 指定 使用的PAM組態檔案名稱DCV。預設PAM服務名稱為 'dcv'，並與 /etc/pam.d/dcv 組態檔案對應。此參數只會在使用 'system' 身分驗證方法時使用。— 從 2017.0-4100 版開始提供。 |
| passwd-file | string | 伺服器 | '' | 密碼檔案 — 指定要用來檢查使用者憑證的密碼檔案 （僅限 dcv 身分驗證模式）。如果為空，請在 ${XDG_CONFIG_HOME}/NICE/dcv/passwd for Linux 或 %CSIDLLOCAL_APPDATA%NICE\dcv\passwd for Windows 中使用預設檔案。— 從 2017.0-4100 版開始提供。 |
| server-fqdn | string | 伺服器 | '' | 伺服器 FQDN — 指定伺服器完整網域名稱。空白表示 gethostname()。— 從 2017.3-6698 版開始提供。 |
| service-name | string | 伺服器 | 'dcv' | 服務名稱 — 服務的註冊名稱 （通常是通訊協定名稱）。— 從 2020.0-8428 版開始提供。 |
| 監控控制 | string | 自訂 | '停用' | 工作階段的監控控制類型 — 指定工作階段的監控控制類型。可能的值為 '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-工作階段 | string | 工作階段 | 'default-on' | 是否使用 dcv-gl 功能 — 指定是否使用 dcv-gl 功能 （需要授權）。允許的值：'always-on'、'always-off'、'default-on'、'default-off'。— 從 2017.0-4100 版開始提供。 |
| max-concurrent-clients | 整數 - DWORD（32 位元） | 工作階段 | -1 | 每個工作階段的並行用戶端數目上限 — 指定每個工作階段的並行用戶端數目上限。如果設定為 -1，則無限制。若要只設定自動工作階段的限制，請使用 'session-management/' 區段max-concurrent-clients的 'automatic-console-session'。— 從 2017.0-4100 版開始提供。 |
| max-concurrent-sessions | 整數 - DWORD（32 位元） | 伺服器 | 0 | 並行工作階段數目上限 — 指定允許的並行工作階段數目上限。此限制目前僅適用於虛擬工作階段，因為主控台工作階段本質上僅限於一個工作階段。指定 0 不強制執行任何限制。— 從 2019.0-7318 版開始提供。 |
| max-sessions-per-user | 整數 - DWORD（32 位元） | 伺服器 | 0 | 每個使用者的最大工作階段數量 — 指定每個使用者可擁有的允許並行工作階段數量上限。此限制目前僅適用於虛擬工作階段。指定 0 不強制執行任何限制。— 自 2021 年 0 月 10242 版開始提供。 |
| 效能設定檔 | string | 自訂 | 'none' | 指定在初始化某些功能時使用的設定檔 — 根據執行個體的效能設定檔調整某些功能的預設設定。未選取設定檔時，如果GPU存在 CPUs和 ，則會根據 的數量自動估算設定檔。允許的值為：'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 | 整數 - 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登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| permissions-file | string | 工作階段 | '' | 所有工作階段中包含的預設許可 — 指定要自動與使用者為每個工作階段選取的許可合併的許可檔案路徑。如果為空，請使用位於 Linux 的 /etc/dcv/ 中的 'default.perm' 檔案，或在 Windows 的DCV安裝資料夾中 （例如，'C：\Program Files\NICE\DCV\Server\conf'）。— 從 2017.0-5600 版開始提供。 |
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登錄機碼。
| 參數 | 類型 - Windows 登錄檔類型 | 重新載入情況 | 預設值 | 描述 |
|---|---|---|---|---|
| enabled | true 或 false - DWORD（32 位元） | 工作階段 | Linux ： true - Windows ： 1 | 是否應該啟用 Webauthn 重新導向功能 — 此設定控制 WebAuthn 請求的重新導向。啟用時，它允許使用者使用其本機身分驗證器來驗證 Web 資源，例如 YubiKey、Windows Hello 或其他。如果您停用此設定， WebAuthn 重新導向將會停用，使用者將無法使用其本機身分驗證器。— 從 2023.1-16220 版開始提供。 |
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 將不會變更目前的預設印表機。已棄用：使用 'printerfile-printer-name' 區段的 ''。— 從 2017.0-4100 版開始提供。 |
