NICE DCV 服务器参数参考 - NICE DCV
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

NICE DCV 服务器参数参考

下表列出了可配置用于自定义 NICE DCV 服务器的参数。

注意

每个表中的重新加载上下文列指示重新加载参数的时间。可能的上下文包括:

  • server在服务器启动时将加载一次该参数。如果更新参数值,则在重新启动服务器时将加载新值。

  • session在创建会话时将加载该参数。如果更新参数值,则将为后续会话加载新值。

  • connection在建立新的客户端连接时将加载该参数。如果更新参数值,则新值将用于后续客户端连接。

  • custom参数的加载对于此参数是唯一的。有关更多信息,请参阅参数说明。

audio 参数

下表描述了代码示例目录的配置参数[audio]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及audioWindows NICE DCV 服务器的注册表项。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
avsync-支持 字符串 session 'auto' 确定客户端是否可以启用音频/视频同步。— 允许连接的客户端启用音频/视频同步。有效值为 “已启用”、“已禁用” 或 “auto”(默认值='auto')。如果指定了 “auto”,则仅在控制台会话中启用音频/视频同步,并且只有在加速视频压缩可用时才会启用。—since版本2021.1-10557.
source-channels ince-32 位(32 位) session 2 在 Linux 上扬声器设备的声道数。— 设置 Linux 扬声器设备的声道数。该值必须小于或等于设备所支持的通道数。允许的值为:2(立体声)、4(4.0 四声道立体声)、6(5.1 环绕立体声)、6(5.1 环绕立体声)。默认值为 2(立体声) —since版本2020.0-84.

clipboard 参数

下表描述了代码示例目录的配置参数[clipboard]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及clipboardWindows NICE DCV 服务器的注册表项。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
enabled true or false — DWORD(32 位) session Linux的:trseWindows:1 是否应启用剪贴板功能— 指定是否启用剪贴板功能。如果禁用剪贴板功能,用户将无法使用剪贴板远程处理。剪贴板监控也将被禁用。—since版本2020.0-8428.
max-image-area ince-32 位(32 位) session –1 剪贴板图像的最大面积— 指定可从服务器传输到客户端的剪贴板图像的最大面积(像素数)。如果此值缺失或设置为 -1,则无限制。—since版本2017.0-4334.
max-payload-size ince-32 位(32 位) session 20971520 剪贴板数据的最大大小— 指定可从服务器传输到客户端的剪贴板数据的最大大小(以字节为单位)。如果缺少此值,则默认限制为 20 MB。—since版本2017.0-4334.
max-text-len ince-32 位(32 位) session –1 剪贴板文本的最大字符数— 指定可从服务器传输到客户端的剪贴板文本的最多字符数。如果此值缺失或设置为 -1,则无限制。—since版本2017.0-4334.
primary-selection-copy true or false — DWORD(32 位) session Linux的:seWindows:0 启用来自 linux 的主选副本— Linux 桌面支持多个剪贴板:通用剪贴板和主选区域。选择内容后,将更新或复制主选区域。然后,可以使用鼠标的中间按钮或 Shift+Insert 组合键粘贴它。启用此项后,将监控主选区域并将更新传播到客户端。—since版本2019.0-7318.
primary-selection-paste true or false — DWORD(32 位) session Linux的:seWindows:0 在 linux 上启用主选区粘贴— Linux 桌面支持多个剪贴板:通用剪贴板和主选区域。选择内容后,将更新或复制主选区域。然后,可以使用鼠标的中间按钮或 Shift+Insert 组合键粘贴它。启用此项后,还会将客户端的剪贴板内容插入主选区中。—since版本2019.0-7318.
更新超时 ince-32 位(32 位) session 200 更新事件通知超时— 指定从上次更新事件开始等待向客户端发送通知的时间(以毫秒为单位)。默认值 200 毫秒。—since版本2020.1-8942.

connectivity 参数

