步骤 4：创建连接文件（可选） - Amazon DCV
创建连接文件支持的参数运行连接文件

步骤 4：创建连接文件（可选）

通过使用 Windows、Linux 或 macOS 本机客户端，您可以创建可用于立即连接到 Amazon DCV 会话的连接文件。

创建连接文件

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


[group_name]
parameter_name=parameter_value

例如：


[options]
fullscreen=true

您可以直接从客户端中为特定 Amazon DCV 会话创建连接文件。或者，您也可以使用文本编辑器从头开始创建连接文件。

注意

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

从客户端中创建连接文件

  1. 打开 客户端。

  2. 连接到要在其中创建文件的服务器和会话。

  3. 在右上角选择 Amazon DCV 服务器的主机名，然后选择将连接另存为。

  4. 在另存为窗口中，输入文件名和目标文件夹，然后选择保存。

默认情况下，在您创建连接文件时，该文件包含 format、host、port、user 和 proxytype 参数。需要使用这些参数，才能连接到从中创建文件的会话。可以随时通过使用文本编辑器编辑文件来手动自定义或添加参数。

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

  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 String 托管会话的 Amazon DCV 服务器的主机名。
port 整数 8443 连接到 Amazon DCV 服务器时使用的端口。
weburlpath String Amazon DCV 服务器上用于连接的自定义路径。例如，如果指定 customPath，则客户端将尝试连接到 host:port/customPath。
sessionid String 要连接到的 Amazon DCV 会话的 ID。
authtoken String 要用于连接的身份验证令牌。如果您指定 authtoken，则还必须指定 sessionid。在使用 authtoken 时，可以省略 user 和 password 参数。
用户 String 在连接到 Amazon DCV 服务器时使用的用户名。
password String 在连接到 Amazon DCV 服务器时使用的密码。密码未进行加密。
proxytype String SYSTEM 要使用的代理类型。有效值包括 HTTPS、HTTP、SOCKS5|SOCKS、SYSTEM 或 NONE|DIRECT。如果指定 SYSTEM，则使用计算机的代理设置。
proxyhost String 在通过代理服务器进行连接时要使用的代理服务器的地址。
proxyport 整数 在通过代理服务器进行连接时要使用的端口。
proxyuser String 要用于代理身份验证的用户名。
proxypassword String 要用于代理身份验证的密码。密码未进行加密。
transport String auto

用于数据传输的协议。使用 auto 时，客户端首先尝试使用 QUIC（UDP）协议进行连接。如果 QUIC 连接失败，传输将自动回退到 websocket。

可以指定 websocket 以使用 WebSocket（TCP）协议进行数据传输，或指定 quic 以使用 QUIC（UDP）协议进行数据传输。如果启用 QUIC，则将 QUIC 协议用于数据传输，并将 WebSocket 用于身份验证流量。如果启用 WebSocket，则将 WebSocket 协议用于数据传输和身份验证流量。
webport 整数 8443 用于 WebSocket（TCP）流量的端口。
quicport 整数 8443 用于 QUIC（UDP）流量的端口。
certificatevalidationpolicy String ask-user 用于验证不受信任的证书的策略。值包括 strict、accept-untrusted 和 ask-user。

[options] 参数

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

参数 类型 默认值 描述
fullscreen 布尔值 false 指示客户端是否以全屏模式启动。
useallmonitors 布尔值 false 指示客户端在启动全屏模式时是否使用所有显示器。
promptreconnect 布尔值 true 指示您从会话断开连接后客户端是否提示您重新连接。如果该参数设置为 true，您在断开连接时将重定向到登录屏幕。如果此参数设置为 false，则在断开连接时客户端将关闭。
enableyuv444decoding 布尔值 false 指示在对动态视频内容进行编码时是否启用高色彩精度（YUV 4:4:4）。

运行连接文件

要运行 .dcv 连接文件，请导航到该文件，然后双击该文件。

或者，将文件路径指定为 dcvviewer 命令的参数。

  • Windows 客户端

    C:\> dcvviewer.exe path\connection_file_name.dcv

  • Linux 和 macOS 客户端

    $ dcvviewer path/connection_file_name.dcv