WorkSpaces macOS 客户端应用程序
以下信息将帮助您开始使用 WorkSpaces macOS 客户端应用程序。
目录
要求
适用于 macOS 的 Amazon WorkSpaces 客户端需要 Apple 支持的 macOS 版本。如需了解更多详情，请参阅 Apple 开发者文档网站上的 macOS Release Notes
下表中列出了当前支持的版本。
| macOS 版本 | PCoIP | DCV |
|---|---|---|
| 12（Monterey）及更早版本 | 不支持 | 不支持 |
| 13（Ventura） | 支持 | 支持 |
| 14（Sonoma） | 支持 | 支持 |
| 15（Sequoia） | 不支持 | 支持 |
设置和安装
从 Amazon WorkSpaces 客户端下载
更新客户端应用程序
macOS 上的 Amazon WorkSpaces 客户端应用程序将自动检查可用更新，当有新版本可用时，会在您不使用时在后台进行安装。安装完成后，您只需打开客户端即可开始使用最新版本。这样让您可以更快地访问最新功能、增强功能和错误修复，而不会影响您的工作效率。
注意
只有当您的客户端应用程序用于连接到以下区域的 WorkSpaces 时，才会应用自动客户端更新。
| 区域 | 地址 |
|---|---|
|
美国东部（弗吉尼亚州北部） |
us-east-1 |
|
美国西部（俄勒冈州） |
us-west-2 |
|
非洲（开普敦） |
af-south-1 |
|
亚太地区（孟买） |
ap-south-1 |
|
亚太地区（首尔） |
ap-northeast-2 |
|
亚太地区（新加坡） |
ap-southeast-1 |
|
亚太地区（悉尼） |
ap-southeast-2 |
|
Asia Pacific (Tokyo) |
ap-northeast-1 |
|
加拿大（中部） |
ca-central-1 |
|
欧洲地区（法兰克福） |
eu-central-1 |
|
欧洲地区（爱尔兰） |
eu-west-1 |
|
欧洲地区（伦敦） |
eu-west-2 |
|
欧洲地区（巴黎） |
eu-west-3 |
|
以色列（特拉维夫） |
il-central-1 |
|
南美洲（圣保罗） |
sa-east-1 |
在上面未列出的任何其他区域，macOS 上的 Amazon WorkSpaces 客户端应用程序不会自动更新；当有新版本可用时，您会看到一条消息，并且可以选择安装。
确定您的客户端版本
要查看您使用的是哪个版本的 WorkSpaces 客户端，请选择 Amazon WorkSpaces、关于 Amazon WorkSpaces 或者单击右上角的齿轮图标并选择关于 Amazon WorkSpaces。
连接到您的 WorkSpace
要连接到您的 WorkSpace，请完成以下步骤。
-
首次运行客户端应用程序时，系统会提示您输入您的欢迎电子邮件中所包含的注册代码。WorkSpaces 客户端应用程序使用注册代码和用户名来确定要连接的 WorkSpace。以后当您启动客户端应用程序时，将会使用相同的注册代码。要输入不同的注册码，请启动客户端应用程序，然后选择登录页面底部的更改注册码。
-
输入您的登录凭证，然后选择登录。如果 WorkSpaces 管理员为贵组织的 WorkSpaces 启用了多重身份验证，系统会提示您输入密码才能完成登录。您的 WorkSpaces 管理员会提供更多有关如何获取密码的信息。
-
如果您的 WorkSpaces 管理员尚未禁用保持登录状态功能，您可以选中登录屏幕底部的保持登录状态复选框以安全地保存您的凭证，以便可以轻松连接您的 WorkSpace，同时仍确保客户端应用程序始终运行。您的凭据安全地缓存到 Kerberos 票证中，时间可达其最长使用期限。
在客户端应用程序连接到您的 WorkSpace 之后，您的 WorkSpace 桌面将会显示。
网络连接中断会导致活动会话断开连接。这可能会因如下事件导致：合上笔记本电脑的盖子，或无线网连接丢失。如果网络连接在一段时间内恢复，适用于 macOS 的 WorkSpaces 客户端应用程序将尝试自动重新连接会话。默认会话恢复超时时间为 20 分钟，但您的网络管理员可以修改此超时时间。
管理您的登录信息（仅限 3.0+ 客户端）
您可以查看您的注册代码以及您的 WorkSpace 所在的区域。您可以指定是否希望 WorkSpaces 客户端应用程序保存当前注册代码，并可以为您的 WorkSpaces 分配一个名称。您还可以指定是否希望 Amazon WorkSpaces 保持您登录到 WorkSpace，直到您退出或登录期到期为止。
管理 WorkSpace 的登录信息
-
在 WorkSpaces 客户端应用程序中，依次转到设置和管理登录信息。
-
在 Manage Login Information (管理登录信息) 对话框中，您可以看到 WorkSpace 的注册代码和区域信息。
-
（可选）如果您希望 WorkSpaces 客户端记住您当前的注册代码，请选中 Remember Registration Code (记住注册代码) 复选框。
-
在 Saved registration codes (已保存的注册代码) 下，选择要命名的 WorkSpace。
-
在 WorkSpace 名称框中，输入 WorkSpace 的名称。
-
（可选）如果您希望 WorkSpaces 保持登录状态，直到您退出或登录期过期，请选中 Keep me logged in (保持登录状态) 复选框。
-
选择 Save。
客户端视图
您可以通过在客户端应用程序菜单中选择查看、进入全屏（3.0+ 客户端），切换到全屏模式。
在全屏模式下，您可以通过将指针移动到屏幕顶部来切换回窗口模式。客户端应用程序菜单会显示，然后您可以选择客户端应用程序菜单中的查看、离开全屏（3.0+ 客户端）。
您也可以通过按 Command+Option+Return 来切换全屏模式。
客户端语言
您可以通过执行以下步骤来选择客户端显示的语言。
注意
WorkSpaces 客户端应用程序支持日语。但是，日语 WorkSpaces 仅在 亚太地区（东京) 地区可用。
要选择客户端语言，请执行以下操作：
-
根据您使用的客户端，执行以下操作之一。
如果您使用的是…… 请执行该操作 3.0+ 客户端
在 WorkSpaces 客户端应用程序中，依次转到设置和更改语言。
-
在 Select a language (选择语言) 列表中输入所需的语言，然后选择 Save (保存)。
-
重新启动客户端。
显示器支持
WorkSpaces Value、Standard、Performance、Power、PowerPro 和 GraphicsPro 捆绑包支持最多四个显示器，且最大分辨率为 3840x2160（超高清或 UHD）。支持的最大分辨率取决于显示器的数量，如下表所示。
| 显示器 | 解决方案 |
|---|---|
|
2 |
3840x2160 |
|
4 |
1920x1200 |
注意
-
您只能扩展显示器。您无法复制显示器。复制显示器将导致您的会话中断。
-
Graphics 捆绑包仅支持单个显示器配置，且最大分辨率为 2560x1600。
WorkSpaces 客户端应用程序在启动会话之前，会提取所有已连接显示器的扩展显示器信息数据 (EDID)，并确定最兼容的匹配项。如果您有一个高像素密度（高 DPI）显示器，客户端应用程序会根据您的本地 DPI 设置，自动扩展播放窗口。要使用高 DPI 显示器获取更好的最大分辨率，请参阅为 WorkSpaces 启用高 DPI 显示器。
注意
如果 WorkSpaces 中的屏幕分辨率很低，并且对象看起来有点模糊，则您需要打开高 DPI 模式，并调整 Mac 上的显示缩放设置。有关更多信息，请参阅 为 WorkSpaces 启用高 DPI 显示器。
将多个监视器用于 WorkSpaces
-
配置本地计算机以便使用多个显示器。有关更多信息，请参阅 Apple 文档中的 Connect one or more external displays with your Mac
。 -
启动 WorkSpaces 客户端应用程序并登录到您的工作区。
-
根据您使用的客户端，执行以下操作之一。
如果您使用的是…… 请执行该操作 3.0+ 客户端 依次选择 View (视图) 和 Enter Full Screen On All Displays (在所有显示器上进入全屏模式)。您也可以通过按 Command+Option+Return 来切换全屏模式。
现在，您的工作区应该扩展到所有显示器上。当您进入全屏模式时，您指定为主显示器的任何显示器同时也是 WorkSpaces 中的主显示器。
注意
在多显示器设置中，若要仅在部分显示器上使用全屏模式，请按住 Option 键，然后单击 WorkSpaces 窗口左上角的绿色最大化按钮
。此按钮将 WorkSpaces 客户端窗口展开到显示器的全尺寸，但不会将工作区扩展到其他显示器。若要返回到之前的窗口大小，请按住 Option 键，然后再次单击最大化按钮。
代理服务器
如果您的网络要求您使用代理服务器访问 Internet，您可以启用 WorkSpaces 客户端应用程序来使用代理访问 HTTPS（端口 443）流量。WorkSpaces 客户端应用程序使用 HTTPS 端口进行更新、注册和身份验证。
注意
-
与 WorkSpace 的桌面流式传输连接需要启用端口 4172 和 4195，而且不能通过代理服务器。
-
不支持需要使用登录凭证进行身份验证的代理服务器。
默认情况下，3.0+ macOS 客户端使用设备操作系统设置中指定的代理服务器。首次启动客户端时，将使用设备操作系统的代理服务器设置。如果您为代理服务器选择其他选项，则该设置将用于客户端的后续启动。
注意
如果您指定自定义代理服务器，则在尝试登录 WorkSpace 时可能会出现“无网络”错误。要解决此问题，请使用默认的操作系统代理服务器，而不是在 macOS 客户端中指定自定义代理服务器。
-
在 WorkSpaces 客户端应用程序中，依次转到设置和管理代理服务器。
-
在设置代理对话框中，选择使用代理服务器，输入代理服务器 URL 或 IP 地址及端口，然后选择保存。
命令快捷方式
WorkSpaces macOS 客户端支持以下命令快捷方式：
| 如果您使用的是…… | 使用这些快捷方式 |
|---|---|
|
3.0+ 客户端 |
Command+Q — 退出 Amazon WorkSpaces Command+Option+Return — 切换全屏显示 Command+Option+F12 — 断开会话 |
重新映射 Windows 徽标键或 Command 键
默认情况下，当您使用 Amazon WorkSpaces macOS 客户端应用程序时，Windows 键盘上的 Windows 徽标键和 Apple 键盘上的 Command 键都会映射到 Ctrl 键。如果要更改此行为，以便将这两个键映射到 Windows 徽标键供 Windows WorkSpaces 使用，请使用以下过程。
将 Windows 徽标键或 Command 键映射到 Windows 徽标键
-
如果尚未执行此操作，请安装或更新至 3.0.5 或更高版本的 Amazon WorkSpaces macOS 客户端应用程序。
-
在查找工具中，打开您的应用程序文件夹，打开实用程序，然后选择终端。
-
在“终端”窗口中，输入以下命令，然后按 Return 键。
defaults write "com.amazon.Amazon WorkSpaces Client" remap_cmd_to_ctrl 0
-
在终端应用程序中，选择终端、退出终端。
-
如果您的 WorkSpaces macOS 客户端应用程序正在运行，请选择 Amazon WorkSpaces，并在客户端中选择退出 Amazon WorkSpaces，关闭该客户端应用程序。
-
重新启动 WorkSpaces macOS 客户端应用程序并登录到您的工作区。Windows 徽标键或 Command 键现在应映射到 Windows 徽标键。
Disconnect
您可以通过几种方法断开 macOS 客户端应用程序的连接：
-
在 Amazon WorkSpaces 客户端应用程序中，转到 Amazon WorkSpaces，然后选择断开 WorkSpace 连接。工作区会话结束，但客户端应用程序将继续运行，以方便您的再次登录。
-
在 Amazon WorkSpaces 客户端应用程序中，转到 Amazon WorkSpaces，然后选择结束会话。
结束会话时，系统会提示您保存已打开的文档。在提示中选择结束会话，这将断开您与 WorkSpaces 客户端用户会话的连接。
注意
此选项仅适用于 WorkSpaces 虚拟桌面池。
-
在 Amazon WorkSpaces 客户端应用程序中，转到 Amazon WorkSpaces，然后选择退出 Amazon WorkSpaces。工作区会话结束，客户端应用程序关闭。
-
在 Amazon WorkSpaces 客户端应用程序中，单击左上角的红色关闭 (X) 按钮来关闭 WorkSpaces 客户端窗口。这会使您断开会话连接并返回到应用程序主页。
-
您也可以从工作区中注销。在 Amazon WorkSpaces 客户端应用程序中，转到视图，然后选择发送 Ctrl+Alt+Delete。选择注销。工作区会话结束，但客户端应用程序将继续运行，以方便您的再次登录。
剪贴板支持
剪贴板支持的最大未压缩对象大小为 20 MB。有关更多信息，请参阅 我在复制和粘贴时遇到了问题。
注意
从 Microsoft Office 应用程序复制时，剪贴板仅包含上次复制的项目，并且该项目将转换为标准格式。如果您从 Microsoft Office 应用程序复制大于 890 KB 的内容，该应用程序可能会变慢或长达 5 秒钟无响应。
诊断日志上传
启用诊断日志上传
要解决 WorkSpaces 客户端问题，您可以启用诊断日志记录功能。发送到 WorkSpaces 的日志文件包含有关您的设备以及与 AWS 网络的连接的详细信息。您可以在 WorkSpace 流式传输会话之前或期间启用诊断日志上传功能，以便将这些文件自动发送到 WorkSpaces。
发送日志文件
注意
您可以在 WorkSpaces 流式传输会话之前和期间发送日志文件。
-
打开您的 Amazon WorkSpaces 客户端。
-
在 WorkSpaces 登录页面的顶部，选择管理诊断日志记录设置。
-
在弹出的对话框中，选择为 Amazon WorkSpaces 启用诊断日志记录，然后单击保存。
重要
向 AWS 支持部门报告问题时，请务必跟踪遇到问题的客户端的设备 ID。此设备 ID 可以在诊断日志记录菜单和 WorkSpaces 客户端导航栏中找到，它可以帮助支持团队识别与您的特定设备相关的日志。请务必在针对此特定问题创建的票证中包含设备 ID。
发行说明
下表介绍了在客户端应用程序各个发行版中进行的更改。
| 版本 | 日期 | 更改 |
|---|---|---|
| 5.30.1 | 2025 年 10 月 21 日 |
|
| 5.29.1 | 2025 年 8 月 6 日 |
|
| 5.29.0 | 2025 年 7 月 31 日 |
|
| 5.28.1 | 2025 年 7 月 2 日 |
|
| 5.27.0 | 2025 年 4 月 30 日 |
|
| 5.26.2 | 2025 年 4 月 1 日 | 错误修复和增强功能。 |
| 5.26.0 | 2025 年 3 月 4 日 |
|
| 5.25.0 | 2024 年 12 月 19 日 | 错误修复和增强功能。 |
| 5.24.0 | 2024 年 11 月 22 日 |
|
| 5.23.1 | 2024 年 10 月 17 日 | 错误修复和增强功能。 |
| 5.23.0 | 2024 年 9 月 30 日 |
|
| 5.22.1 | 2024 年 9 月 3 日 |
错误修复和增强功能。 |
| 5.22.0 | 2024 年 8 月 16 日 | 更新了 DCV SDK。 |
| 5.21.0 | 2024 年 7 月 3 日 |
错误修复和增强功能。 |
| 5.20.0 | 2024 年 6 月 13 日 |
|
| 5.19.3 | 2024 年 4 月 30 日 | 修复了用户在连接 DCV WorkSpaces 时会立即断开与其连接的问题。 |
| 5.19.0 | 2024 年 2 月 28 日 |
|
| 5.18.0 | 2024 年 1 月 22 日 |
|
| 5.17.0 | 2023 年 11 月 16 日 |
|
| 5.16.0 | 2023 年 10 月 26 日 |
|
| 5.15.1 | 2023 年 9 月 20 日 |
|
| 5.12.0 | 2023 年 8 月 29 日 |
|
| 5.11.0 | 2023 年 6 月 29 日 |
添加了启用或禁用 Ctrl + 左键单击的选项，以及启用或禁用将 Command 键映射到 Ctrl 键的选项。要访问这两个选项，请从菜单栏中选择设置和管理修改键。 |
| 5.10.0 | 2023 年 6 月 19 日 |
|
| 5.9.0 | 2023 年 5 月 9 日 | 更新了 DCV SDK 以修复播放音量问题。 |
| 5.8.0 | 2023 年 4 月 6 日 |
|
| 5.7.0 | 2023 年 2 月 23 日 |
|
| 5.6.0 | 2022 年 12 月 27 日 |
|
| 5.5.0 | 2022 年 11 月 14 日 | 更新了 DCV 客户端 SDK。 |
| 5.4.0 | 2022 年 11 月 10 日 | 添加了快捷方式 Command+Alt+F12，用于断开 WorkSpaces 连接。 |
| 5.3.0 | 2022 年 9 月 15 日 |
错误修复和增强功能。 |
| 5.2.0 | 2022 年 8 月 24 日 |
修复了使用智能卡时出现的 WorkSpaces 登录问题。 |
| 5.1.0 | 2022 年 6 月 30 日 |
更新了适用于 MacOS 的 PCoIP SDK。 |
| 4.0.7 | 2022 年 3 月 3 日 | 修复了由 MacBook 上的代理设置导致的 WorkSpaces 连接错误。 |
| 4.0.6 | 2021 年 12 月 21 日 |
|
| 4.0.5 | 2021 年 11 月 23 日 |
|
| 4.0.4 | 2021 年 11 月 3 日 |
|
| 4.0.3 | 2021 年 10 月 4 日 | 错误修复和增强功能。 |
| 4.0.2 | 2021 年 9 月 8 日 | 次要错误修复和增强功能。 |
| 4.0.1 | 2021 年 8 月 5 日 | 次要错误修复和增强功能。 |
| 3.1.9 | 2021 年 6 月 29 日 | 次要错误修复和增强功能。 |
| 3.1.8 | 2021 年 5 月 28 日 |
|
| 3.1.7 | 2021 年 4 月 29 日 |
|
| 3.1.6 | 2021 年 4 月 8 日 |
修复了因 DCV 音频流量优化而导致的断开连接和崩溃问题 |
| 3.1.5 | 2021 年 4 月 2 日 |
|
| 3.1.4 | 2021 年 3 月 16 日 |
|
| 3.1.3 | 2021 年 2 月 15 日 |
|
| 3.1.2 | 2021 年 1 月 8 日 |
|
| 3.1.0 | 2020 年 12 月 1 日 |
次要错误修复和增强功能 |
| 3.0.12 | 2020 年 11 月 10 日 |
|
| 3.0.11 | 2020 年 10 月 2 日 |
|
| 3.0.10 | 2020 年 9 月 16 日 |
增加了对通过端口 4195（UDP 和 TCP）进行运行状况检查的支持 |
| 3.0.9 | 2020 年 8 月 14 日 |
次要错误修复和增强功能 |
| 3.0.8 | 2020 年 7 月 30 日 |
|
|
3.0.7 |
2020 年 6 月 3 日 |
|
|
3.0.6 |
2020 年 4 月 28 日 |
|
|
3.0.5 |
2020 年 3 月 30 日 |
|
|
3.0.4 |
2020 年 3 月 3 日 |
|
|
3.0.3 |
2020 年 2 月 24 日 |
改进了在高 DPI 设备上的可读性 |
|
3.0.2 |
2020 年 2 月 14 日 |
|
|
3.0.0 |
2019 年 11 月 25 日 |
|
|
2.5.11 |
2019 年 11 月 4 日 |
|
|
2.5.9 |
次要错误修复 |
|
|
2.5.8 |
|
|
|
2.5.7 |
|
|
|
2.5.6 |
较小的修复 |
|
|
2.5.5 |
|
|
|
2.5.2 |
|
|
|
2.5.1 |
|
|
|
2.5.0 |
添加了对用户自助 WorkSpace 管理功能的支持 |
|
|
2.4.10 |
较小的修复 |
|
|
2.4.9 |
较小的修复 |
|
|
2.4.8 |
|
|
|
2.4.7 |
|
|
|
2.4.6 |
|
|
|
2.4.4 |
|
|
|
2.4.2 |
较小的修复 |
|
|
2.4.0 |
|
|
|
2.3.7 |
|
|
|
2.3.6 |
本地化增强功能 |
|
|
2.3.5 |
较小的改进 |
|
|
2.3.3 |
|
|
|
2.3.1 |
较小的修复 |
|
|
2.3.0 |
|
|
|
2.2.3 |
解决了小错误并改进了稳定性 |
|
|
2.2.1 |
|
|
|
2.1.4 |
解决了 macOS Sierra 上的崩溃问题 |
|
|
2.1.3 |
关闭客户端将使重新连接令牌失效。只要客户端在运行，您就可以轻松地重新连接到 WorkSpace。 |
|
|
2.1.0 |
|
|
|
2.0.8 |
|
|
|
2.0.4 |
|
|
|
1.1.80 |
|
|
|
1.1.6 |
|
|
|
flink-client |
|
|
|
1.0.8 |
|
|
|
1.0 |
初始版本 |
