本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
NICE DCV 服务器参数参考
下表列出了可配置为自定义 NICE DCV 服务器的参数。
注意
每个表中的重新加载上下文列指示重新加载参数的时间。可能的上下文包括：
-
server—服务器启动时加载一次参数。如果更新参数值，则在重新启动服务器时将加载新值。 -
session—创建会话时加载参数。如果更新参数值，则将为后续会话加载新值。 -
connection—在建立新的客户端连接时加载参数。如果更新参数值，则新值将用于后续客户端连接。 -
custom—参数加载条件是此参数所特有的。有关更多信息，请参阅参数说明。
主题
audio 参数
下表描述了/etc/dcv/dcv.conf文件[audio]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的audio注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| avsync 支持 | 字符串 | session | 'auto' | 确定客户端是否可以启用音频/视频同步-允许连接的客户端启用音频/视频同步。有效值为 “启用”、“禁用” 或 “自auto”（默认='auto'）。如果指定 “auto”，则仅在控制台会话上启用音频/视频同步，并且仅在加速视频压缩可用时才会启用。— 自 2021.1-10557 版本起可用。 |
| source-channels | 整数 — DWORD（32 位） | session | 2 | Linux 上扬声器设备的频道数-设置 Lin ux 扬声器设备的频道数。该值必须小于或等于设备支持的值。允许的值为：2（立体声）、4（4.0 四声道）、6（5.1 环绕声）、8（7.1 环绕声）。默认值为 2（立体声）。— 自 2020.0-8428 版本起可用。 |
clipboard 参数
下表描述了/etc/dcv/dcv.conf文件[clipboard]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的clipboard注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| enabled | 对或错——DWORD（32 位） | session | Linux：是的—— Windows：1 | 是否应启用剪贴板功能-指定是否启用剪贴板功能。如果禁用剪贴板功能，用户将无法使用剪贴板远程化。剪贴板监控也将被禁用。— 自 2020.0-8428 版本起可用。 |
| max-image-area | 整数 — DWORD（32 位） | session | –1 | 剪贴板图像的最大面积-指定可以从服务器传输到客户端的剪贴板图像的最大面积（像素数）。如果此值缺失或设置为 -1，则无限制。— 自 2017.0-4334 版本起可用。 |
| max-payload-size | 整数 — DWORD（32 位） | session | 20971520 | 剪贴板数据的最大大小-指定可以从服务器传输到客户端的剪贴板数据的最大大小（以字节为单位）。如果缺少此值，则默认限制为 20 MB。— 自 2017.0-4334 版本起可用。 |
| max-text-len | 整数 — DWORD（32 位） | session | –1 | 剪贴板文本的最大字符数-指定可以从服务器传输到客户端的剪贴板文本的最大字符数。如果此值缺失或设置为 -1，则无限制。— 自 2017.0-4334 版本起可用。 |
| primary-selection-copy | 对或错——DWORD（32 位） | session | Linux：错误-Windows：0 | 从 Linux 启用主要选择副本 — Linux 桌面支持多个剪贴板：通用剪贴板和主要选择。选择内容后，将更新或复制主选区域。然后，可以使用鼠标的中间按钮或 Shift+Insert 组合键粘贴它。启用此项后，将监控主选区域并将更新传播到客户端。— 自 2019.0-7318 版本起可用。 |
| primary-selection-paste | 对或错——DWORD（32 位） | session | Linux：错误-Windows：0 | 在 Linux 上启用主要选择的粘贴 — Linux 桌面支持多个剪贴板：通用剪贴板和主要选择。选择内容后，将更新或复制主选区域。然后，可以使用鼠标的中间按钮或 Shift+Insert 组合键粘贴它。启用此项后，还会将客户端的剪贴板内容插入主选区中。— 自 2019.0-7318 版本起可用。 |
| 更新超时 | 整数 — DWORD（32 位） | session | 200 | 更新事件通知超时-指定从上次更新事件开始等待向客户端发送通知的时间（以毫秒为单位）。默认值 200 毫秒。— 自 2020.1-8942 版本起可用。 |
connectivity 参数
下表描述了/etc/dcv/dcv.conf文件[connectivity]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的connectivity注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| enable-quic-frontend | 对或错——DWORD（32 位） | server | Linux：错误-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.0.0.0.0.0.0.0.0.0.0.0.0.0.00'，'] | 指定 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 版本起可用。 |
| 快速端口 | 整数 — DWORD（32 位） | server | 8443 | QUIC 前端的 UDP 端口 — 指定 DCV 服务器侦听客户端连接时使用的 UDP 端口。端口号必须介于 1024 和 65535 之间。有关如何应用此设置的更多详细信息，请参阅quic-listen-endpoints “” 设置。— 自 2020.2-9508 版本起可用。 |
| web-listen-endpoints | 字符串 | server | ['0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.00'，'] | 指定 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 | 对或错——DWORD（32 位） | server | Linux：是的—— Windows：1 | 是否使用 HSTS — 启用此选项可强制浏览器阻止通过 HTTP 发送任何通信。相反，将使用 HTTPS 执行所有到网页（以及所有子域）的传输。— 自 2017.0-4100 版本起可用。 |
| ws-keepalive-interval | 整数 — DWORD（32 位） | server | 10 | Websocket 保持活动间隔 — 指定发送保持连接消息的时间间隔（以秒为单位）。如果设置为 0，则禁用 keepalive 消息。— 自 2017.0-4100 版本起可用。 |
display 参数
下表描述了/etc/dcv/dcv.conf文件[display]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的display注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| console-session-default-layout | 字符串 | session | [] | 控制台会话的默认屏幕分辨率和位置-指定控制台会话的默认屏幕分辨率和位置。如果设置了该项，则 DCV 在启动时设置请求的布局。可以为每个监视器配置分辨率 (w,h) 和位置 (x,y)。启用所有指定的监视器。默认布局示例值：[{'w': <800>、'h': <600>、'x': <0>、'y':<0>}、{'w':、'<1024>h':、'<768>x':、'y': <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 | 对或错——DWORD（32 位） | session | Linux：是的—— Windows：1 | 是否允许客户端设置显示布局-指定是否允许客户端设置显示布局。— 自 2017.0-4100 版本起可用。 |
| enable-qu | 对或错——DWORD（32 位） | session | Linux：是的—— Windows：1 | 是否发送质量更新-指定是否发送质量更新。— 自 2017.0-4100 版本起可用。 |
| 启用 yuv444 编码 | 字符串 | session | “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 位） | session | 0 | 帧抓取器的每秒目标帧数 — 将上限设置为每秒抓取帧数。值为 0 默认为每个特定帧缓冲区读取器的标准行为，例如，回退到 target-fps 或不限制抓取。并非所有帧捕获后端都支持此设置。— 自 2017.1-5870 版本起可用。 |
| max-compressor-threads | 整数 — DWORD（32 位） | session | 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 位） | session | –1 | 每秒目标帧数-指定每秒允许的最大帧数。值 0 表示无限制。值为 -1 表示目标 fps 值将根据服务器特征和会话类型确定。在版本 < 2020.2 时，无法识别 -1 值，默认值为 25。— 自 2017.0-4100 版本起可用。 |
| use-grabber-dirty-region | 对或错——DWORD（32 位） | session | Linux：是的—— 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 NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的display/linux注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| gl-displays | 字符串 | session | [':0.0'] | 3D 加速 X 显示器 — 指定 DCV 在虚拟会话中用于 OpenGL 渲染的本地 3D 加速 X 显示器和屏幕列表。如果缺少此值，则无法在虚拟会话中运行 OpenGL 应用程序。对于控制台会话，忽略此设置。— 自 2017.0-4100 版本起可用。 |
| h264-encoder-displays | 字符串 | 连接 | [] | H.264 编码器 X 显示器-指定支持加速 H.264 编码的本地 X 显示器和屏幕列表。如果为空，则 DCV 使用为 OpenGL 渲染选定的同一显示器。仅当系统上安装的某些 GPU 不使用受支持的技术之一为 H.264 编码提供加速时，此设置很有用。— 自 2017.0-4100 版本起可用。 |
input 参数
下表描述了/etc/dcv/dcv.conf文件[input]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的input注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| enable-autorepeat | 对或错——DWORD（32 位） | session | Linux：是的—— Windows：1 | 是否允许在 Linux 上自动重复-指定是否允许对单个按键进行自动重复。— 自 2017.2-6182 版本起可用。 |
| 启用游戏手柄 | 对或错——DWORD（32 位） | session | Linux：是的—— Windows：1 | 是否允许游戏手柄输入-指定是否启用游戏手柄。— 自 2022.0-11954 版本起可用。 |
| enable-relative-mouse | 对或错——DWORD（32 位） | session | Linux：是的—— Windows：1 | 是否允许鼠标相对移动-指定是否允许相对鼠标移动。— 自 2017.0-5121 版本起可用。 |
| enable-stylus | 对或错——DWORD（32 位） | session | Linux：是的—— Windows：1 | 是否允许触控笔输入-指定是否启用触控笔。— 自 2019.0-7318 版本起可用。 |
| enable-touch | 对或错——DWORD（32 位） | session | Linux：是的—— Windows：1 | 是否允许触摸输入-指定是否启用触摸。— 自 2017.3-6698 版本起可用。 |
license 参数
下表描述了/etc/dcv/dcv.conf文件[license]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的license注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| license-file | 字符串 | session | '' | 许可证 — 指定演示许可证文件或 RLM 服务器端口和主机名。如果在 RLM 服务器上使用的是浮动许可证，请使用此参数以 port@hostname 格式指定 RLM 服务器的端口和主机名。如果您使用的是延期试用许可证，并且没有在默认位置放置 license.lic 文件，请使用此参数指定 license.lic 许可证文件的完整路径。如果该默认文件不存在，则使用试用许可证。从配置中读取此值，并在每次创建新会话时更新。— 自 2017.0-4100 版本起可用。 |
log 参数
下表描述了/etc/dcv/dcv.conf文件[log]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的log注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| directory | 字符串 | server | '' | 日志输出目录-指定保存日志的目的地。如果未指定，则在 Windows 上默认为 “C:ProgramData\\ NICE\ DCV\ log\”，在 Linux 上默认为 “/var/log/dcv/”。— 自 2017.0-4100 版本起可用。 |
| level | 字符串 | 自定义 | “info” | 日志级别-指定日志文件详细级别。详细级别（按它们提供的详细信息量排序）是：“错误”、“警告”、“信息” 和 “调试”。新值在配置上进行更改并传播到 DCV 代理进程后立即生效。对于 2019.1 版本以及之前的版本，仅在 DCV 代理进程启动时设置其日志级别。— 自 2017.0-4100 版本起可用。 |
| max-file-size | 整数 — DWORD（32 位） | server | 0 | 轮换 MegaBytes 前的最大日志文件大小-指定触发轮换之前的最大日志文件大小。如果值为 '0'，则禁用按大小旋转，而是在重新启动生成文件的进程时旋转文件。— 自 2022.1-13067 版本起可用。 |
| rotate | 整数 — DWORD（32 位） | server | 10 | 日志文件轮换次数-指定在删除日志文件之前轮转的次数。如果值为 0，则删除而不分割旧版本。— 自 2017.0-4100 版本起可用。 |
| 旋转间隔 | 字符串 | server | “none” | 两次连续日志文件轮换之间的最大时间间隔-指定两次连续日志文件轮换之间的最大时间间隔。如果值为 “无”，则不根据时间旋转文件。其他可能的值是 “每分钟”、“每小时” 和 “每天”。— 自 2022.1-13067 版本起可用。 |
| 旋转后缀 | 字符串 | server | '计数器' | 要附加到旋转日志文件的后缀-指定要附加到轮换日志文件的后缀。如果指定了 “计数器”，则会在每个轮换的日志文件中附加一个简单的递增计数器后缀。如果指定了 “时间戳”，则将 “YYYY-MM-DD-HH-MM” 形式的时间戳应用于日志文件。如果日志文件夹中已经存在带有该时间戳的旋转文件，则会在时间戳上附加一个额外的数字计数器。— 自 2022.1-13067 版本起可用。 |
| transfer-audit | 字符串 | server | “none” | 向审计转移指示-指定要进行审计的传送方向。如果启用此参数，则在服务器和客户端之间传输新的 CSV 文件日志。允许的值为：“无”、“server-to-client”、“client-to-server” 和 “全部”。如果此值缺失或等于“none”，则禁用传输审核且不创建文件。— 自 2017.0-4100 版本起可用。 |
redirection 参数
下表描述了/etc/dcv/dcv.conf文件[redirection]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的redirection注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| enable-timezone-redirection | 字符串 | session | '客户决定' | 允许或拒绝从客户端到服务器的时区重定向-允许或拒绝时区从客户端重定向到服务器。可接受的值是：“始终开启”、“始终关闭” 和 “客户决定”。如果将其设置为 “always-on”，则优先用户客户端会将其时区发送到服务器，该时区将成为服务器的时区。如果将其设置为 “always-off”，则服务器将向客户端显示自己的时区。任何客户端时区消息都将被丢弃。如果将其设置为 “client-dective”，则优先用户客户端可以将其时区发送到服务器，该时区将成为服务器的时区。客户端可以选择不将其时区发送到服务器。默认值为'客户决定'。— 自 2022.2-13907 版本起可用。 |
security 参数
下表描述了/etc/dcv/dcv.conf文件[security]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的security注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| allowed-http-host-regex | 字符串 | server | '^.+$' | 允许的主机正则表达式-指定代表此 DCV 服务器可以服务的主机名的正则表达式模式。如果传入 HTTP 请求的主机标头与此模式不匹配，则请求本身会失败，并伴随出现“403（禁止访问）”的状态码。这是防止 HTTP 主机标头攻击的一种安全手段。该模式必须是有效的类似于 Javascript 的正则表达式。模式中的字母大小写同时匹配。示例：'^ (www\.)？ 示例\ .com$'。— 自 2017.0-4100 版本起可用。 |
| allowed-ws-origin-regex | 字符串 | server | “^https://.+$” | 允许的来源-指定代表此 DCV 服务器接受的来源的正则表达式模式。建立 WebSocket 连接时，客户端握手中的 Origin 标头字段表示建立连接的脚本的来源。如果传入 HTTP 请求的源标头与此模式不匹配，则请求本身会失败，并伴随出现“403（禁止访问）”的状态码。这是防止跨站 WebSocket 劫持 (CSWSH) 攻击的安全措施。该模式必须是有效的类似于 Javascript 的正则表达式。模式中的字母大小写同时匹配。源标头的形式如下：<scheme> "://" <host> [ ":" <port> ]。示例：'^ https://(www\.)？ 示例\ .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 版本起可用。 |
| 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 文件 | 字符串 | 自定义 | '' | CRL 文件 — 指定包含证书吊销列表（CRL）的文件。— 自 2022.0-11954 版本起可用。 |
| enable-gssapi | 对或错——DWORD（32 位） | server | Linux：错误-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 | 对或错——DWORD（32 位） | server | Linux：错误-Windows：0 | 启用或禁用严格证书验证-在连接到外部身份验证令牌验证器时启用或禁用严格的证书验证。如果身份验证令牌验证程序使用自签名证书，则必须禁用严格的证书验证。— 自 2017.0-4100 版本起可用。 |
| os-auto-lock | 对或错——DWORD（32 位） | session | Linux：是的—— 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 版本起可用。 |
| 监督控制 | 字符串 | 自定义 | '已禁用 ' | 会话的监督控制类型-指定会话的监督控制类型。可能的值是 “禁用” 和 “强制执行”。如果将此值设置为 “强制”，则可以将无监督访问权限设置为允许或拒绝协作会话中用户的无所有者访问。如果允许用户进行无监督访问，则该用户可以在没有所有者的情况下访问会话。默认情况下，除所有者之外的所有用户都被拒绝此权限。当此值设置为 “禁用”（默认）时，服务器不强制执行此监督控制和权限。新值在配置中更改后立即生效。— 自 2021.3-11591 版本起可用。 |
| user-realm | 字符串 | server | '' | 服务器用户领域-为服务器指定用户领域。— 自 2017.3-6698 版本起可用。 |
session-management 参数
下表描述了/etc/dcv/dcv.conf文件[session-management]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的session-management注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| create-session | 对或错——DWORD（32 位） | server | Linux：错误-Windows：0 | 在服务器启动时创建控制台会话-指定是否在服务器启动时自动创建控制台会话（ID 为 “控制台”）。— 自 2017.0-4100 版本起可用。 |
| enable-gl-in-virtual-会议 | 字符串 | session | “default-on” | 是否使用 dcv-gl 功能-指定是否使用 dcv-gl 功能（需要许可证）。允许的值：always-on、always-off、default-on、default-off。— 自 2017.0-4100 版本起可用。 |
| max-concurrent-clients | 整数 — DWORD（32 位） | session | –1 | 每个会话的最大并发客户机数-指定每个会话的最大并发客户机数。如果设置为 -1，则表示无限制。要仅为自动会话设置限制，请使用 “会话管理/max-concurrent-clients” 部分的 “automatic-console-session”。— 自 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 | 字符串 | session | [] | 虚拟会话的默认布局-如果设置了此布局，则将 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 | 字符串 | session | '' | 是否添加特殊字体路径-指定特殊字体的路径。有些应用程序要求将特殊字体传递到 X 服务器。— 自 2017.0-4100 版本起可用。 |
| virtual-session-source-profile | 对或错——DWORD（32 位） | session | Linux：错误-Windows：0 | 是否在会话启动器中获取用户配置文件-指定运行会话启动器脚本的 shell 是否应提供用户配置文件。默认情况下，这是错误的，DCV 将使用 “bash--noprofile--norc” 运行会话启动脚本，自 2021.3-11591 版本起可用。 |
| virtual-session-xdcv-args | 字符串 | session | '' | 要传递给 Xdcv 的其他参数-指定要传递给 Xdcv 的任何其他参数。— 自 2017.0-4334 版本起可用。 |
session-management/automatic-console-session 参数
下表描述了/etc/dcv/dcv.conf文件[session-management/automatic-console-session]部分中用于 Linux NICE DCV 服务器的配置参数以及 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 | '' | 自动创建的 “控制台” 会话的所有者-指定 “控制台” 会话所有者的用户名。如果为空，则所有者为启动了 DCV 服务器的用户。此设置仅在 create-session 设置为“true”的情况下，适用于在服务器启动时自动创建的“控制台”会话。— 自 2017.0-5600 版本起可用。 |
| permissions-file | 字符串 | server | '' | 自动 “控制台” 会话的权限文件-指定权限文件的路径，用于检查用户对 DCV 功能的访问权限。如果为空，则只有所有者才对会话拥有完全访问权限。— 自 2017.0-5600 版本起可用。 |
| storage-root | 字符串 | server | '' | 文件存储根文件夹路径-指定用于控制台会话存储的文件夹的完整路径。如果 storage-root 为空或该文件夹不存在，则禁用文件存储。— 自 2017.0-5600 版本起可用。 |
session-management/defaults 参数
下表描述了/etc/dcv/dcv.conf文件[session-management/defaults]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的session-management/defaults注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| permissions-file | 字符串 | session | '' | 所有会话中包含的默认权限-指定要自动合并的权限文件的路径与用户为每个会话选择的权限合并。如果为空，请使用“default.perm”文件。对于 Linux，该文件位于 /etc/dcv/ 下，对于 Windows，该文件位于 DCV 安装文件夹中（如 C:\Program Files\NICE\DCV\Server\conf）。— 自 2017.0-5600 版本起可用。 |
smartcard 参数
下表描述了/etc/dcv/dcv.conf文件[smartcard]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的smartcard注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| enable-cache | 字符串 | 自定义 | “default-on” | 是否启用智能卡缓存消息-启用或禁用智能卡缓存。启用此项后，NICE DCV 服务器将缓存从客户端的智能卡收到的最后一个值。未来的调用直接从服务器的缓存中检索，而不是从客户端检索。这有助于减少在客户端和服务器之间传输的流量，并提高性能。允许的值包括“always-on”、“always-off”、“default-on”和“default-off”。每当启动客户端智能卡应用程序时，都会从配置中读取此值。— 自 2017.2-6182 版本起可用。 |
webcam 参数
下表描述了/etc/dcv/dcv.conf文件[webcam]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的webcam注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| 最大分辨率 | 字符串 | 连接 | (1280、720) | 最大网络摄像头分辨率-指定向应用程序公开的最大网络摄像头分辨率。— 自 2021.0-10242 版本起可用。 |
| 首选分辨率 | 字符串 | 连接 | (640, 480) | 首选网络摄像头分辨率-指定客户端提供的分辨率中的首选网络摄像头分辨率。如果不支持指定的分辨率，则选择最接近的匹配分辨率并将其提供给应用程序。如果指定的值之一为 0，则禁用摄像头共享。— 自 2021.0-10242 版本起可用。 |
windows 参数
下表描述了/etc/dcv/dcv.conf文件[windows]部分中用于 Linux NICE DCV 服务器的配置参数以及 Windows NICE DCV 服务器的windows注册表项。
| 参数 | 类型-Windows 注册表类型 | 重新加载上下文 | 默认值 | 描述 |
|---|---|---|---|---|
| disable-display-sleep | 对或错——DWORD（32 位） | session | Linux：是的—— Windows：1 | 防止显示器进入省电模式-指定是否阻止显示器进入省电模式。— 自 2017.0-4100 版本起可用。 |
| printer | 字符串 | session | 'DCV 打印机' | 要设置为默认打印机-指定虚拟 DCV 打印机的名称。该名称用于更改系统上的默认打印机。如果设置为空字符串，DCV 将不会更改当前的默认打印机。— 自 2017.0-4100 版本起可用。 |