使用连接文件 - NICE DCV
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

使用连接文件

利用 Windows、Linux 和 macOS 本机客户端,您可以创建一个连接文件,可使用该文件立即连接到 NICE DCV 会话。

创建连接文件

连接文件是文件扩展名为 .dcv 的基于文本的文件。.dcv 文件的格式与 .ini 文件的格式类似,其中文件包含 [groups],后跟参数及其值。组和参数采用以下格式:

[group_name] parameter_name=parameter_value

例如:

[options] fullscreen=true

对于 Windows 客户端,您可以直接从客户端为特定 NICE DCV 会话创建连接文件,也可以使用文本编辑器从头开始创建连接文件。对于 Linux 和 macOS 客户端,您只能使用文本编辑器从头开始创建连接文件。

注意

对于 Windows、Linux 和 macOS 客户端,使用文本编辑器从头开始创建连接文件的过程是相同的。

从 Windows 客户端创建连接文件

  1. 打开 Windows 客户端并连接到要为其创建文件的服务器和会话。

  2. 在右上角选择 NICE DCV 服务器的主机名,然后选择将连接另存为

  3. 另存为窗口中,输入文件名和目标文件夹,然后选择保存

默认情况下,当您使用 Windows 客户端创建连接文件时,该文件包括 formathostportuserproxytype 参数。在连接到从中创建文件的会话时,需要使用这些参数。可以随时通过使用文本编辑器编辑文件来手动自定义或添加参数。

使用文本编辑器从头开始创建连接文件

  1. 使用以下文件名格式创建 .dcv 文件:file_name.dcv

  2. 使用首选文本编辑器打开 .dcv 文件。

  3. 添加[version]组中)format参数设置为文件顶部,格式如下:

    [version] format=1.0
    重要

    如果 .dcv 文件不包含 [version] 组和 format 参数,则解析将失败。

  4. 使用以下格式添加所需的参数组:

    [group_name]

    有关参数组的更多信息,请参阅支持的参数

  5. 使用以下格式在组的后面添加参数和参数值:

    parameter_name=parameter_value
    注意
    • 参数名称区分大小写。

    • 不要用引号将字符串参数值括起来。

    有关参数和参数值的更多信息,请参阅支持的参数

  6. 保存更改并关闭 .dcv 文件。

您也可以使用此过程随时向现有连接文件添加其他参数。

支持的参数

目前,.dcv文件支持三个参数组中的参数 —[version][connect], 和[options]。下表列出了各个组及其可用参数。

[version] 参数

重要

这是必需的组。如果 .dcv 文件不包含此组,则解析将失败。

下表列出了可在 [version] 组中指定的参数。

参数 类型 默认值 描述
format 字符串
重要

这是必需的参数。参数值必须为 1.0

如果 .dcv 文件不包含此参数,则解析将失败。

[connect] 参数

下表列出了可在 [connect] 组中指定的参数。

参数 类型 默认值 描述
host 字符串 托管会话的 NICE DCV 服务器的主机名。
port (远程调试端口) 整数 8443 连接到 NICE DCV 服务器时使用的端口。
weburlpath 字符串 要连接到的 NICE DCV 服务器上的自定义路径。例如,如果指定 customPath,则客户端将尝试连接到 host:port/customPath
sessionid 字符串 要连接到的 NICE DCV 会话的 ID。
authtoken 字符串 要用于连接的身份验证令牌。如果您指定 authtoken,则还必须指定 sessionid。在使用 authtoken 时,可以省略 userpassword 参数。
user 字符串 连接到 NICE DCV 服务器时使用的用户名。
密码 字符串 连接到 NICE DCV 服务器时使用的密码。密码是未加密的。
proxytype 字符串 SYSTEM 要使用的代理类型。有效值包括:HTTPSHTTPSOCKS5|SOCKSSYSTEMNONE|DIRECT。如果指定 SYSTEM,则使用计算机的代理设置。
proxyhost 字符串 在通过代理服务器进行连接时要使用的代理服务器的地址。
proxyport 整数 在通过代理服务器进行连接时要使用的端口。
proxyuser 字符串 要用于代理身份验证的用户名。
proxypassword 字符串 要用于代理身份验证的密码。密码是未加密的。
传输 字符串 websocket 用于数据传输的协议。指定websocket以使用 WebSocket (TCP) 协议进行数据传输,或者指定quic使用 QUIC (UDP) 协议进行数据传输。如果启用 QUIC,QUIC 协议将用于数据传输,WebSocket 用于身份验证流量。如果启用 WebSocket,则 WebSocket 协议将用于数据传输和身份验证流量。
網絡端口 整数 8443 用于 WebSocket (TCP) 通信的端口。
快速运动 整数 8443 用于 QUIC (UDP) 通信的端口。

[options] 参数

下表列出了可在 [options] 组中指定的参数。

参数 类型 默认值 描述
fullscreen Boolean false 指示客户端是否应在全屏模式下启动。
useallmonitors Boolean false 指示客户端是否应在启动全屏模式时使用所有显示器。
promptreconnect Boolean true 指示客户端是否应在会话连接断开后提示您重新连接。如果此参数设置为 true,则在断开连接时将重定向到登录屏幕。如果此参数设置为 false,则在断开连接时客户端将关闭。

执行连接文件

要执行 .dcv 连接文件,请导航到该文件并双击它。

或者,将文件路径指定为 dcvviewer 命令的参数。例如:

  • Windows 客户端

    C:\> dcvviewer.exe path\connection_file_name.dcv
  • Linux 和 macOS 客户端

    $ dcvviewer path/connection_file_name.dcv