本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
亚马逊DCV服务器参数参考
下表列出了可以配置为自定义 Amazon DCV 服务器的参数。
注意
每个表中的重新加载上下文列指示重新加载参数的时间。可能的上下文包括：
-
server- 在服务器启动时加载一次参数。如果更新参数值，则在重新启动服务器时将加载新值。 -
session- 在创建会话时加载参数。如果更新参数值，则将为后续会话加载新值。 -
connection- 在建立新的客户端连接时加载参数。如果更新参数值，则新值将用于后续客户端连接。 -
custom- 加载参数的条件是该参数特有的。有关更多信息，请参阅参数说明。
主题
audio 参数
下表描述了/etc/dcv/dcv.conf文件[audio]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的audio注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| avsync-support | 字符串 | 会话 | 'auto' | 确定客户端是否可以启用音频/视频同步 - 允许连接的客户端启用音频/视频同步。有效值为“enabled”、“disabled”或“auto”（默认值为“auto”）。如果指定了“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 参数
下表描述了/etc/dcv/dcv.conf文件[clipboard]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的clipboard注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| enabled | 对还是错-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 | 对还是错-DWORD（32 位） | 会话 | Linux：false - Windows：0 | 在 Linux 中启用主选区复制 - Linux 桌面支持多个剪贴板：通用剪贴板和主选区。选择内容后，将更新或复制主选区域。然后，可以使用鼠标的中间按钮或 Shift+Insert 组合键粘贴它。启用此项后，将监控主选区域并将更新传播到客户端。- 自 2019.0-7318 版本起提供。 |
| primary-selection-paste | 对还是错-DWORD（32 位） | 会话 | Linux：false - Windows：0 | 在 Linux 上启用主选区粘贴 - Linux 桌面支持多个剪贴板：通用剪贴板和主选区。选择内容后，将更新或复制主选区域。然后，可以使用鼠标的中间按钮或 Shift+Insert 组合键粘贴它。启用此项后，还会将客户端的剪贴板内容插入主选区中。- 自 2019.0-7318 版本起提供。 |
| update-timeout | 整数-DWORD（32 位） | 会话 | 200 | 更新事件通知超时 - 指定从上次更新事件开始向客户端发送通知的等待时间（以毫秒为单位）。默认值为 200 毫秒。- 自 2020.1-8942 版本起提供。 |
connectivity 参数
下表描述了/etc/dcv/dcv.conf文件[connectivity]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的connectivity注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| disconnect-on-lock | 对还是错-DWORD（32 位） | 自定义 | Linux：false - Windows：0 | 是否在操作系统会话锁定时断开连接客户端 - 启用该参数以在远程操作系统会话锁定时强制断开连接客户端。否则，客户端将继续流式传输远程会话。目前，仅在控制台会话上支持。每次远程操作系统会话锁定时，都会读取该参数值。— 自 2023.1-16220 版本起可用。 |
| disconnect-on-logout | 对还是错-DWORD（32 位） | 自定义 | Linux：false - Windows：0 | 是否在操作系统用户注销时断开连接客户端 - 启用该参数以在远程操作系统用户注销（即关闭操作系统会话）时强制断开连接客户端。否则，客户端将继续流式传输远程会话。目前，仅在控制台会话上支持。每次远程操作系统用户注销时，都会读取该参数值。— 自 2023.1-16220 版本起可用。 |
| enable-quic-frontend | 对还是错-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 | 字符串 | 服务器 | ['0.0.0.0', '::'] | 指定监DCV听传入QUIC连接的端点-指定监听传入QUIC连接DCV的端点列表。端点可以是本地可绑定IPv4地址的列表（'0.0.0.0' 用于通配所有可能的地址），也可以是可绑定IPv6地址（'::' 用于通配所有可能的地址），其可选端口用冒号 (':') 分隔。例如，“1.2.3.4:5678”在端口 5678 上侦听与“1.2.3.4”地址关联的接口上的传入连接。如果未指定端口，则将“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 | 字符串 | 服务器 | [] | 设置要添加到 HTTP /标题中的额外标HTTPS题数组 — 使用它来添加额外的标题。数组中应该填充一些配对的值，例如：[('header_name','header_content')]。可以添加多个标头。- 自 2017.2-6182 版本起提供。 |
| web-listen-endpoints | 字符串 | 服务器 | ['0.0.0.0', '::'] | 指定用于DCV监听传入 Web 连接的端点-指定DCV将在其中监听传入 Web 连接的端点列表。端点可以是本地可绑定IPv4地址的列表（'0.0.0.0' 用于通配所有可能的地址），也可以是可绑定IPv6地址（'::' 用于通配所有可能的地址），其可选端口用冒号 (':') 分隔。例如，“1.2.3.4:5678”在端口 5678 上侦听与“1.2.3.4”地址关联的接口上的传入连接。如果未指定端口，则将“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 | 字符串 | 服务器 | '' | 嵌入式 Web 服务器的文档根目录 - 指定嵌入式 Web 服务器的文档根目录。- 自 2017.0-4100 版本起提供。 |
| web-url-path | 字符串 | 服务器 | '/' | URL嵌入式 Web 服务器的URL路径-指定嵌入式 Web 服务器的路径，必须以 “/” 开头。例如，将其设置为 /test/foo 意味着在 https://host:port/test/foo 可访问该 Web 服务器。- 自 2017.0-4100 版本起提供。 |
| web-use-hsts | 对还是错-DWORD（32 位） | 服务器 | Linux：true - Windows：1 | 是否使用 HSTS-启用此选项可强制浏览器阻止任何通信通过HTTP。所有向网页（以及所有子域名）的转移都将HTTPS改为使用完成。- 自 2017.0-4100 版本起提供。 |
| web-x-frame-options | 字符串 | 服务器 | 'DENY' | 设置 X-Frame-Options值-默认值设置为DENY。如果更改此设置，则必须引入其他保护手段以避免点击劫持攻击。如果您没有其他保护措施，请不要更改此设置。- 自 2017.1-5870 版本起提供。 |
| ws-keepalive-interval | 整数-DWORD（32 位） | 服务器 | 10 | Websocket keepalive 间隔 - 指定发送 keepalive 消息的间隔（以秒为单位）。如果设置为 0，则禁用 keepalive 消息。- 自 2017.0-4100 版本起提供。 |
display 参数
下表描述了/etc/dcv/dcv.conf文件[display]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的display注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| console-session-default-layout | 字符串 | 会话 | [] | 控制台会话的默认屏幕分辨率和位置 - 指定控制台会话的默认屏幕分辨率和位置。如果设置了此选项，则在启动时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 | 字符串 | 连接 | [] | CUDA用于流编码的设备-指定DCV用于分发编码和CUDA工作负载的本地CUDA设备列表。每个设备均由一个可从 nvidia-smi 命令中检索的数字标识。例如，cuda-devices= ['0'，'2'] 表示DCV使用两个GPUs，分别是 0 和 2。IDs此设置类似于 CUDA _ VISIBLE _ DEVICES 环境变量，但它仅适用于DCV。如果未设置该选项，则DCV使用从 0 开始的增量会话索引来选择下一台要使用的设备。- 自 2017.2-6182 版本起提供。 |
| enable-client-resize | 对还是错-DWORD（32 位） | 会话 | Linux：true - Windows：1 | 是否允许客户端设置显示布局 - 指定是否允许客户端设置显示布局。- 自 2017.0-4100 版本起提供。 |
| enable-qu | 对还是错-DWORD（32 位） | 会话 | Linux：true - Windows：1 | 是否发送质量更新 - 指定是否发送质量更新。- 自 2017.0-4100 版本起提供。 |
| enable-yuv444-encoding | 字符串 | 会话 | “default-off” | 是否启用YUV444编码-启用或禁用YUV444编码。如果 “always-on”，则服务器将首选经过优化的YUV444格式，以实现高色彩精度。如果为“always-off”，服务器优先使用针对流式传输性能优化的格式。“default-on”和“default-off”值具有相同的语义，即，由客户端决定。允许的值：always-on、always-off、default-on、default-off。- 自 2022.0-11954 版本起提供。 |
| grabber-target-fps | 整数-DWORD（32 位） | 会话 | 0 | 帧抓取器的目标每秒帧数 - 设置每秒抓取帧数的上限。值 0 默认为每个特定帧缓冲区读取器的标准行为，例如改用 target-fps 或不限制抓取。并非所有帧捕获后端都支持该设置。- 自 2017.1-5870 版本起提供。 |
| max-compressor-threads | 整数-DWORD（32 位） | 会话 | 4 | 最大压缩器线程数 - 指定最大压缩器线程数。- 自 2017.0-4100 版本起提供。 |
| max-head-resolution | 字符串 | 自定义 | (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 | 字符串 | 自定义 | (640, 480) | 最小头分辨率 - 设置客户端可请求的显示头的最小分辨率。显示头等效于主显示器。在发出每个客户端布局请求时将重新加载该设置。当客户端请求较小的头分辨率时，服务器会调整分辨率，以确保它与此选项设置的最小宽度值和最小高度值匹配。- 自 2017.0-4100 版本起提供。 |
| target-fps | 整数-DWORD（32 位） | 会话 | –1 | 目标每秒帧数 - 指定每秒允许的最大帧数。值 0 表示无限制。值为 -1 表示，将根据服务器特性和会话类型确定 target-fps 值。对于低于 2020.2 的版本，无法识别 -1 值，默认值为 25。- 自 2017.0-4100 版本起提供。 |
| use-grabber-dirty-region | 对还是错-DWORD（32 位） | 会话 | Linux：true - Windows：1 | 是否使用脏区域 - 指定是否使用脏屏幕区域。如果启用，则抓取器试图从屏幕的脏区域中抓出新帧。- 自 2017.0-4100 版本起提供。 |
| web-client-max-head-分辨率 | 字符串 | 自定义 | (1920, 1080) | Web 客户端的最大头分辨率 - 设置 Web 客户端可请求的显示头的最大分辨率。显示头等效于主显示器。在发出每个客户端布局请求时将重新加载该设置。如果 Web 客户端明确设置了最大分辨率，则忽略此设置。 max-head-resolution限制选项应用于此选项设置的最大宽度和高度值之上。如果此值设置为 (0, 0)，则忽略该选项。- 自 2020.0-8428 版本起提供。 |
display/linux 参数
下表描述了/etc/dcv/dcv.conf文件[display/linux]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的display/linux注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| disable-local-console | 对还是错-DWORD（32 位） | 会话 | Linux：true - Windows：1 | 空白本地屏幕并禁止本地输入（仅限 Xorg 上的 Linux 控制台会话）— 空白本地连接的显示器以防止显示正在进行的DCV控制台会话，并在连接远程客户端时禁用本地输入设备。在最后一个客户端断开连接后，监视器和输入设备将重新启用。这样可以防止本地用户干预远程控制台会话并提高隐私。该设置不会禁用名称以 “DCV”（含空格）或 “Xdcv”（含空格）开头的输入设备。— 自 2024.0 版本起可用。 |
| enable-console-scaling | 对还是错-DWORD（32 位） | 会话 | Linux：false - Windows：0 | 启用缩放帧缓冲区以支持任意分辨率（仅限 Xorg 上的 Linux 控制台会话）— 通过相应地设置从帧缓冲区到扫描输出缓冲区的XRandR转换，允许控制台会话使用任意分辨率。如果设置为 “false”（这是默认值），则会出现传统行为（仅允许本地插件显示器直接支持的分辨率）。如果设置为 “true”，则无论物理连接的显示器是否支持这些分辨率，客户端都可以在服务器上请求任意分辨率。— 自 2024.0 版本起可用。 |
| gl-displays | 字符串 | 会话 | [':0.0'] | 3D 加速 X 显示器 — 指定本地 3D 加速 X 显示器和用于虚拟会话中 OpenGL 渲染DCV的屏幕的列表。如果缺少此值，则无法在虚拟会话中运行 OpenGL 应用程序。对于控制台会话，忽略此设置。- 自 2017.0-4100 版本起提供。 |
extensions 参数
下表描述了/etc/dcv/dcv.conf文件[extensions]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的extensions注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| enabled | 对还是错-DWORD（32 位） | 连接 | Linux：true - Windows：1 | 是否应启用扩展功能-指定是否启用扩展功能。如果禁用了扩展功能，则用户将无法使用第三方扩展程序DCV。- 自 2023.0-14852 版本起提供。 |
input 参数
下表描述了/etc/dcv/dcv.conf文件[input]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的input注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| enable-autorepeat | 对还是错-DWORD（32 位） | 会话 | Linux：true - Windows：1 | 是否允许在 Linux 上自动重复 - 指定是否允许自动重复单个键。- 自 2017.2-6182 版本起提供。 |
| enable-gamepad | 对还是错-DWORD（32 位） | 会话 | Linux：true - Windows：1 | 是否允许游戏手柄输入 - 指定是否启用游戏手柄。- 自 2022.0-11954 版本起提供。 |
| enable-relative-mouse | 对还是错-DWORD（32 位） | 会话 | Linux：true - Windows：1 | 是否允许相对鼠标移动 - 指定是否允许相对鼠标移动。- 自 2017.0-5121 版本起提供。 |
| enable-stylus | 对还是错-DWORD（32 位） | 会话 | Linux：true - Windows：1 | 是否允许触控笔输入 - 指定是否启用触控笔。- 自 2019.0-7318 版本起提供。 |
| enable-touch | 对还是错-DWORD（32 位） | 会话 | Linux：true - Windows：1 | 是否允许触摸输入 - 指定是否启用触摸。- 自 2017.3-6698 版本起提供。 |
license 参数
下表描述了/etc/dcv/dcv.conf文件[license]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的license注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| license-file | 字符串 | 会话 | '' | 许可证-指定在非EC2实例上运行时DCV服务器要使用的许可证。许可是通过RLM许可证授予的。它可以包含一组许可证规范，以“;”（在 Windows 上）或“:”（在 Linux 上）分隔。每个许可证规范可以是扩展评估许可证的本地许可证文件，也可以是以 PORT @ 格式指定的RLM服务器端口和主机名（HOSTNAME对于浮动许可证）。如果指定了多个许可证，服务器将依次尝试每个许可证，直到第一个许可证得到验证（例如，正确识别许可证文件或可以联系远程RLM服务器）。如果未指定任何值，服务器将在 Linux 上查找默认许可证文件 “/usr/share/license/license/license.lic”，在 Windows 上查找 “C:\Program Files\\\ ServerNICE\ licenseDCV\ license.lic”；如果找不到默认许可证文件，则使用演示许可证。在EC2实例上会忽略此参数。- 自 2017.0-4100 版本起提供。 |
log 参数
下表描述了/etc/dcv/dcv.conf文件[log]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的log注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| directory | 字符串 | 服务器 | '' | 日志输出目录 - 指定将日志保存到的目标。如果未指定，则在 Windows 上默认为 “C:\\ProgramData\ log NICEDCV\”，在 Linux 上默认为 “/var/log/dcv/”。- 自 2017.0-4100 版本起提供。 |
| enable-image-audit | 对还是错-DWORD（32 位） | 服务器 | Linux：false - Windows：0 | 启用传输的图像的内容审核 - 指定是否必须将任何传输的图像内容保存在单独的文件中。图像将存储在日志子目录中，文件名将在审计CSV文件中报告。如果禁用了 transfer-audit，将忽略该值。- 自 2023.0-14852 版本起提供。 |
| level | 字符串 | 自定义 | “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 版本起提供。 |
| rotation-interval | 字符串 | 服务器 | “none” | 两次连续日志文件轮换的最大时间间隔 - 指定两次连续日志文件轮换的最大时间间隔。如果值为“none”，则不会根据时间轮换文件。其他可能的值为 “每分钟”、“”、“每小时every-twenty-minutes” 和 “每天”。- 自 2022.1-13067 版本起提供。 |
| rotation-suffix | 字符串 | 服务器 | “counter” | 要附加到轮换的日志文件的后缀 - 指定要附加到轮换的日志文件的后缀。如果指定了“counter”，则将一个简单的递增计数器后缀附加到每个轮换的日志文件中。如果指定了 “时间戳”，则会将格式为 “YYYY-MM-DD-HH-MM” 的时间戳应用于日志文件。如果具有该时间戳的轮换文件在日志文件夹中已存在，则会在该时间戳后面附加一个额外数字计数器。- 自 2022.1-13067 版本起提供。 |
| transfer-audit | 字符串 | 服务器 | “none” | 要审核的传输方向 - 指定要审核的传输方向。如果启用此参数，则新的CSV文件会记录服务器和客户端之间的传输。允许的值为：'无'、'、server-to-client' 和 client-to-server '全部'。如果此值缺失或等于“none”，则禁用传输审核且不创建文件。- 自 2017.0-4100 版本起提供。 |
printer 参数
下表描述了/etc/dcv/dcv.conf文件[printer]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的printer注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| file-printer-name | 字符串 | 自定义 | 'DCV打印机' | 用于文件下载的虚拟DCV打印机的名称-表示DCV服务器上虚拟DCV打印机名称的字符串。在 Linux 中，每次创建新的 Linux DCV 会话时，都会从配置中读取此值。如果此设置为非空且以字符串PREFIX作为值，则将在中CUPS注册名为 “PREFIX-SESSION-NUMBER” 的新虚拟打印机。如果此设置为空，则不会注册任何DCV虚拟打印机。在 Windows 中，该设置用于更改系统上的默认打印机。如果设置为空字符串，则DCV不会更改当前的默认打印机。- 自 2022.0-11954 版本起提供。 |
| use-default-printer | 字符串 | 自定义 | “client-decides” | 决定如何设置默认打印机 - 服务器决定将哪个打印机设置为默认打印机。接受的值为“client-decides”、“always-on”、“always-off”。如果该设置的值为“always-off”，则服务器不会将任何打印机设置为默认打印机。如果该值为 “always-on”，则设置在 “打印机” 部分下的设置 “file-printer-name” 中指定的打印机。如果值为“client-decides”，则设置从客户端发送的默认打印机。如果客户端未发送默认打印机，则设置在 “打印机file-printer-name” 部分下的 “” 中指定的打印机。默认值为“client-decides”。目前仅在 Windows 上支持。- 自 2022.2-13907 版本起提供。 |
redirection 参数
下表描述了/etc/dcv/dcv.conf文件[redirection]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的redirection注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| enable-timezone-redirection | 字符串 | 会话 | “client-decides” | 允许或拒绝从客户端到服务器的时区重定向 - 允许或拒绝将时区从客户端重定向到服务器。接受的值为：“always-on”、“always-off”和“client-decides”。如果设置为“always-on”，则优先用户客户端将其时区发送到服务器，并且该时区变为服务器的时区。如果设置为“always-off”，则服务器向客户端显示自己的时区。将丢弃任何客户端时区消息。如果设置为“client-decides”，则优先用户客户端可以将其时区发送到服务器，并且该时区变为服务器的时区。客户端可以选择不将其时区发送到服务器。默认值为“client-decides”。- 自 2022.2-13907 版本起提供。 |
security 参数
下表描述了/etc/dcv/dcv.conf文件[security]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的security注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| allowed-http-host-regex | 字符串 | 服务器 | '^.+$' | 允许的主机正则表达式-指定表示此DCV服务器可以提供的主机名的正则表达式模式。如果传入HTTP请求的主机标头与此模式不匹配，则请求本身将失败，状态码为 403 Forbidden。这是一种防止HTTP主机标头攻击的安全措施。该模式必须是有效的类似于 Javascript 的正则表达式。模式中的字母大小写同时匹配。示例：“^(www\.)?example\.com$”。- 自 2017.0-4100 版本起提供。 |
| allowed-ws-origin-regex | 字符串 | 服务器 | “^https://.+$” | 允许的来源-指定表示此DCV服务器接受的来源的正则表达式模式。建立 WebSocket 连接时，客户端握手中的 Origin 标头字段会指示建立连接的脚本的来源。如果传入HTTP请求的 Origin 标头与此模式不匹配，则请求本身将失败，状态码为 403 Forbidden。这是一种防止跨站 WebSocket 劫持 () CSWSH 攻击的安全措施。该模式必须是有效的类似于 Javascript 的正则表达式。模式中的字母大小写同时匹配。源标头的形式如下：<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 | 字符串 | 服务器 | '' | 身份验证令牌验证器的端点-指定服务器使用的身份验证令牌验证器的端点 (URL)。DCV如果为空，则使用内部身份验证令牌验证程序。如果不为空，则立即应用对端点的有效更改，无需重新启动服务器（如果不重新启动就无法更改为空）。- 自 2017.0-4100 版本起提供。 |
| auth-token-verifier-timeout | 整数-DWORD（32 位） | 服务器 | 100 | 身份验证令牌验证程序超时（以秒为单位） — 指定等待DCV服务器使用的身份验证令牌验证器的时间（以秒为单位）。- 自 2023.0-14852 版本起提供。 |
| authentication | 字符串 | 服务器 | “system” | 身份验证方法-指定DCV服务器使用的客户机身份验证方法。使用“system”将客户端身份验证工作委派给底层操作系统。使用“none”以禁用客户端身份验证并授权访问所有客户端。- 自 2017.0-4100 版本起提供。 |
| authentication-threshold | 整数-DWORD（32 位） | 服务器 | 3 | 身份验证阈值 - 指定在服务器关闭连接之前每个客户端可以失败的身份验证次数。要允许无限制的身份验证尝试，请使用 0。- 自 2017.0-4100 版本起提供。 |
| ca-file | 字符串 | 自定义 | '' | CA 文件 — 指定包含DCV服务器信任的证书颁发机构 (CAs) 的文件。如果为空，请使用系统提供的默认信任存储。- 自 2017.0-4100 版本起提供。 |
| certificate-to-user-file | 字符串 | 自定义 | '' | 证书到用户映射文件 - 指定包含证书到用户映射列表的文件。- 自 2022.0-11954 版本起提供。 |
| ciphers | 字符串 | 服务器 | '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 | 字符串 | 自定义 | '' | CRLfile — 指定包含证书吊销列表的文件 (CRL)。- 自 2022.0-11954 版本起提供。 |
| enable-gssapi | 对还是错-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 | 对还是错-DWORD（32 位） | 自定义 | Linux：false - Windows：0 | 启用或禁用严格证书验证 - 在连接到外部身份验证令牌验证程序时启用或禁用严格证书验证。如果身份验证令牌验证程序使用自签名证书，则必须禁用严格的证书验证。无需重新启动服务器即可立即应用对此参数的更改。- 自 2017.0-4100 版本起提供。 |
| os-auto-lock | 对还是错-DWORD（32 位） | 会话 | Linux：true - Windows：1 | 是否在最后一个客户端连接结束时锁定操作系统会话 - 如果启用，则在关闭最后一个客户端连接时锁定操作系统会话。- 自 2017.1-5777 版本起提供。 |
| pam-service-name | 字符串 | 服务器 | “dcv” | PAM服务名称-指定使用的PAM配置文件的名称DCV。默认PAM服务名称为 “dcv”，与 /etc/pam.d/dcv 配置文件相对应。仅当使用“system”身份验证方法时才使用此参数。- 自 2017.0-4100 版本起提供。 |
| passwd-file | 字符串 | 服务器 | '' | 密码文件 - 指定用于检查用户凭证的密码文件（仅适用于 DCV 身份验证模式）。如果为空，则使用 Linux 的 $ {XDGCONFIG_HOME} NICE /dcv/passwd 中的默认文件，对于 Windows 使用% CSIDL _ LOCAL _APPDATA%\\ dcvNICE\ passwd 中的默认文件。- 自 2017.0-4100 版本起提供。 |
| server-fqdn | 字符串 | 服务器 | '' | 服务器 FQDN-指定服务器的完全限定域名。空白表示 gethostname()。- 自 2017.3-6698 版本起提供。 |
| service-name | 字符串 | 服务器 | “dcv” | 服务名称 - 服务的注册名称（通常是协议名称）。- 自 2020.0-8428 版本起提供。 |
| supervision-control | 字符串 | 自定义 | “disabled” | 会话的监督控制类型 - 指定会话的监督控制类型。可能的值为“disabled”和“enforced”。如果该值设置为“enforced”，则可以将无监督访问权限设置为允许或拒绝用户在协作会话中进行无所有者访问。如果允许用户进行无监督访问，则用户可以在没有所有者的情况下访问会话。默认情况下，为所有者以外的所有用户拒绝该权限。如果该值设置为“disabled”（默认值），则服务器不会强制实施该监督控制和权限。在配置中更改后，新值立即生效。- 自 2021.3-11591 版本起提供。 |
| user-realm | 字符串 | 服务器 | '' | 服务器用户领域 - 指定服务器的用户领域。- 自 2017.3-6698 版本起提供。 |
session-management 参数
下表描述了/etc/dcv/dcv.conf文件[session-management]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的session-management注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| create-session | 对还是错-DWORD（32 位） | 服务器 | Linux：false - Windows：0 | 在服务器启动时创建控制台会话 - 指定是否在服务器启动时自动创建控制台会话（ID 为“console”）。- 自 2017.0-4100 版本起提供。 |
| enable-gl-in-virtual-会话 | 字符串 | 会话 | “default-on” | 是否使用 dcv-gl 功能 - 指定是否使用 dcv-gl 功能（需要许可证）。允许的值：always-on、always-off、default-on、default-off。- 自 2017.0-4100 版本起提供。 |
| max-concurrent-clients | 整数-DWORD（32 位） | 会话 | –1 | 每个会话的最大并发客户端数 - 指定每个会话的最大并发客户端数。如果设置为 -1，则表示无限制。要仅为自动会话设置限制，请使用 “会话管理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 版本起提供。 |
| 性能概况 | 字符串 | 自定义 | “none” | 指定在初始化某些功能时使用的配置文件-根据实例的性能配置文件调整某些功能的默认设置。如果未选择配置文件，则会根据配置文件数量CPUs以及GPU是否存在，自动估算配置文件。允许的值为：“低”、“中”、“高” 和 “无”。— 自 2024.0 版本起可用。 |
| virtual-session-default-layout | 字符串 | 会话 | [] | 虚拟会话的默认布局 - 如果设置了该参数，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 | 字符串 | 会话 | '' | 是否添加特殊字体路径 - 指定特殊字体的路径。有些应用程序要求将特殊字体传递到 X 服务器。- 自 2017.0-4100 版本起提供。 |
| virtual-session-source-profile | 对还是错-DWORD（32 位） | 会话 | Linux：false - Windows：0 | 是否在会话启动器中获取用户配置文件 - 指定运行会话启动器脚本的 Shell 是否应获取用户配置文件。默认情况下，这是错误的，DCV将使用 “bash--noprofile--norc” 运行会话启动脚本 — 自 2021.3-11591 版本起可用。 |
| virtual-session-xdcv-args | 字符串 | 会话 | '' | 传递给 Xdcv 的其他参数 - 指定要传递给 Xdcv 的任何其他参数。- 自 2017.0-4334 版本起提供。 |
session-management/automatic-console-session 参数
下表描述了/etc/dcv/dcv.conf文件[session-management/automatic-console-session]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的session-management/automatic-console-session注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| client-eviction-policy | 字符串 | 服务器 | 'reject-new-connection' | 指定达到限制时如何处理客户端连接 - 指定在达到每个会话的最大并发客户端数时是拒绝新连接，还是自动关闭现有的连接。允许的值为 reject-new-connection “”（传入的连接将被关闭）和 “same-user-oldest-connection”（服务器将关闭与会话交互时间最长的同一个用户的连接，或者如果没有该信息，则关闭与最早的连接时间最早的用户的连接）。- 自 2022.1-13067 版本起提供。 |
| max-concurrent-clients | 整数-DWORD（32 位） | 服务器 | –1 | 每个会话的最大并发客户端数 - 指定每个会话允许的最大并发客户端数。如果设置为 -1，则表示无限制。- 自 2017.0-5600 版本起提供。 |
| owner | 字符串 | 服务器 | '' | 自动创建的“console”会话的所有者 - 指定“console”会话所有者的用户名。如果为空，则所有者是启动DCV服务器的用户。此设置仅在 create-session 设置为“true”的情况下，适用于在服务器启动时自动创建的“控制台”会话。- 自 2017.0-5600 版本起提供。 |
| permissions-file | 字符串 | 服务器 | '' | 自动 “控制台” 会话的权限文件-指定用于检查用户对DCV功能的访问权限的权限文件的路径。如果为空，则只有所有者才对会话拥有完全访问权限。- 自 2017.0-5600 版本起提供。 |
| storage-root | 字符串 | 服务器 | '' | 文件存储根文件夹的路径 - 指定用于控制台会话存储的文件夹的完整路径。如果 storage-root 为空或该文件夹不存在，则禁用文件存储。- 自 2017.0-5600 版本起提供。 |
session-management/defaults 参数
下表描述了/etc/dcv/dcv.conf文件[session-management/defaults]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的session-management/defaults注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| permissions-file | 字符串 | 会话 | '' | 所有会话中包含的默认权限 - 指定要与用户为每个会话选择的权限自动合并的权限文件的路径。如果为空，请使用 “default.perm” 文件，该文件位于 Linux 的 /etc/dcv/ 中，或者位于 Windows 的DCV安装文件夹（例如 'C:\Program Files\\\ ServerNICE\ DCV conf'）中。- 自 2017.0-5600 版本起提供。 |
smartcard 参数
下表描述了/etc/dcv/dcv.conf文件[smartcard]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的smartcard注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| enable-cache | 字符串 | 自定义 | “default-on” | 是否启用智能卡缓存消息 - 启用或禁用智能卡缓存。启用后，DCV服务器会缓存从客户端智能卡上接收到的最后一个值。未来的调用直接从服务器的缓存中检索，而不是从客户端检索。这有助于减少在客户端和服务器之间传输的流量，并提高性能。允许的值包括“always-on”、“always-off”、“default-on”和“default-off”。每当启动客户端智能卡应用程序时，都会从配置中读取此值。- 自 2017.2-6182 版本起提供。 |
webauthn 参数
下表描述了/etc/dcv/dcv.conf文件[webauthn]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的webauthn注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| enabled | 对还是错-DWORD（32 位） | 会话 | Linux：true - Windows：1 | 是否应启用 webauthn 重定向功能-此设置控制请求的重定向。 WebAuthn 启用后，它允许用户使用本地身份验证器（例如 Windows Hello 或其他身份验证器）对 Web 资源进行身份验证。 YubiKey如果您禁用此设置，则 WebAuthn 重定向将被禁用，并且用户将无法使用其本地身份验证器。— 自 2023.1-16220 版本起可用。 |
webcam 参数
下表描述了/etc/dcv/dcv.conf文件[webcam]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的webcam注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| max-resolution | 字符串 | 连接 | (0, 0) | 网络摄像头最大分辨率-指定可在向应用程序公开的客户端提供的分辨率中选择的最大网络摄像头分辨率。如果缺少此值或 (0, 0)，则将使用默认值。默认值：1280x720 表示高性能和中等性能配置文件，640x480 表示低性能配置文件。- 自 2021.0-10242 版本起提供。 |
| preferred-resolution | 字符串 | 连接 | (0, 0) | 首选的网络摄像头分辨率 - 在客户端提供的分辨率中指定首选的网络摄像头分辨率。如果不支持指定的分辨率，则选择最接近的匹配分辨率。如果缺少此值或 (0, 0)，则将使用默认值。默认值：640x360 表示高性能和中等性能配置文件，424x240 表示低性能配置文件。- 自 2021.0-10242 版本起提供。 |
windows 参数
下表描述了/etc/dcv/dcv.conf文件[windows]部分中适用于 Linux 亚马逊DCV服务器的配置参数以及 Windows 亚马逊DCV服务器的windows注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| disable-display-sleep | 对还是错-DWORD（32 位） | 会话 | Linux：true - Windows：1 | 禁止显示器进入节能模式 - 指定是否禁止显示器进入节能模式。- 自 2017.0-4100 版本起提供。 |
| printer | 字符串 | 会话 | '' | 要设置为默认打印机-指定虚拟DCV打印机的名称。该名称用于更改系统上的默认打印机。如果设置为空字符串，则DCV不会更改当前的默认打印机。已弃用：使用 “打印机file-printer-name” 部分的 “”。- 自 2017.0-4100 版本起提供。 |