下表描述了代码示例目录的配置参数[connectivity]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及connectivityWindows NICE DCV 服务器的注册表键。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
enable-quic-frontend true or false — DWORD(32 位) server Linux的:seWindows:0 是否启用 QUIC 前端— 指定是否应启用 QUIC 前端。—since版本2020.2-9508.
idle-timeout ince-32 位(32 位) 自定义 60 空闲超时— 指定在断开空闲客户端之前等待的分钟数。指定 0 表示从不断开空闲客户端。每 5 秒读取此参数值一次。—since版本2017.0-4100.
idle-timeout-warning ince-32 位(32 位) 自定义 350 空闲超时警告— 指定在向空闲客户端发出空闲超时断开连接警告之前等待的相对于空闲超时的秒数。指定 0 表示从不向空闲客户端发出警告。—since版本2017.4-688.
quic-listen-endpoints 字符串 server ['0.0.0.0.0.0.0.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')。—since版本2022.0-11954.
快速端口 ince-32 位(32 位) server 8443 用于 QUIC 前端的 UDP 端口— 指定 DCV 服务器侦听客户端连接的 UDP 端口。端口号必须介于 1024 和 65535 之间。请参阅 'quic-listen-endpoints'设置,了解有关如何应用此设置的更多详细信息。—since版本2020.2-9508.
web-listen-endpoints 字符串 server ['0.0.0.0.0.0.0.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')。—since版本2022.0-11954.
web-port ince-32 位(32 位) server 8443 客户端的 TCP 端口— 指定 DCV 服务器侦听客户端连接的 TCP 端口。端口号必须介于 1024 和 65535 之间。请参阅 'web-listen-endpoints'设置,了解有关如何应用此设置的更多详细信息。—since版本2017.0-4100.
web-root 字符串 server '' 嵌入式 Web 服务器的文档根目录— 指定嵌入式 Web 服务器的文档根目录。—since版本2017.0-4100.
web-url-path 字符串 server '/' 嵌入式 Web 服务器的 URL 路径— 指定嵌入式 Web 服务器的 URL 路径,必须以 “/” 开头。例如,将其设置为 /test/foo 意味着在 https://host:port/test/foo 可访问该 Web 服务器。—since版本2017.0-4100.
web-use-hsts true or false — DWORD(32 位) server Linux的:trseWindows:1 是否使用 HSTS— 启用此项可强制浏览器阻止将通过 HTTP 发送的任何通信。相反,将使用 HTTPS 执行所有到网页(以及所有子域)的传输。—since版本2017.0-4100.
ws-keepalive-interval ince-32 位(32 位) server 10 Websocket 保活间隔— 指定发送 keepalive 消息的时间间隔(以秒为单位)。如果设置为 0,则禁用 keepalive 消息。—since版本2017.0-4100.

display 参数

