WorkSpaces Linux 客户端应用程序 - Amazon WorkSpaces
要求设置和安装正在连接到你的 WorkSpace管理您的登录信息客户端视图客户端语言显示器支持代理服务器命令快捷方式剪贴板重定向Disconnect发行说明
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

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。

设置和安装

从 “亚马逊客户端下载” 中下载并安装 WorkSpaces Linux WorkSpaces 客户端。客户端下载网站的 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 客户端应用程序保存您当前的注册码，也可以为其指定一个名称 WorkSpace。您还可以指定是否希望 Amazon 在您退出或登录期 WorkSpaces 到期 WorkSpace 之前保持您的登录状态。

管理您的登录信息 WorkSpace

  1. 在 WorkSpaces 客户端应用程序中，前往 “设置”、“管理登录信息”。

  2. 在 “设置” 对话框中，您可以看到您的注册码和区域信息 WorkSpace。

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

  4. 在 “已保存的注册码” 下，选择 WorkSpace 要命名的注册码。

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

  6. （可选）如果您想在退出或登录期限 WorkSpaces 到期之前保持登录状态，请选中 “让我保持登录状态” 复选框。

  7. 选择保存。

管理您的登录信息 WorkSpace

  1. 在 WorkSpaces 客户端应用程序中，前往 “设置”、“管理登录信息”。

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

  3. （可选）如果您希望 WorkSpaces 客户端记住您当前的注册码，请选中 “记住注册码” 复选框。

  4. 在 “已保存的注册码” 下，选择 WorkSpace 要命名的注册码。

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

  6. （可选）如果您想在退出或登录期限 WorkSpaces 到期之前保持登录状态，请选中 “让我保持登录状态” 复选框。

  7. 选择保存。

客户端视图

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

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

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

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

客户端语言

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

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

注意

在客户端中，所有地区均提供日语。但是，在东京，日语仅适用于个人 WorkSpaces。

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

  1. 在 WorkSpaces 客户端应用程序中，前往 “设置”、“更改语言”。

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

  3. 重新启动客户端。

显示器支持

WorkSpaces 超值、标准、性能 PowerPro、功耗和 GraphicsPro 套装最多支持四台显示器，最大分辨率为 3840x2160（超高清或 UHD）。支持的最大分辨率取决于显示器的数量，如下表所示。

显示器 解决方案

2

3840x2160

4

1920x1200
注意

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

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

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

要将多台显示器配合使用 WorkSpaces

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

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

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

    注意

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

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

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

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

    • 选择 “跨所有显示器” 可在所有显示器上扩展全屏模式（对于 PCo IP 和 DCV）

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

现在，您 WorkSpace 应该在显示器上进行扩展。当您进入全屏模式 WorkSpaces 时，无论您指定为主显示屏的哪个显示屏也是主显示屏。

注意

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

代理服务器

如果您的网络要求您使用代理服务器来访问互联网，则可以允许您的 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 — 切换全屏显示（仅限 IP）PCo

剪贴板重定向

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

Disconnect

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

  • 在 theWorkSpaces 直播会话中，通过关闭窗口来结束 WorkSpace 会话。在对话框中，选择 “断开连接” 以结束会 WorkSpace 话。如果您想再次登录，客户端应用程序将继续运行。

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

  • 在亚马逊 WorkSpaces 客户端应用程序中，前往亚马逊 WorkSpaces，然后选择断开连接 WorkSpace。您的 WorkSpace 会话已结束，但如果您想再次登录，客户端应用程序将继续运行。

  • 在亚马逊 WorkSpaces 客户端应用程序中，前往亚马逊 WorkSpaces，然后选择退出亚马逊 WorkSpaces。您的 WorkSpace 会话结束，客户端应用程序关闭。

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

  • 在亚马逊 WorkSpaces 客户端应用程序中，前往亚马逊 WorkSpaces，然后选择断开连接 WorkSpace。您的 WorkSpace 会话已结束，但如果您想再次登录，客户端应用程序将继续运行。

  • 在亚马逊 WorkSpaces 客户端应用程序中，前往亚马逊 WorkSpaces，然后选择退出亚马逊 WorkSpaces。您的 WorkSpace 会话结束，客户端应用程序关闭。

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

诊断日志上传

要对 WorkSpaces 客户端的问题进行故障排除，请确保您的客户端已启用诊断日志记录。发送的日志文件 WorkSpaces 包含有关您的设备和 Amazon 网络连接的详细信息。您可以在 WorkSpace 流式传输会话之前或期间启用诊断日志上传，以便将这些文件 WorkSpaces 自动发送到。

注意

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

发送日志文件

  1. 打开您的亚马逊 WorkSpaces 客户端。

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

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

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

    重要

    向报告问题时 Amazon Web Services 支持，请务必跟踪遇到问题的客户端的设备 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 上的 TCP 和 UDP 协议添加了对通过端口 443 进行流式传输的支持。 WorkSpaces

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

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

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

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

  • 更新了 DCV SDK。

  • 更新了 PCo IP 开发工具包。

  • 增加了对通过 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 日

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

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

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

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

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

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

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

  • 添加了双向 audio/video 和网络摄像头重定向支持，以获得更好的会议体验。

  • 添加了显示直播指标的选项，包括帧速率、网络延迟和其内部的下载带宽 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 上的 TCP 和 UDP 协议添加了对通过端口 443 进行流式传输的支持。 WorkSpaces

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

  • 更新了 PCo IP 开发工具包。

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

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

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

  • 更新了 DCV SDK。

  • 更新了 PCo IP 开发工具包。

  • 增加了对通过 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。

  • 更新了 PCo IP 开发工具包。

  • 修复了键盘捕获问题

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

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

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

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

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

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

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

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

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

  • 更新了 Linux 版 PCo IP 开发工具包。
2023.0.4430 2023 年 8 月 24 日

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

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

  • （仅限 DCV）添加了双向 audio/video 和网络摄像头重定向支持，以获得更好的会议体验。

  • （仅限 DCV）添加了显示流媒体指标的选项，包括帧速率、网络延迟和其 WorkSpaces内部的下载带宽。

注意

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

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

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

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

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

  • 更新了 WorkSpaces Linux 客户端 PCo的 IP 开发工具包。
4.4.0 2022 年 10 月 27 日

Ubuntu 20.04 支持。