WorkSpaces Linux 客户端应用程序 - Amazon WorkSpaces
要求设置和安装连接到您的 WorkSpace管理您的登录信息客户端视图客户端语言显示器支持代理服务器命令快捷方式剪贴板重定向Disconnect发行说明

WorkSpaces Linux 客户端应用程序

以下信息将帮助您开始使用 WorkSpaces Linux 客户端应用程序。

要求

要使 WorkSpaces Linux 客户端版本 2023.x 能够访问 WorkSpaces 服务，您必须将 WorkSpaces Web Access 域 (https://webclient.amazonworkspaces.com/) 添加到客户端尝试访问该服务的网络上的允许列表中。

注意

  • 默认情况下，Linux 客户端访问处于禁用状态。若要将此客户端与 WorkSpace 一起使用，您的 Amazon WorkSpaces 管理员必须针对 WorkSpaces 目录启用 Linux 客户端访问。有关更多信息，请参阅《Amazon WorkSpaces 管理指南》中的控制设备访问。

  • 如果您的 WorkSpace 位于亚太地区（孟买），则必须使用3.1.3 或更高版本的 Amazon WorkSpaces Linux 客户端应用程序。

  • 适用于 Ubuntu 22.04 的 WorkSpaces Linux 客户端版本 2023.0.4395 仅适用于 DCV。

设置和安装

从 Amazon WorkSpaces 客户端下载中下载并安装 WorkSpaces Linux 客户端应用程序。客户端下载网站的 Linux 客户端页面上提供了详细的安装说明。

要从命令行启动 Linux 客户端，请使用：

workspacesclient

注意

运行新的客户端应用程序时，系统将提示您输入注册代码，该代码可在欢迎电子邮件中找到。对于现有客户，您可以在 /home/UserName/.local/share/Amazon Web Services/Amazon WorkSpaces/RegisterationList.json 下找到注册代码。

要从命令行启动 Linux 客户端，请使用：

/opt/workspacesclient/workspacesclient

连接到您的 WorkSpace

要连接到您的 WorkSpace，请完成以下步骤。

要连接到您的 WorkSpace

  1. 首次运行客户端应用程序时，系统会提示您输入您的欢迎电子邮件中所包含的注册代码。WorkSpaces 客户端应用程序使用注册代码和用户名来确定要连接的 WorkSpace。以后当您启动客户端应用程序时，将会使用相同的注册代码。要输入不同的注册码，请启动客户端应用程序，然后选择登录页面底部的更改注册码。

  2. 输入您的登录凭证，然后选择登录。如果 WorkSpaces 管理员为贵组织的 WorkSpaces 启用了多重身份验证，系统会提示您输入密码才能完成登录。您的 WorkSpaces 管理员会提供更多有关如何获取密码的信息。

  3. 如果您的 WorkSpaces 管理员尚未禁用保持登录状态功能，您可以选中登录屏幕底部的保持登录状态复选框以安全地保存您的凭证，以便可以轻松连接您的 WorkSpace，同时仍确保客户端应用程序始终运行。您的凭据安全地缓存到 Kerberos 票证中，时间可达其最长使用期限。

    在客户端应用程序连接到您的 WorkSpace 之后，您的 WorkSpace 桌面将会显示。

网络连接中断会导致活动会话断开连接。这可能会因如下事件导致：合上笔记本电脑的盖子，或无线网连接丢失。如果网络连接在一段时间内恢复，适用于 Linux 的 WorkSpaces 客户端应用程序将尝试自动重新连接会话。默认会话恢复超时时间为 20 分钟，但您的网络管理员可以修改此超时时间。

管理您的登录信息

您可以查看您的注册代码以及您的 WorkSpace 所在的区域。您可以指定是否希望 WorkSpaces 客户端应用程序保存当前注册代码，并可以为您的 WorkSpaces 分配一个名称。您还可以指定是否希望 Amazon WorkSpaces 保持您登录到 WorkSpace，直到您退出或登录期到期为止。

管理 WorkSpace 的登录信息

  1. 在 WorkSpaces 客户端应用程序中，依次转到设置和管理登录信息。

  2. 在管理登录信息对话框中，可以看到您的 WorkSpace 的注册代码和区域信息。

  3. （可选）如果您希望 WorkSpaces 客户端记住您当前的注册代码，请启用保存注册代码。

  4. 在 Saved registration codes (已保存的注册代码) 下，选择要命名的 WorkSpace。

  5. 在 WorkSpace 名称框中，输入 WorkSpace 的名称。

  6. （可选）如果您希望 WorkSpaces 保持登录状态，直到您退出或登录期过期，请选中 Keep me logged in (保持登录状态) 复选框。

  7. 选择 Save。

管理 WorkSpace 的登录信息

  1. 在 WorkSpaces 客户端应用程序中，依次转到设置和管理登录信息。

  2. 在 Manage Login Information (管理登录信息) 对话框中，您可以看到 WorkSpace 的注册代码和区域信息。

  3. （可选）如果您希望 WorkSpaces 客户端记住您当前的注册代码，请选中 Remember Registration Code (记住注册代码) 复选框。

  4. 在 Saved registration codes (已保存的注册代码) 下，选择要命名的 WorkSpace。

  5. 在 WorkSpace 名称框中，输入 WorkSpace 的名称。

  6. （可选）如果您希望 WorkSpaces 保持登录状态，直到您退出或登录期过期，请选中 Keep me logged in (保持登录状态) 复选框。

  7. 选择 Save。

客户端视图

您可以通过在客户端应用程序菜单中选择全屏图标，切换到全屏模式。在全屏模式下，您可以通过将指针移动到屏幕顶部来切换回窗口模式。将显示客户端应用程序菜单，然后您可以选择客户端应用程序菜单中的退出全屏模式。

您可以通过在客户端应用程序菜单中选择 View (查看)、Enter Full Screen (进入全屏) 切换到全屏模式。

在全屏模式下，您可以通过将指针移动到屏幕顶部来切换回窗口模式。客户端应用程序菜单会显示，然后您可以选择客户端应用程序菜单中的 View (查看)、Leave Full Screen (离开全屏)。

您也可以通过按 Ctrl+Alt+Enter 来切换全屏模式。

客户端语言

WorkSpaces 客户端会自动选择您的计算机上操作系统使用的默认显示语言。

您可以通过执行以下步骤来选择客户端显示的语言。

注意

在客户端中，所有地区均提供日语。然而在个人的 WorkSpace 中，只有东京才提供日语。

要选择客户端语言，请执行以下操作：

  1. 在 WorkSpaces 客户端应用程序中，依次转到设置和更改语言。

  2. 在 Select a language (选择语言) 列表中输入所需的语言，然后选择 Save (保存)。

  3. 重新启动客户端。

显示器支持

WorkSpaces Value、Standard、Performance、Power、PowerPro 和 GraphicsPro 捆绑包支持最多四个显示器，且最大分辨率为 3840x2160（超高清或 UHD）。支持的最大分辨率取决于显示器的数量，如下表所示。

显示器 解决方案

2

3840x2160

4

1920x1200
注意

  • 您只能扩展显示器。您无法复制显示器。复制显示器将导致您的会话中断。

  • Graphics 捆绑包仅支持单个显示器配置，且最大分辨率为 2560x1600。

WorkSpaces 客户端应用程序在启动会话之前，会提取所有已连接显示器的扩展显示器信息数据 (EDID)，并确定最兼容的匹配项。如果您有一个高像素密度（高 DPI）显示器，客户端应用程序会根据您的本地 DPI 设置，自动扩展播放窗口。要使用高 DPI 显示器获取更好的最大分辨率，请参阅为 WorkSpaces 启用高 DPI 显示器。

将多个监视器用于 WorkSpaces

  1. 配置本地计算机以便使用多个显示器。

  2. 启动 WorkSpaces 客户端应用程序并登录到您的工作区。

  3. 根据您使用的客户端，执行以下操作之一。

    注意

    如果您在 DCV WorkSpaces 中使用的客户端版本为 2023.x，并且连接了三台或更多显示器，则您的 WorkSpace 还可以在选定的可用显示器上扩展全屏模式。在您的显示设置中，所选显示器必须设置为相邻显示器或彼此共享一侧。DCV 多显示器支持是使用 DCV 技术构建的。有关要求和故障排除的更多信息，请参阅在选定显示器上扩展全屏模式。

    如果您使用的是…… 请执行该操作
    2023.x+ 客户端

    • 选择在单台显示器上可在单个显示器上进入全屏模式（仅限 DCV）

    • 选择在选定显示器上可在选定显示器上进入全屏模式（仅限 DCV）

    • 选择在所有显示器上可在所有显示器上扩展全屏模式（适用于 PCoIP 和 DCV）

    • 您也可以通过按 Ctrl+Alt+Enter 来切换全屏模式（仅限 PCoIP）。
    3.0+ 和 4.0+ 客户端 依次选择 View (视图) 和 Enter Full Screen On All Displays (在所有显示器上进入全屏模式)。您也可以通过按 Ctrl+Alt+Enter 来切换全屏模式。
    2.0+ 客户端 依次选择 View (视图) 和 Show Fullscreen (全屏显示)。您也可以通过按 Ctrl+Alt+Enter 来切换全屏模式。

现在，您的工作区应该扩展到所有显示器上。当您进入全屏模式时，您指定为主显示器的任何显示器同时也是 WorkSpaces 中的主显示器。

注意

在多显示器设置中，无法仅对部分显示器使用全屏模式。但是，您可以按 Alt+F10 或双击标题栏，在某个显示器上最大化 WorkSpaces 客户端窗口，而不会将工作区扩展到其他显示器上。

代理服务器

如果您的网络要求您使用代理服务器访问 Internet，您可以启用 WorkSpaces 客户端应用程序来使用代理访问 HTTPS（端口 443）流量。WorkSpaces 客户端应用程序使用 HTTPS 端口进行更新、注册和身份验证。

注意

  • 与 WorkSpace 的桌面流式传输连接需要启用端口 4172 和 4195，而且不能通过代理服务器。

  • 不支持需要使用登录凭证进行身份验证的代理服务器。

使用代理服务器

默认情况下，Linux 客户端使用设备操作系统设置中指定的代理服务器。首次启动客户端时，将使用设备操作系统的代理服务器设置。如果您为代理服务器选择其他选项，则该设置将用于客户端的后续启动。

注意

在 3.0.0 到 3.1.4 版本中，如果您指定自定义代理服务器，则在尝试登录 WorkSpace 时可能会出现“无网络”错误。如果您想在 Linux 客户端上使用自定义代理服务器，建议升级到 3.1.5 版。如果您无法升级，则可以使用默认的操作系统代理服务器来解决此问题，而不是在 Linux 客户端中指定自定义代理服务器。

使用代理服务器

  1. 在 WorkSpaces 客户端应用程序中，从登录页面选择三行菜单图标连接设置。

  2. 在连接设置对话框中，选择为 WorkSpaces 自定义代理服务器，输入代理服务器 URL 或 IP 地址，输入端口，然后选择保存。

使用代理服务器

  1. 在 WorkSpaces 客户端应用程序中，依次转到设置和管理代理服务器。

  2. 在设置代理对话框中，选择使用代理服务器，输入代理服务器 URL 或 IP 地址及端口，然后选择保存。

命令快捷方式

PCoIP WorkSpaces Linux 客户端支持以下命令快捷方式：

  • Ctrl+Alt+Enter — 切换全屏显示（仅限 PCoIP）

剪贴板重定向

剪贴板支持的最大未压缩对象大小为 20 MB。有关更多信息，请参阅我在复制和粘贴时遇到问题。

Disconnect

您可以通过几种方法断开 Linux 客户端应用程序的连接：

  • 在 WorkSpaces 流式传输会话中，通过关闭相应窗口可结束 WorkSpace 会话。在此对话框中，选择断开连接可结束 WorkSpace 会话。如果您想再次登录，客户端应用程序将继续运行。

  • 在 WorkSpaces 流式传输会话中，单击三行菜单图标并选择断开连接，可结束 WorkSpace 会话。客户端应用程序将继续运行，允许您再次登录。

  • 在 Amazon WorkSpaces 客户端应用程序中，转到 Amazon WorkSpaces，然后选择断开 WorkSpace 连接。工作区会话结束，但客户端应用程序将继续运行，以方便您的再次登录。

  • 在 Amazon WorkSpaces 客户端应用程序中，转到 Amazon WorkSpaces，然后选择退出 Amazon WorkSpaces。工作区会话结束，客户端应用程序关闭。

  • 在 Amazon WorkSpaces 客户端应用程序中，单击右上角的关闭 (X) 按钮来关闭 WorkSpaces 客户端窗口。

  • 在 Amazon WorkSpaces 客户端应用程序中，转到 Amazon WorkSpaces，然后选择断开 WorkSpace 连接。工作区会话结束，但客户端应用程序将继续运行，以方便您的再次登录。

  • 在 Amazon WorkSpaces 客户端应用程序中，转到 Amazon WorkSpaces，然后选择退出 Amazon WorkSpaces。工作区会话结束，客户端应用程序关闭。

  • 在 Amazon WorkSpaces 客户端应用程序中，单击右上角的关闭 (X) 按钮来关闭 WorkSpaces 客户端窗口。在提示中选择结束会话，这将断开您与 Amazon WorkSpaces 的连接并关闭客户端应用程序。

诊断日志上传

要排查 WorkSpaces 客户端问题，请确保为客户端启用了诊断日志记录功能。发送到 WorkSpaces 的日志文件包含有关您的设备以及与 AWS 网络的连接的详细信息。您可以在 WorkSpace 流式传输会话之前或期间启用诊断日志上传功能，以便将这些文件自动发送到 WorkSpaces。

注意

您可以在 WorkSpaces 流式传输会话之前和期间发送日志文件。仅在 Linux Ubuntu 20.04 和 Ubuntu 22.04 客户端上支持日志上传。

发送日志文件

  1. 打开您的 Amazon WorkSpaces 客户端。

  2. 注册后，在 WorkSpaces 登录页面的右上角，选择设置，然后选择诊断日志记录。

  3. 在弹出的对话框中，将诊断日志记录下的切换开关设置为所需的首选项，然后选择保存。

  4. 通过选择日志级别下的单选按钮，可以选择要在会话日志中提供的数据量。您可以选择标准日志记录（默认）或高级日志记录。

    重要

    向 支持 报告问题时，请务必跟踪遇到问题的客户端的设备 ID。输入注册码后，可以在客户端登录页面的设置诊断日志记录菜单中找到设备 ID。这可以帮助支持团队识别与您的特定设备相关的日志。请务必在针对特定问题创建的工单中包含设备 ID。

发行说明

下表介绍了对每个版本的 Ubuntu 22.04 客户端应用程序所进行的更改。

版本 日期 更改
2025.0 2025 年 5 月 28 日

  • 更新了 DCV SDK。

  • 错误修复和增强功能。
2024.8 2024 年 12 月 11 日

  • 添加了在 DCV WorkSpaces 会话之间保存的永久摄像头和麦克风设置。

  • 错误修复和增强功能。
2024.7 2024 年 10 月 10 日

  • 将 WSP 协议重命名为 Amazon DCV 协议。

  • 增加了对在 DCV WorkSpaces 上使用 TCP 和 UDP 协议通过端口 443 进行流式传输的支持。

  • 增加了对基于证书的身份验证的支持，即使用更少的用户提示启用单点登录体验。

  • 错误修复和增强功能。
2024.5 2024 年 8 月 26 日

错误修复和增强功能。
2024.4 2024 年 8 月 15 日

错误修复和增强功能。
2024.3 2024 年 8 月 8 日

  • 更新了 DCV SDK。

  • 更新了 PCoIP SDK。

  • 增加了对通过 TCP/UDP 端口 443 进行流式传输的支持。
2024.2 2024 年 7 月 3 日

错误修复和增强功能。
2024.1 2024 年 6 月 11 日

  • 更新了 DCV SDK。

  • 增加了 SAML 2.0 集成支持。

  • 增加了会话前智能卡身份验证支持。
2024.0 2024 年 2 月 28 日

  • 更新了 DCV SDK。

  • 修复了键盘捕获问题

  • 增加了对会话中身份验证的 WebAuthn 支持

  • 次要错误修复和增强功能。
2023.2 2023 年 12 月 19 日

  • 增加了屏幕阅读器和键盘导航，改善了可访问性。

  • 增加了对 AWS GovCloud（美国西部）和 AWS GovCloud（美国东部）的支持。
2023.1 2023 年 11 月 12 日

  • 增加了统一资源标识符（URI）支持。

  • 修复了有关波浪号键的日语键盘映射问题。

  • 增加了诊断日志上传支持。
2023.0.4395 2023 年 8 月 24 日

  • 增加了 DCV WorkSpaces 连接支持，包括 Windows、BYOL 和 Ubuntu WorkSpaces。

  • 如果连接的显示器超过 2 个，则在部分显示器上增加了全屏模式扩展支持。

  • 添加了双向音频/视频和网络摄像头重定向支持，以提供更好的会议体验。

  • 增加了显示直播指标的选项，包括帧速率、网络延迟和 WorkSpaces 内的下载带宽。

注意

此版本不支持统一资源标识符（URI）。有关更多信息，请参阅自定义用户登录其 WorkSpaces 的方式

下表介绍了对每个版本的 Ubuntu 20.04 客户端应用程序所进行的更改。

版本 日期 更改
2025.0 2025 年 5 月 28 日

  • 更新了 DCV SDK。

  • 错误修复和增强功能。
2024.8 2024 年 12 月 11 日

  • 添加了在 DCV WorkSpaces 会话之间保存的永久摄像头和麦克风设置。

  • 错误修复和增强功能。
2024.7 2024 年 10 月 10 日

  • 将 WSP 协议重命名为 Amazon DCV 协议。

  • 增加了对在 DCV WorkSpaces 上使用 TCP 和 UDP 协议通过端口 443 进行流式传输的支持。

  • 增加了对基于证书的身份验证的支持，即使用更少的用户提示启用单点登录体验。

  • 更新了 PCoIP SDK。

  • 错误修复和增强功能。
2024.6 2024 年 9 月 5 日 错误修复和增强功能。
2024.5 2024 年 8 月 26 日

错误修复和增强功能。
2024.4 2024 年 8 月 15 日

错误修复和增强功能。
2024.3 2024 年 8 月 8 日

  • 更新了 DCV SDK。

  • 更新了 PCoIP SDK。

  • 增加了对通过 TCP/UDP 端口 443 进行流式传输的支持。
2024.2 2024 年 7 月 3 日

错误修复和增强功能。
2024.1 2024 年 6 月 11 日

  • 更新了 DCV SDK。

  • 增加了 SAML 2.0 集成支持。
2024.0 2024 年 2 月 28 日

  • 更新了 DCV SDK。

  • 更新了 PCoIP SDK。

  • 修复了键盘捕获问题

  • 增加了对会话中身份验证的 WebAuthn 支持

  • 次要错误修复和增强功能。
2023.2 2023 年 12 月 19 日

  • 增加了屏幕阅读器和键盘导航，改善了可访问性。

  • 增加了对 AWS GovCloud（美国西部）和 AWS GovCloud（美国东部）的支持。
2023.1 2023 年 11 月 12 日

  • 增加了统一资源标识符（URI）支持。

  • 修复了有关波浪号键的日语键盘映射问题。

  • 增加了诊断日志上传支持
4.7.0 2023 年 11 月 1 日

  • 增加了对以色列（特拉维夫）区域的支持。

  • 修复了有关波浪号键的日语键盘映射问题。

  • 更新了适用于 Linux 的 PCoIP SDK。
2023.0.4430 2023 年 8 月 24 日

  • 增加了 DCV WorkSpaces 连接支持，包括 Windows、BYOL 和 Ubuntu WorkSpaces。

  • （仅限 DCV）在部分显示器上添加了全屏模式扩展支持（前提是连接的显示器超过 2 个）。

  • （仅限 DCV）增加了双向音频/视频和网络摄像头重定向支持，以提供更好的会议体验。

  • （仅限 DCV）增加了显示直播指标的选项，包括帧速率、网络延迟和 WorkSpaces 内的下载带宽。

注意

此版本不支持统一资源标识符（URI）。有关更多信息，请参阅自定义用户登录其 WorkSpaces 的方式
4.6.0 2023 年 6 月 21 日

  • 通过将资产存储在与配置的 WorkSpaces 相同的 AWS 区域，改进了客户自定义品牌。

  • 解决了客户端自定义品牌徽标文件中的图像自动缩放问题。

  • 修复了日语键盘映射问题。
4.5.0 2022 年 12 月 27 日

  • 解决了用户在网络连接中断或不可用时无法与 WorkSpaces 断开连接的问题。

  • 更新了适用于 WorkSpaces Linux 客户端的 PCoIP SDK。
4.4.0 2022 年 10 月 27 日

Ubuntu 20.04 支持。