下表描述了代码示例目录的配置参数[display]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及displayWindows NICE DCV 服务器的注册表键。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
console-session-default-layout 字符串 session [] 控制台会话的默认屏幕分辨率和位置— 指定控制台会话的默认屏幕分辨率和位置。如果设置了该项,则 DCV 在启动时设置请求的布局。可以为每个监视器配置分辨率 (w,h) 和位置 (x,y)。启用所有指定的监视器。默认布局示例值 <800><600><0><0><1024><768><800><0>:since版本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 开始的增量会话索引来选择要使用的下一个设备。—since版本2017.2-6182.
enable-client-resize true or false — DWORD(32 位) session Linux的:trseWindows:1 是否允许客户设置显示布局— 指定是否允许客户设置显示布局。—since版本2017.0-4100.
enable-qu true or ford(32 位) session Linux的:trseWindows:1 是否发送质量更新— 指定是否发送质量更新。—s版本2017.0-4100.
enable-yuv444 编码 字符串 session “default-off” 是否启用 YUV444 编码— 启用或禁用 YUV444 编码。如果 “始终在线”,则服务器将更喜欢为实现高色彩精度而优化的 YUV444 格式。如果 “始终关闭”,则服务器将首选针对流媒体性能进行了优化的格式。“default-on” 和 “default-off” 的语义相同,即让客户端决定。允许的值:always-on、always-off、default-on、default-off。—s版本2022.0-11954.
grabber-target-fps ince-32 位(32 位) session 0 帧抓取器的每秒目标帧数— 设置每秒抓取帧数的上限。值为 0 默认为每个特定帧缓冲区读取器的标准行为,例如回退到 target-fps 或不限制抓取。并非所有帧捕获后端都支持此设置。—s版本2017.1-570.
max-compressor-threads ince-32 位(32 位) session 4 最大压缩机线程— 指定最多压缩程序线程数。—s版本2017.0-4100.
max-head-resolution 字符串 自定义 (4096, 2160) 最大头部分辨率— 设置客户端可请求的显示头的最大分辨率。显示头等效于主显示器。在发出每个客户端布局请求时将重新加载该设置。当客户端请求较大的头分辨率时,服务器会调整分辨率,以确保它与此选项设置的最大宽度值和最大高度值匹配。—s版本2017.0-4100.
max-layout-area ince-32 位(32 位) 自定义 0 最大布局区域(以像素为单位)— 设置客户端可请求的显示布局的最大面积(以像素为单位)。超出此限制的布局将被忽略。此最大值旨在提供必须发送的显示数据量的上限,而不提供显示布局几何体的约束。如果设置为 0,则不对布局区域施加任何限制。在发出每个客户端布局请求时将重新加载该设置。—s版本2019.1-74.
max-num-heads ince-32 位(32 位) 自定义 4 最大磁头数— 指定客户端可请求的最大显示头的最大数量。显示头等效于主显示器。在发出每个客户端布局请求时将重新加载该设置。当客户端请求更多数量的头时,服务器会调整头数,以使该值不超过此选项设置的值。—s版本2017.0-4100.
min-head-resolution 字符串 自定义 (640, 480) Min Head 分— 设置客户端可请求的显示头的最小分辨率。显示头等效于主显示器。在发出每个客户端布局请求时将重新加载该设置。当客户端请求较小的头分辨率时,服务器会调整分辨率,以确保它与此选项设置的最小宽度值和最小高度值匹配。—s版本2017.0-4100.
target-fps ince-32 位(32 位) session –1 每秒目标帧数— 指定允许的每秒最多允许的帧数。值 0 表示无限制。值为 -1 表示将根据服务器特性和会话类型确定 target-fps 值。如果版本小于 2020.2,则无法识别 -1 值,默认值为 25。—s版本2017.0-4100.
use-grabber-dirty-region true or ford(32 位) session Linux的:trseWindows:1 是否使用脏区— 指定是否使用脏屏幕区域。如果启用,则抓取器试图从屏幕的脏区域中抓出新帧。—s版本2017.0-4100.
web-client-max-head-分se 字符串 自定义 (1920, 1080) Web 客户端的最大头部分辨率— 设置 Web 客户端可请求的显示头的最大分辨率。显示头等效于主显示器。在发出每个客户端布局请求时将重新加载该设置。如果 Web 客户端明确设置了最大分辨率,则忽略此设置。这些区域有: max-head-resolution 限制选项应用于此选项设置的最大宽度值和最大高度值。如果此值设置为 (0, 0),则忽略该选项。—s版本2020.0-84.

display/linux 参数

下表描述了代码示例目录的配置参数[display/linux]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及display/linuxWindows NICE DCV 服务器的注册表项。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
gl-displays 字符串 session [':0.0'] 3D 加速 X 显示屏— 指定 DCV 用于虚拟会话中 OpenGL 渲染的本地 3D 加速 X 显示器和屏幕的列表。如果缺少此值,则无法在虚拟会话中运行 OpenGL 应用程序。对于控制台会话,忽略此设置。—s版本2017.0-4100.
h264-encoder-displays 字符串 连接 [] H.264 编码器 X 显示屏— 指定支持加速 H.264 编码的本地 X 显示器和屏幕的列表。如果为空,则 DCV 使用为 OpenGL 渲染选定的同一显示器。仅当系统上安装的某些 GPU 不使用受支持的技术之一为 H.264 编码提供加速时,此设置很有用。—s版本2017.0-4100.

input 参数

下表描述了代码示例目录的配置参数[input]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及inputWindows NICE DCV 服务器的注册表项。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
enable-autorepeat true or ford(32 位) session Linux的:trseWindows:1 是否允许在 Linux 上自动重复— 指定是否允许自动重复单个键。—s版本2017.2-61.
enble-gampad true or false — DWORD(32 位) session Linux的:trseWindows:1 是否允许游戏手柄输入— 指定是否启用游戏手柄。—s版本2022.0-11954.
enable-relative-mouse true or false — DWORD(32 位) session Linux的:trseWindows:1 是否允许相对鼠标移动— 指定是否允许鼠标的相对移动。—s版本2017.0-51.
enable-stylus true or false — DWORD(32 位) session Linux的:trseWindows:1 是否允许手写笔输入— 指定是否启用触控笔。—s版本2019.0-741.
enable-touch true or false — DWORD(32 位) session Linux的:trseWindows:1 是否允许触摸输入— 指定是否启用触摸。—s版本2017.3-68.

