View a markdown version of this page

WorkSpaces Linux 客户端应用程序 - 亚马逊 WorkSpaces
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

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 包含有关您的设备和 Amazon 网络连接的详细信息。您可以在 WorkSpace 流式传输会话之前或期间启用诊断日志上传,以便 WorkSpaces 自动将这些文件发送到。

注意

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

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

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

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

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

    重要

    当您向报告问题时 Amazon Web Services 支持,请务必跟踪遇到问题的客户端的设备 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 日
  • 增加了屏幕阅读器和键盘导航,改善了可访问性。

  • 添加了对 Amazon GovCloud (US-West) 和 Amazon 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 日
  • 增加了屏幕阅读器和键盘导航,改善了可访问性。

  • 添加了对 Amazon GovCloud (US-West) 和 Amazon 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 日
  • 通过将资产存储在与配置相同的 Amazon 区域中,改进了 WorkSpaces客户自定义品牌。

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

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

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

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

4.4.0 2022 年 10 月 27 日

Ubuntu 20.04 支持。