本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
NICE DCV 服务器参数参考
下表列出了可以配置以自定义 NICE DCV 服务器的参数。
注意
每个表中的重新加载上下文列指示重新加载参数的时间。可能的上下文包括：
-
server- 在服务器启动时加载一次参数。如果更新参数值，则在重新启动服务器时将加载新值。 -
session- 在创建会话时加载参数。如果更新参数值，则将为后续会话加载新值。 -
connection- 在建立新的客户端连接时加载参数。如果更新参数值，则新值将用于后续客户端连接。 -
custom- 加载参数的条件是该参数特有的。有关更多信息，请参阅参数说明。
主题
audio 参数
下表介绍了 Linux NICE DCV 服务器的 [audio] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE 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 参数
下表介绍了 Linux NICE DCV 服务器的 [clipboard] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE 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 NICE DCV 服务器的 [connectivity] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE DCV 服务器的 connectivity 注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| disconnect-on-lock | true 或 false - DWORD（32 位） | 自定义 | Linux：false - Windows：0 | 是否在操作系统会话锁定时断开连接客户端 - 启用该参数以在远程操作系统会话锁定时强制断开连接客户端。否则，客户端将继续流式传输远程会话。目前，仅在控制台会话上支持。每次远程操作系统会话锁定时，都会读取该参数值。- 自 2023.1 版本起提供。 |
| disconnect-on-logout | true 或 false - DWORD（32 位） | 自定义 | Linux：false - Windows：0 | 是否在操作系统用户注销时断开连接客户端 - 启用该参数以在远程操作系统用户注销（即关闭操作系统会话）时强制断开连接客户端。否则，客户端将继续流式传输远程会话。目前，仅在控制台会话上支持。每次远程操作系统用户注销时，都会读取该参数值。- 自 2023.1 版本起提供。 |
| enable-quic-frontend | true 或 false - DWORD（32 位） | server | Linux：false - Windows：0 | 是否启用 QUIC 前端 - 指定是否应启用 QUIC 前端。- 自 2020.2-9508 版本起提供。 |
| idle-timeout | 整数 - DWORD（32 位） | 自定义 | 60 | 空闲超时 - 指定断开连接空闲客户端之前等待的分钟数。指定 0 表示从不断开空闲客户端。每 5 秒读取此参数值一次。- 自 2017.0-4100 版本起提供。 |
| idle-timeout-warning | 整数 - DWORD（32 位） | 自定义 | 350 | 空闲超时警告 - 指定在向空闲客户端发出空闲超时断开连接警告之前等待的秒数（相对于空闲超时）。指定 0 表示从不向空闲客户端发出警告。- 自 2017.4-6898 版本起提供。 |
| quic-listen-endpoints | 字符串 | server | ['0.0.0.0', '::'] | 指定 DCV 侦听传入 QUIC 连接的终端节点 - 指定 DCV 将侦听传入 QUIC 连接的终端节点列表。终端节点可以是本地可绑定 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 位） | server | 8443 | QUIC 前端的 UDP 端口 - 指定 DCV 服务器侦听客户端连接的 UDP 端口。端口号必须介于 1024 和 65535 之间。有关如何应用该设置的更多详细信息，请参阅“quic-listen-endpoints”设置。- 自 2020.2-9508 版本起提供。 |
| web-listen-endpoints | 字符串 | server | ['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 位） | server | 8443 | 客户端的 TCP 端口 - 指定 DCV 服务器侦听客户端连接的 TCP 端口。端口号必须介于 1024 和 65535 之间。有关如何应用该设置的更多详细信息，请参阅“web-listen-endpoints”设置。- 自 2017.0-4100 版本起提供。 |
| web-root | 字符串 | server | '' | 嵌入式 Web 服务器的文档根目录 - 指定嵌入式 Web 服务器的文档根目录。- 自 2017.0-4100 版本起提供。 |
| web-url-path | 字符串 | server | '/' | 嵌入式 Web 服务器的 URL 路径 - 指定嵌入式 Web 服务器的 URL 路径，必须以“/”开头。例如，将其设置为 /test/foo 意味着在 https://host:port/test/foo 可访问该 Web 服务器。- 自 2017.0-4100 版本起提供。 |
| web-use-hsts | true 或 false - DWORD（32 位） | server | Linux：true - Windows：1 | 是否使用 HSTS - 启用该参数以强制浏览器禁止通过 HTTP 发送的任何通信。相反，将使用 HTTPS 执行所有到网页（以及所有子域）的传输。- 自 2017.0-4100 版本起提供。 |
| ws-keepalive-interval | 整数 - DWORD（32 位） | server | 10 | Websocket keepalive 间隔 - 指定发送 keepalive 消息的间隔（以秒为单位）。如果设置为 0，则禁用 keepalive 消息。- 自 2017.0-4100 版本起提供。 |
display 参数
下表介绍了 Linux NICE DCV 服务器的 [display] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE 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 使用两个 ID 分别为 0 和 2 的 GPU。此设置与 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 | 字符串 | 会话 | “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) | 最大头分辨率 - 设置客户端请求的显示头的最大分辨率。显示头等效于主显示器。在发出每个客户端布局请求时将重新加载该设置。当客户端请求较大的头分辨率时，服务器会调整分辨率，以确保它与此选项设置的最大宽度值和最大高度值匹配。- 自 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 | true 或 false - DWORD（32 位） | 会话 | Linux：true - Windows：1 | 是否使用脏区域 - 指定是否使用脏屏幕区域。如果启用，则抓取器试图从屏幕的脏区域中抓出新帧。- 自 2017.0-4100 版本起提供。 |
| web-client-max-head-resolution | 字符串 | 自定义 | (1920, 1080) | Web 客户端的最大头分辨率 - 设置 Web 客户端可请求的显示头的最大分辨率。显示头等效于主显示器。在发出每个客户端布局请求时将重新加载该设置。如果 Web 客户端明确设置了最大分辨率，则忽略此设置。基于此选项设置的最大宽度值和最大高度值应用 max-head-resolution 限制选项。如果此值设置为 (0, 0)，则忽略该选项。- 自 2020.0-8428 版本起提供。 |
display/linux 参数
下表介绍了 Linux NICE DCV 服务器的 [display/linux] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE DCV 服务器的 display/linux 注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| gl-displays | 字符串 | 会话 | [':0.0'] | 3D 加速 X 显示器 - 指定 DCV 用于虚拟会话中的 OpenGL 渲染的本地 3D 加速 X 显示器和屏幕列表。如果缺少此值，则无法在虚拟会话中运行 OpenGL 应用程序。对于控制台会话，忽略此设置。- 自 2017.0-4100 版本起提供。 |
input 参数
下表介绍了 Linux NICE DCV 服务器的 [input] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE 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 NICE DCV 服务器的 [license] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE DCV 服务器的 license 注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| license-file | 字符串 | 会话 | '' | 许可证 - 指定 DCV 服务器在非 EC2 实例上运行时使用的许可证。许可是通过 RLM 许可证授予的。它可以包含一组许可证规范，以“;”（在 Windows 上）或“:”（在 Linux 上）分隔。每个许可证规范可以是延期评估许可证的本地许可证文件，也可以是以“端口@主机名”格式为浮动许可证指定的 RLM 服务器端口和主机名。如果指定了多个许可证，服务器将依次尝试每个许可证，直到验证了第一个许可证（例如，正确识别了许可证文件或可以连接到远程 RLM 服务器）。如果未指定任何值，服务器将查找默认许可证文件（Linux 上的“/usr/share/license/license.lic”或 Windows 上的“C:\Program Files\NICE\DCV\Server\license\license.lic”）；如果找不到默认许可证文件，则使用演示许可证。在 EC2 实例上，将忽略该参数。- 自 2017.0-4100 版本起提供。 |
log 参数
下表介绍了 Linux NICE DCV 服务器的 [log] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE DCV 服务器的 log 注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| directory | 字符串 | server | '' | 日志输出目录 - 指定将日志保存到的目标。如果未指定此项，则默认为“C:\ProgramData\NICE\DCV\log\”（在 Windows 上）和“/var/log/dcv/”（在 Linux 上）。- 自 2017.0-4100 版本起提供。 |
| enable-image-audit | true 或 false - DWORD（32 位） | server | 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 位） | server | 0 | 轮换前的最大日志文件大小（以兆字节为单位）- 指定触发轮换之前的最大日志文件大小。如果值为“0”，则禁用按大小轮换，而是在重新启动生成日志文件的进程时进行轮换。- 自 2022.1-13067 版本起提供。 |
| rotate | 整数 - DWORD（32 位） | server | 10 | 日志文件轮换次数 - 指定在删除之前轮换日志文件的次数。如果值为 0，则删除而不分割旧版本。- 自 2017.0-4100 版本起提供。 |
| rotation-interval | 字符串 | server | “none” | 两次连续日志文件轮换的最大时间间隔 - 指定两次连续日志文件轮换的最大时间间隔。如果值为“none”，则不会根据时间轮换文件。其他可能的值为“every-minute”、“every-twenty-minutes”、“every-hour”和“every-day”。- 自 2022.1-13067 版本起提供。 |
| rotation-suffix | 字符串 | server | “counter” | 要附加到轮换的日志文件的后缀 - 指定要附加到轮换的日志文件的后缀。如果指定了“counter”，则将一个简单的递增计数器后缀附加到每个轮换的日志文件中。如果指定了“timestamp”，则将“YYYY-MM-DD-HH-MM”格式的时间戳应用于日志文件。如果具有该时间戳的轮换文件在日志文件夹中已存在，则会在该时间戳后面附加一个额外数字计数器。- 自 2022.1-13067 版本起提供。 |
| transfer-audit | 字符串 | server | “none” | 要审核的传输方向 - 指定要审核的传输方向。如果启用此参数，则在服务器和客户端之间传输新的 CSV 文件日志。允许的值：none、server-to-client、client-to-server 和 all。如果此值缺失或等于“none”，则禁用传输审核且不创建文件。- 自 2017.0-4100 版本起提供。 |
printer 参数
下表介绍了 Linux NICE DCV 服务器的 [printer] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE DCV 服务器的 printer 注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| file-printer-name | 字符串 | 自定义 | “DCV Printer” | 用于文件下载的虚拟 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”，则设置“printer”部分下面的“file-printer-name”设置中指定的打印机。如果值为“client-decides”，则设置从客户端发送的默认打印机。如果客户端没有发送默认打印机，则设置“printer”部分下面的“file-printer-name”中指定的打印机。默认值为“client-decides”。目前仅在 Windows 上支持。- 自 2022.2-13907 版本起提供。 |
redirection 参数
下表介绍了 Linux NICE DCV 服务器的 [redirection] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE 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 参数
下表介绍了 Linux NICE DCV 服务器的 [security] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE DCV 服务器的 security 注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| allowed-http-host-regex | 字符串 | server | '^.+$' | 允许的主机正则表达式 - 指定一个正则表达式模式，它表示该 DCV 服务器可以提供服务的主机名。如果传入 HTTP 请求的主机标头与此模式不匹配，则请求本身会失败，并伴随出现“403（禁止访问）”的状态码。这是防止 HTTP 主机标头攻击的一种安全手段。该模式必须是有效的类似于 Javascript 的正则表达式。模式中的字母大小写同时匹配。示例：“^(www\.)?example\.com$”。- 自 2017.0-4100 版本起提供。 |
| allowed-ws-origin-regex | 字符串 | server | “^https://.+$” | 允许的来源 - 指定一个正则表达式模式，它表示该 DCV 服务器接受的来源。建立 WebSocket 连接时，客户端的握手中的源标头字段指示建立连接的脚本的源。如果传入 HTTP 请求的源标头与此模式不匹配，则请求本身会失败，并伴随出现“403（禁止访问）”的状态码。这是防止跨站点 WebSocket 劫持 (CSWSH) 攻击的一种安全手段。该模式必须是有效的类似于 Javascript 的正则表达式。模式中的字母大小写同时匹配。源标头的形式如下：<scheme> "://" <host> [ ":" <port> ]。示例：“^https://(www\.)?example\.com(:443)?$”。- 自 2017.0-4100 版本起提供。 |
| auth-connection-setup-timeout | 整数 - DWORD（32 位） | server | 120 | 身份验证通道连接设置超时 - 指定为身份验证通道连接设置过程留出的时间（以秒为单位），以在超时之前完成该过程。如果设置过程超时，则通道被关闭。如果设置为 0，则禁用身份验证通道连接设置超时。- 自 2017.0-4100 版本起提供。 |
| auth-token-verifier | 字符串 | server | '' | 身份验证令牌验证程序的终端节点 - 指定 DCV 服务器使用的身份验证令牌验证程序的终端节点 (URL)。如果为空，则使用内部身份验证令牌验证程序。- 自 2017.0-4100 版本起提供。 |
| auth-token-verifier-timeout | 整数 - DWORD（32 位） | server | 100 | 身份验证令牌验证程序超时（以秒为单位） - 指定等待 DCV 服务器使用的身份验证令牌验证程序的时间（以秒为单位）。- 自 2023.0-14852 版本起提供。 |
| authentication | 字符串 | server | “system” | 身份验证方法 - 指定 DCV 服务器使用的客户端身份验证方法。使用“system”将客户端身份验证工作委派给底层操作系统。使用“none”以禁用客户端身份验证并授权访问所有客户端。- 自 2017.0-4100 版本起提供。 |
| authentication-threshold | 整数 - DWORD（32 位） | server | 3 | 身份验证阈值 - 指定在服务器关闭连接之前每个客户端可以失败的身份验证次数。要允许无限制的身份验证尝试，请使用 0。- 自 2017.0-4100 版本起提供。 |
| ca-file | 字符串 | server | '' | CA 文件 - 指定包含 DCV 服务器信任的证书颁发机构 (CA) 的文件。如果为空，请使用系统提供的默认信任存储。- 自 2017.0-4100 版本起提供。 |
| certificate-to-user-file | 字符串 | 自定义 | '' | 证书到用户映射文件 - 指定包含证书到用户映射列表的文件。- 自 2022.0-11954 版本起提供。 |
| ciphers | 字符串 | server | “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 位） | server | 5 | 连接建立超时 - 指定为连接过程留出的时间（以秒为单位），以在超时之前完成该过程。如果连接过程超时，则连接被关闭。如果设置为 0，则建立连接无超时限制。- 自 2017.0-4100 版本起提供。 |
| connection-setup-timeout | 整数 - DWORD（32 位） | server | 5 | 通道连接设置超时 - 指定为通道连接设置过程留出的时间（以秒为单位），以在超时之前完成该过程。如果设置过程超时，则通道被关闭。如果设置为 0，则通道连接设置无超时限制。- 自 2017.0-4100 版本起提供。 |
| crl-file | 字符串 | 自定义 | '' | CRL 文件 - 指定包含证书吊销列表 (CRL) 的文件。- 自 2022.0-11954 版本起提供。 |
| enable-gssapi | true 或 false - DWORD（32 位） | server | Linux：false - Windows：0 | 启用 GSSAPI SASL 机制 - 启用或禁用 GSSAPI SASL 机制，该机制允许使用 Kerberos 进行 DCV 身份验证。- 自 2017.3-6698 版本起提供。 |
| max-connections-per-user | 整数 - DWORD（32 位） | server | 10 | 用户的最大连接数 - 指定每个用户允许的最大并发连接数。超出的连接将被拒绝。- 自 2017.0-4100 版本起提供。 |
| no-tls-strict | true 或 false - DWORD（32 位） | server | Linux：false - Windows：0 | 启用或禁用严格证书验证 - 在连接到外部身份验证令牌验证程序时启用或禁用严格证书验证。如果身份验证令牌验证程序使用自签名证书，则必须禁用严格的证书验证。- 自 2017.0-4100 版本起提供。 |
| os-auto-lock | true 或 false - DWORD（32 位） | 会话 | Linux：true - Windows：1 | 是否在最后一个客户端连接结束时锁定操作系统会话 - 如果启用，则在关闭最后一个客户端连接时锁定操作系统会话。- 自 2017.1-5777 版本起提供。 |
| pam-service-name | 字符串 | server | “dcv” | PAM 服务名称 - 指定 DCV 使用的 PAM 配置文件的名称。默认 PAM 服务名称为“dcv”，对应 /etc/pam.d/dcv 配置文件。仅当使用“system”身份验证方法时才使用此参数。- 自 2017.0-4100 版本起提供。 |
| passwd-file | 字符串 | server | '' | 密码文件 - 指定用于检查用户凭证的密码文件（仅适用于 DCV 身份验证模式）。如果为空，请对 Linux 使用 ${XDG_CONFIG_HOME}/NICE/dcv/passwd 中的默认文件，或对 Windows 使用 %CSIDL_LOCAL_APPDATA%\NICE\dcv\passwd 中的默认文件。- 自 2017.0-4100 版本起提供。 |
| server-fqdn | 字符串 | server | '' | 服务器 FQDN - 指定服务器完全限定域名。空白表示 gethostname()。- 自 2017.3-6698 版本起提供。 |
| service-name | 字符串 | server | “dcv” | 服务名称 - 服务的注册名称（通常是协议名称）。- 自 2020.0-8428 版本起提供。 |
| supervision-control | 字符串 | 自定义 | “disabled” | 会话的监督控制类型 - 指定会话的监督控制类型。可能的值为“disabled”和“enforced”。如果该值设置为“enforced”，则可以将无监督访问权限设置为允许或拒绝用户在协作会话中进行无所有者访问。如果允许用户进行无监督访问，则用户可以在没有所有者的情况下访问会话。默认情况下，为所有者以外的所有用户拒绝该权限。如果该值设置为“disabled”（默认值），则服务器不会强制实施该监督控制和权限。在配置中更改后，新值立即生效。- 自 2021.3-11591 版本起提供。 |
| user-realm | 字符串 | server | '' | 服务器用户领域 - 指定服务器的用户领域。- 自 2017.3-6698 版本起提供。 |
session-management 参数
下表介绍了 Linux NICE DCV 服务器的 [session-management] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE DCV 服务器的 session-management 注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| create-session | true 或 false - DWORD（32 位） | server | Linux：false - Windows：0 | 在服务器启动时创建控制台会话 - 指定是否在服务器启动时自动创建控制台会话（ID 为“console”）。- 自 2017.0-4100 版本起提供。 |
| enable-gl-in-virtual-sessions | 字符串 | 会话 | “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/automatic-console-session”部分的“max-concurrent-clients”。- 自 2017.0-4100 版本起提供。 |
| max-concurrent-sessions | 整数 - DWORD（32 位） | server | 0 | 最大并发会话数 - 指定允许的最大并发会话数。此限制当前仅适用于虚拟会话，因为控制台会话本质上限于一个。指定 0 表示不强制施加任何限制。- 自 2019.0-7318 版本起提供。 |
| max-sessions-per-user | 整数 - DWORD（32 位） | server | 0 | 每个用户的最大会话数 - 指定每个用户可以拥有的最大允许并发会话数。该限制目前仅适用于虚拟会话。指定 0 表示不强制施加任何限制。- 自 2021.0-10242 版本起提供。 |
| 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 | true 或 false - DWORD（32 位） | 会话 | Linux：false - Windows：0 | 是否在会话启动器中获取用户配置文件 - 指定运行会话启动器脚本的 Shell 是否应获取用户配置文件。默认情况下，该值为 false，DCV 将使用“bash --noprofile --norc”运行会话启动器脚本 - 自 2021.3-11591 版本起提供。 |
| virtual-session-xdcv-args | 字符串 | 会话 | '' | 传递给 Xdcv 的其他参数 - 指定要传递给 Xdcv 的任何其他参数。- 自 2017.0-4334 版本起提供。 |
session-management/automatic-console-session 参数
下表介绍了 Linux NICE DCV 服务器的 [session-management/automatic-console-session] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE DCV 服务器的 session-management/automatic-console-session 注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| client-eviction-policy | 字符串 | server | “reject-new-connection” | 指定达到限制时如何处理客户端连接 - 指定在达到每个会话的最大并发客户端数时是拒绝新连接，还是自动关闭现有的连接。允许的值为“reject-new-connection”（关闭传入连接）和“same-user-oldest-connection”（服务器关闭同一用户未与会话交互时间最长的连接；如果没有该信息，则关闭连接时间最长的连接）。- 自 2022.1-13067 版本起提供。 |
| max-concurrent-clients | 整数 - DWORD（32 位） | server | –1 | 每个会话的最大并发客户端数 - 指定每个会话允许的最大并发客户端数。如果设置为 -1，则表示无限制。- 自 2017.0-5600 版本起提供。 |
| owner | 字符串 | server | '' | 自动创建的“console”会话的所有者 - 指定“console”会话所有者的用户名。如果为空，则所有者为启动了 DCV 服务器的用户。此设置仅在 create-session 设置为“true”的情况下，适用于在服务器启动时自动创建的“控制台”会话。- 自 2017.0-5600 版本起提供。 |
| permissions-file | 字符串 | server | '' | 自动“console”会话的权限文件 - 指定用于检查用户的 DCV 功能访问权限的权限文件的路径。如果为空，则只有所有者才对会话拥有完全访问权限。- 自 2017.0-5600 版本起提供。 |
| storage-root | 字符串 | server | '' | 文件存储根文件夹的路径 - 指定用于控制台会话存储的文件夹的完整路径。如果 storage-root 为空或该文件夹不存在，则禁用文件存储。- 自 2017.0-5600 版本起提供。 |
session-management/defaults 参数
下表介绍了 Linux NICE DCV 服务器的 [session-management/defaults] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE DCV 服务器的 session-management/defaults 注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| permissions-file | 字符串 | 会话 | '' | 所有会话中包含的默认权限 - 指定要与用户为每个会话选择的权限自动合并的权限文件的路径。如果为空，请使用“default.perm”文件。对于 Linux，该文件位于 /etc/dcv/ 下，对于 Windows，该文件位于 DCV 安装文件夹中（如 C:\Program Files\NICE\DCV\Server\conf）。- 自 2017.0-5600 版本起提供。 |
smartcard 参数
下表介绍了 Linux NICE DCV 服务器的 [smartcard] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE DCV 服务器的 smartcard 注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| enable-cache | 字符串 | 自定义 | “default-on” | 是否启用智能卡缓存消息 - 启用或禁用智能卡缓存。启用此项后，NICE DCV 服务器将缓存从客户端的智能卡收到的最后一个值。未来的调用直接从服务器的缓存中检索，而不是从客户端检索。这有助于减少在客户端和服务器之间传输的流量，并提高性能。允许的值包括“always-on”、“always-off”、“default-on”和“default-off”。每当启动客户端智能卡应用程序时，都会从配置中读取此值。- 自 2017.2-6182 版本起提供。 |
webcam 参数
下表介绍了 Linux NICE DCV 服务器的 [webcam] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE DCV 服务器的 webcam 注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| max-resolution | 字符串 | 连接 | (1280, 720) | 最大网络摄像头分辨率 - 指定向应用程序公开的最大网络摄像头分辨率。- 自 2021.0-10242 版本起提供。 |
| preferred-resolution | 字符串 | 连接 | (480, 360) | 首选的网络摄像头分辨率 - 在客户端提供的分辨率中指定首选的网络摄像头分辨率。如果不支持指定的分辨率，则会选择最接近的匹配分辨率，并向应用程序公开该分辨率。如果指定的值之一为 0，则禁用网络摄像头共享。- 自 2021.0-10242 版本起提供。 |
windows 参数
下表介绍了 Linux NICE DCV 服务器的 [windows] 文件的 /etc/dcv/dcv.conf 部分中的配置参数以及 Windows NICE DCV 服务器的 windows 注册表项。
| 参数 | 类型 - Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| disable-display-sleep | true 或 false - DWORD（32 位） | 会话 | Linux：true - Windows：1 | 禁止显示器进入节能模式 - 指定是否禁止显示器进入节能模式。- 自 2017.0-4100 版本起提供。 |
| printer | 字符串 | 会话 | '' | 要设置为默认值的打印机 - 指定虚拟 DCV 打印机的名称。该名称用于更改系统上的默认打印机。如果设置为空字符串，则 DCV 不会更改当前的默认打印机。已弃用：请使用“printer”部分的“file-printer-name”。- 自 2017.0-4100 版本起提供。 |