license 参数

下表描述了代码示例目录的配置参数[license]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及licenseWindows NICE DCV 服务器的注册表项。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
license-file 字符串 session '' 许可证— 指定试用许可证文件或 RLM 服务器端口和主机名。如果在 RLM 服务器上使用的是浮动许可证,请使用此参数以 port@hostname 格式指定 RLM 服务器的端口和主机名。如果您使用的是延期试用许可证,并且没有在默认位置放置 license.lic 文件,请使用此参数指定 license.lic 许可证文件的完整路径。如果该默认文件不存在,则使用试用许可证。从配置中读取此值,并在每次创建新会话时更新。—s版本2017.0-4100.

log 参数

下表描述了代码示例目录的配置参数[log]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及logWindows NICE DCV 服务器的注册表项。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
directory 字符串 server '' 日志输出目录— 指定保存日志的目标位置。如果未指定,则默认为 “C:\ProgramData在 Linux 上)。—since版本2017.0-4100.
level 字符串 自定义 “info” 日志级别— 指定日志文件的详细程度级别。详细程度有(按提供的信息量顺序排列):“错误”、“警告”、“信息”和“调试”。新值在配置上进行更改并传播到 DCV 代理进程后立即生效。对于 2019.1 版本以及之前的版本,仅在 DCV 代理进程启动时设置其日志级别。—since版本2017.0-4100.
max-file-size ince-32 位(32 位) server 0 日志文件大小的最大值 MegaBytes 轮换— 指定触发轮换之前的最大日志文件大小。如果值为 '0',则禁用按大小旋转,而是在重新启动生成文件的进程时轮换文件。—since版本2022.1-13067.
rotate ince-32 位(32 位) server 10 日志文件轮换次数— 指定日志文件在被删除前分割的次数。如果值为 0,则删除而不分割旧版本。—since版本2017.0-4100.
轮换间隔 字符串 server “none” 连续两次日志文件轮换之间的最大时间间隔— 指定连续两次日志文件轮换之间的最大时间间隔。如果该值为 “none”,则文件不会根据时间旋转。其他可能的值包括 “每分钟”、“每小时” 和 “每天”。—since版本2022.1-13067.
轮换 字符串 server '计数器' 要附加到轮换日志文件中的后缀— 指定要附加到轮换日志文件的后缀。如果指定了 “counter”,则会在每个轮换的日志文件中附加一个简单的递增计数器后缀。如果指定了 “时间戳”,则会对日志文件应用形式为 “YYYY-MM-DD-HH-MM” 的时间戳。如果日志文件夹中已存在带有该时间戳的轮换文件,则会在时间戳后附加一个额外的数字计数器。—since版本2022.1-13067.
transfer-audit 字符串 server “none” 将方向移交给审计— 指定要审核的传输方向。如果启用此参数,则在服务器和客户端之间传输新的 CSV 文件日志。容许值为:“无”、“server-to-client','client-to-server'和' 全部 '。如果此值缺失或等于“none”,则禁用传输审核且不创建文件。—since版本2017.0-4100.

security 参数

