View a markdown version of this page

WorkSpaces Linux 客户端应用程序 - 亚马逊 WorkSpaces

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

WorkSpaces Linux 客户端应用程序

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

要求

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

注意
  • 默认情况下,Linux 客户端访问处于禁用状态。要将此客户端与您的一起使用 WorkSpace,您的亚马逊 WorkSpaces 管理员必须为您的 WorkSpaces 目录启用 Linux 客户端访问权限。有关更多信息,请参阅《亚马逊 WorkSpaces 管理指南》中的 “控制设备访问权限” 。

  • 如果您 WorkSpace 位于亚太地区(孟买)地区,则必须使用亚马逊 WorkSpaces Linux 客户端应用程序 3.1.3 或更高版本。

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

设置和安装

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

要从命令行启动 Linux 客户端,请使用:

/usr/bin/workspacesclient

要启用高级日志记录,请使用:

/usr/bin/workspacesclient --l3

注意

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

要从命令行启动 Linux 客户端,请使用:

/opt/workspacesclient/workspacesclient

要启用高级日志记录,请使用:

/opt/workspacesclient/workspacesclient -l3

连接到您的 WorkSpace

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

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

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

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

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

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

管理您的登录信息

您可以查看您的注册码以及您 WorkSpace 所在的地区。您可以指定是否希望 WorkSpaces 客户端应用程序保存当前的注册码,也可以为您的指定一个名称 WorkSpace。您还可以指定是否希望亚马逊在您退出或登录期 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 WorkSpaces 超值、标准、性能 PowerPro、电源和 GPU-enabled 套装最多支持四台显示器,最大分辨率为 3840x2160(超高清晰度或 UHD)。支持的最大分辨率取决于显示器的数量,如下表所示。

显示器 解决方案

2

3840x2160

4

1920x1200

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

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

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

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

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

    注意

    如果您使用带有 DCV 的 2023.x 客户端版本 WorkSpaces,并且连接了三台或更多显示器,则还 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 来切换全屏模式。

现在,您的显示器 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 — 切换全屏显示(仅限 PCoIP)

剪贴板重定向

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

Disconnect

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

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

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

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

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

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

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

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

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

诊断日志上传

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

注意

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

发送日志文件
  1. 打开您的亚马逊 WorkSpaces 客户端。

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

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

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

    重要

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

发行说明

下表描述了对每个版本的 Ubuntu 24.04 客户端应用程序的更改。

发布版本 日期 更改
2026.0 2026 年 6 月 10 日
  • 添加了对在瘦客户机设备上进行配置后,默认情况下在所有连接的显示器上以全屏模式打开客户端的支持。

  • 通过提供清晰的状态消息,改善了断开连接的体验。

  • 修复了导致智能卡身份验证无法在流式传输会话中正常运行的问题。

  • 修复了在会话中连接设备时摄像头无法出现在菜单中的问题。

  • 修复了断开会话连接时导致应用程序在特定条件下挂起的问题。

  • 修复了一些导致应用程序在特定条件下崩溃的问题。

  • 更新了 DCV SDK。

  • 其他错误修复和增强。

2025.1 2025 年 12 月 12 日
  • 增加了对在 Ubuntu 24.04 设备上安装客户端的支持。

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

发布版本 日期 更改
2026.0 2026 年 6 月 10 日
  • 添加了对在瘦客户机设备上进行配置后,默认情况下在所有连接的显示器上以全屏模式打开客户端的支持。

  • 通过提供清晰的状态消息,改善了断开连接的体验。

  • 修复了导致智能卡身份验证无法在流式传输会话中正常运行的问题。

  • 修复了在会话中连接设备时摄像头无法出现在菜单中的问题。

  • 修复了断开会话连接时导致应用程序在特定条件下挂起的问题。

  • 修复了一些导致应用程序在特定条件下崩溃的问题。

  • 更新了 DCV SDK。

  • 其他错误修复和增强。

2025.1 2025 年 12 月 12 日
  • 增加了对 WorkSpaces 通过 IPv6 网络连接的支持;从 “连接设置” 菜单管理您的首选项。

  • 修复了用户名中出现特殊字符时统一资源标识符 (URI) 功能的问题。

  • 修复了在 OEM 瘦客户机中运行的客户端的 SAML 2.0 身份验证流程存在的问题。

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。

  • 更新了 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 (US-West) 和 AWS GovCloud (US-East) 的支持。

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.1 2025 年 12 月 12 日

错误修复和增强功能。

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

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

  • 更新了 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 (US-West) 和 AWS GovCloud (US-East) 的支持。

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)增加了双向 audio/video 和网络摄像头重定向支持,以提供更好的会议体验。

  • (仅限 DCV)添加了显示流媒体指标的选项,包括帧速率、网络延迟和其 WorkSpaces中的下载带宽。

注意

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

4.6.0 2023 年 6 月 21 日
  • 通过将资产存储在与配置相同的 AWS 区域中,改进了 WorkSpaces客户自定义品牌。

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

  • 修复了日语键盘映射问题。

4.5.0 2022 年 12 月 27 日
  • 解决了用户在网络连接丢失或不可用 WorkSpaces 时无法断开连接的问题。

  • 更新了适用于 WorkSpaces Linux 客户端的 PCoIP SDK。

4.4.0 2022 年 10 月 27 日

Ubuntu 20.04 支持。