下表描述了代码示例目录的配置参数[security]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及securityWindows NICE DCV 服务器的注册表项。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
allowed-http-host-regex 字符串 server '^.+$' 允许的主机正则表达式— 指定表示此 DCV 服务器可以服务的正则表达式模式。如果传入 HTTP 请求的主机标头与此模式不匹配,则请求本身会失败,并伴随出现“403(禁止访问)”的状态码。这是防止 HTTP 主机标头攻击的一种安全手段。该模式必须是有效的类似于 Javascript 的正则表达式。模式中的字母大小写同时匹配。例如:'^ (www\.)? 示例\ .com$'。—since版本2017.0-4100.
allowed-ws-origin-regex 字符串 server “^https://.+$” 允许的起源— 指定表示此 DCV 服务器接受的正则表达式模式。在建立 WebSocket connection,客户端的握手中的源标头字段指示建立连接的脚本的源。如果传入 HTTP 请求的源标头与此模式不匹配,则请求本身会失败,并伴随出现“403(禁止访问)”的状态码。这是防止跨站点的一种安全手段 WebSocket 劫持 (CSWSH) 攻击。该模式必须是有效的类似于 Javascript 的正则表达式。模式中的字母大小写同时匹配。源标头的形式如下:<scheme> "://" <host> [ ":" <port> ]。例如:'^ https://(www\.)? (^\.)? 示例\ .com (: 443)? $'。—since版本2017.0-4100.
auth-connection-setup-timeout ince-32 位(32 位) server 120 身份验证通道连接设置超时— 指定在超时之前允许完成身份验证通道连接设置过程所用的时间(以秒为单位)。如果设置过程超时,则通道被关闭。如果设置为 0,则禁用身份验证通道连接设置超时。—since版本2017.0-4100.
auth-token-verifier 字符串 server '' 身份验证令牌验证器的终端节点— 指定 DCV 服务器使用的身份验证程序的终端节点 (URL)。如果为空,则使用内部身份验证令牌验证程序。—since版本2017.0-4100.
authentication 字符串 server “system” 身份验证方法— 指定 DCV 服务器使用的客户端身份验证方法。使用“system”将客户端身份验证工作委派给底层操作系统。使用“none”以禁用客户端身份验证并授权访问所有客户端。—since版本2017.0-4100.
authentication-threshold ince-32 位(32 位) server 3 身份验证阈值— 指定在服务器关闭连接之前,每个客户端的身份验证可以失败的次数。要允许无限制的身份验证尝试,请使用 0。—since版本2017.0-4100.
ca-file 字符串 server '' CA 文件— 指定包含 DCV 服务器信任的证书颁发机构 (CA) 的文件。如果为空,请使用系统提供的默认信任存储。—since版本2017.0-4100.
certificate-to-user-file 字符串 自定义 '' 证书到用户映射文件— 指定包含证书到用户映射列表的文件。—since版本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 和客户端支持。—since版本2017.0-4100.
connection-estab-timeout ince-32 位(32 位) server 5 连接建立超时— 指定在超时之前允许完成连接过程所用的时间(以秒为单位)。如果连接过程超时,则连接被关闭。如果设置为 0,则建立连接无超时限制。—since版本2017.0-4100.
connection-setup-timeout ince-32 位(32 位) server 5 频道连接设置超时— 指定在超时之前允许完成通道连接设置过程所用的时间(以秒为单位)。如果设置过程超时,则通道被关闭。如果设置为 0,则通道连接设置无超时限制。—since版本2017.0-4100.
CRL false 字符串 自定义 '' CRL 文件— 指定包含证书吊销列表 (CRL)。—since版本2022.0-11954.
enable-gssapi true or false — DWORD(32 位) server Linux的:seWindows:0 启用 GSSAPI SASL 机制— 启用或禁用 GSSAPI SASL 机制,该机制允许使用 Kerberos 进行 DCV 身份验证。—since版本2017.3-68.
max-connections-per-user ince-32 位(32 位) server 10 用户的最大连接数— 指定每个用户所允许的并发连接的最多数量。超出的连接将被拒绝。—since版本2017.0-4100.
no-tls-strict true or false — DWORD(32 位) server Linux的:seWindows:0 启用或禁用严格的证书验证— 在连接到外部身份验证令牌验证程序时,启用或禁用严格的证书验证。如果身份验证令牌验证程序使用自签名证书,则必须禁用严格的证书验证。—since版本2017.0-4100.
os-auto-lock true or false — DWORD(32 位) session Linux的:trseWindows:1 是否在上次客户端连接结束时锁定操作系统会话— 如果启用此项,则在关闭最后一个客户端连接时,操作系统会话将被锁定。—since版本2017.1-577.
pam-service-name 字符串 server “dcv” PAM 服务名称— 指定 DCV 使用的 PAM 配置文件的名称。默认 PAM 服务名称为“dcv”,对应 /etc/pam.d/dcv 配置文件。仅当使用“system”身份验证方法时才使用此参数。—since版本2017.0-4100.
passwd-file 字符串 server '' 密码文件— 指定用于检查用户证书的密码文件(仅限于 dcv 身份验证模式)。如果为空,请对 Linux 使用 ${XDG_CONFIG_HOME}/NICE/dcv/passwd 中的默认文件,或对 Windows 使用 %CSIDL_LOCAL_APPDATA%\NICE\dcv\passwd 中的默认文件。—since版本2017.0-4100.
server-fqdn 字符串 server '' SQDN— 指定服务器完全限定域名。空白表示 gethostname()。—since版本2017.3-698.
service-name 字符串 server “dcv” 服务名称— 服务的注册名称(通常是协议名称)。—since版本2020.0-8428.
监督控制 字符串 自定义 '已禁用 ' 会话的监督控制类型— 指定会话的监督控制类型。可能的值为 “禁用” 和 “强制执行”。如果将此值设置为 “强制”,则可以将非监督访问权限设置为允许或拒绝协作会话中用户的无所有者访问。如果允许用户进行非监督访问,则该用户可以在没有所有者的情况下访问会话。默认情况下,除所有者之外的所有用户都被拒绝此权限。当此值设置为 “disabled”(默认)时,服务器不会强制执行此监督控制和权限。新值在配置上进行更改后立即生效。—since版本2021.3-11591.
user-realm 字符串 server '' 服务器用户领域— 指定服务器的用户领域。—since版本2017.3-698.

session-management 参数

下表描述了代码示例目录的配置参数[session-management]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及session-managementWindows NICE DCV 服务器的注册表项。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
create-session true or false — DWORD(32 位) server Linux的:seWindows:0 在服务器启动时创建控制台会话— 指定在服务器启动时是否自动创建控制台会话(使用 ID “控制台”)。—since版本2017.0-4100.
enable-gl-in-virtual-会话 字符串 session “default-on” 是否使用 dcv-gl 功能— 指定是否使用 dcvs 功能(需要许可证)。允许的值:always-on、always-off、default-on、default-off。—since版本2017.0-4100.
max-concurrent-clients ince-32 位(32 位) session –1 每个会话最多并发客户端的最大数量— 指定每个会话最多并发客户端的最大数量。如果设置为 -1,则表示无限制。要仅为自动会话设置限制,请使用max-concurrent-clients'会话管理/automatic-console-session'。—since版本2017.0-4100.
max-concurrent-sessions ince-32 位(32 位) server 0 并发会话数— 指定允许的最大并发会话数。此限制当前仅适用于虚拟会话,因为控制台会话本质上限于一个。指定 0 表示不强制施加任何限制。—since版本2019.0-7318.
max-sessions-per-user ince-32 位(32 位) server 0 每个用户的最大会话数— 指定每个用户可以拥有的允许的最大并发会话数。此限制当前仅适用于虚拟会话。指定 0 表示不强制施加任何限制。—since版本2021.0-10242.
virtual-session-default-layout 字符串 session [] 虚拟会话的默认布局— 如果设置此项,则将 Xdcv 配置为在启动时创建指定的布局。可以为每个监视器配置分辨率 (w,h) 和位置 (x,y)。启用所有指定的监视器。默认布局示例值 <800><600><0><0><1024><768>:[<800><0>{] virtual-session-monitors setting) 的优先级高于数组中的元素的数量。例如,如果设置了五台监视器,而最大监视器数为四,则只创建前四台监视器。如果设置此键,则表示已启用监视器数(在 virtual-session-monitors 设置)将被忽略。—since版本2017.0-5600.
virtual-session-font-path 字符串 session '' 是否添加特殊字体路径— 指定特殊字体的路径。有些应用程序要求将特殊字体传递到 X 服务器。—since版本2017.0-4100.
virtual-session-source-profile true or false — DWORD(32 位) session Linux的:seWindows:0 是否在会话启动器中获取用户配置文件— 指定运行会话启动器脚本的 shell 是否应提供用户配置文件。默认情况下这是假的,DCV 将使用 “bash —noprofile —norc” 运行会话启动器脚本 —since版本2021.3-11591.
virtual-session-xdcv-args 字符串 session '' 要传递给 Xdcv 的额外参数— 指定要传递到 Xdcv 的任何其他参数。—since版本2017.0-4334.

session-management/automatic-console-session 参数

下表描述了代码示例目录的配置参数[session-management/automatic-console-session]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及session-management/automatic-console-sessionWindows NICE DCV 服务器的注册表项。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
client-eviction-policy 字符串 server 'reject-new-connection' 指定在达到限制时如何处理客户端连接。— 指定在达到每个会话的最大并发客户端数时,是拒绝新连接还是自动关闭现有连接。允许的值包括”reject-new-connection'(传入的连接将被关闭)和'same-user-oldest-connection'(服务器将关闭与会话交互时间最长的同一个用户的连接,或者如果没有该信息,则关闭连接时间最早的同一个用户的连接)。—since版本2022.1-13067.
max-concurrent-clients ince-32 位(32 位) server –1 每个会话最多并发客户端的最大数量— 指定每个会话所允许的并发客户端的最大数量。如果设置为 -1,则表示无限制。—since版本2017.0-5600.
owner 字符串 server '' 自动创建的 “控制台” 会话的所有者— 指定 “控制台” 会话所有者的用户名。如果为空,则所有者为启动了 DCV 服务器的用户。此设置仅在 create-session 设置为“true”的情况下,适用于在服务器启动时自动创建的“控制台”会话。—since版本2017.0-5600.
permissions-file 字符串 server '' 自动 “控制台” 会话的权限文件— 指定用于检查用户的 DCV 功能访问权限文件的路径。如果为空,则只有所有者才对会话拥有完全访问权限。—since版本2017.0-5600.
storage-root 字符串 server '' 文件存储根文件夹的路径— 指定要用于控制台会话存储的文件夹的完整路径。如果 storage-root 为空或该文件夹不存在,则禁用文件存储。—since版本2017.0-5600.

session-management/defaults 参数

下表描述了代码示例目录的配置参数[session-management/defaults]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及session-management/defaultsWindows NICE DCV 服务器的注册表项。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
permissions-file 字符串 session '' 所有会话中都包含默认权限— 指定要与用户为每个会话选择的权限自动合并的权限文件的路径。如果为空,请使用“default.perm”文件。对于 Linux,该文件位于 /etc/dcv/ 下,对于 Windows,该文件位于 DCV 安装文件夹中(如 C:\Program Files\NICE\DCV\Server\conf)。—since版本2017.0-5600.

smartcard 参数

下表描述了代码示例目录的配置参数[smartcard]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及smartcardWindows NICE DCV 服务器的注册表项。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
enable-cache 字符串 自定义 “default-on” 是否启用智能卡缓存消息。— 启用或禁用智能卡缓存。启用此项后,NICE DCV 服务器将缓存从客户端的智能卡收到的最后一个值。未来的调用直接从服务器的缓存中检索,而不是从客户端检索。这有助于减少在客户端和服务器之间传输的流量,并提高性能。允许的值包括“always-on”、“always-off”、“default-on”和“default-off”。每当启动客户端智能卡应用程序时,都会从配置中读取此值。—since版本2017.2-6182.

webcam 参数

下表描述了代码示例目录的配置参数[webcam]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及webcamWindows NICE DCV 服务器的注册表项。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
max-repth 字符串 连接 (1280、720) 网络摄像头最大分辨率— 指定向应用程序公开的最大网络摄像机分辨率。—since版本2021.0-10242.
首选分辨率 字符串 连接 (640, 480) 首选的网络摄像头分辨率— 在客户端提供的分辨率中指定首选的网络摄像头分辨率。如果不支持指定的分辨率,则会选择最接近的匹配分辨率并向应用程序公开。如果指定的值之一为 0,则禁用网络摄像头共享。—since版本2021.0-10242.

windows 参数

下表描述了代码示例目录的配置参数[windows]的 部分/etc/dcv/dcv.confLinux NICE DCV 服务器的文件,以及windowsWindows NICE DCV 服务器的注册表键。

参数 类型-Windows 注册表类型 重新加载上下文 默认值 描述
disable-display-sleep true or false — DWORD(32 位) session Linux的:trseWindows:1 防止显示器进入省电模式— 指定是否防止显示器进入节能模式。—since版本2017.0-4100.
printer 字符串 session “DCV printer” 要设置为默认打印机— 指定虚拟 DCV 打印机的名称。该名称用于更改系统上的默认打印机。如果设置为空字符串,DCV 将不会更改当前的默认打印机。—since版本2017.0-4100.