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

# WorkSpaces Linux 客户端应用程序
<a name="amazon-workspaces-linux-client"></a>

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

**Topics**
+ [要求](#linux-requirements)
+ [设置和安装](#linux_setup)
+ [正在连接到你的 WorkSpace](#linux_connecting)
+ [管理您的登录信息](#manage-login-info-linx)
+ [客户端视图](#linux_views)
+ [客户端语言](#linux_client_lang)
+ [显示器支持](#linux-display-support)
+ [代理服务器](#linux_proxy_server)
+ [命令快捷方式](#linux_shortcuts)
+ [剪贴板重定向](#linux_clipboard)
+ [Disconnect](#linux_disconnect)
+ [发行说明](#linux-release-notes)

## 要求
<a name="linux-requirements"></a>

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

**注意**  
默认情况下，Linux 客户端访问处于禁用状态。要将此客户端与您一起使用 WorkSpace，您的 Amazon WorkSpaces 管理员必须为您的 WorkSpaces 目录启用 Linux 客户端访问权限。有关更多信息，请参阅《*Amazon WorkSpaces 管理指南*》中的[控制设备访问权限](https://docs.aws.amazon.com/workspaces/latest/adminguide/update-directory-details.html#control-device-access)。
如果您 WorkSpace 位于亚太地区（孟买）地区，则必须使用版本 3.1.3 或更高版本的 Amazon WorkSpaces Linux 客户端应用程序。
适用于 Ubuntu 22.04 的 WorkSpaces Linux 客户端版本 2023.0.4395 仅适用于 DCV。

## 设置和安装
<a name="linux_setup"></a>

从 [Amazon 客户端下载中下载并安装 WorkSpaces Linux WorkSpaces 客户端](https://clients.amazonworkspaces.com/)应用程序。客户端下载网站的 Linux 客户端页面上提供了详细的安装说明。

### 2023.x 客户端
<a name="w2aab9c14b9b9b1"></a>

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

`workspacesclient`

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

### 3.x 和 4.x 客户端
<a name="w2aab9c14b9b9b3"></a>

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

`/opt/workspacesclient/workspacesclient`

## 正在连接到你的 WorkSpace
<a name="linux_connecting"></a>

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

**要连接到你的 WorkSpace**

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

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

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

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

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

## 管理您的登录信息
<a name="manage-login-info-linx"></a>

您可以查看您的注册码以及您 WorkSpace 所在的地区。您可以指定是否希望 WorkSpaces 客户端应用程序保存您当前的注册码，也可以为其指定一个名称 WorkSpace。您还可以指定是否希望 Amazon 在您退出或登录期 WorkSpaces 到期 WorkSpace 之前保持您的登录状态。

### 2023.x 客户端
<a name="w2aab9c14c13b5b1"></a>

**管理您的登录信息 WorkSpace**

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

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

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

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

1. 在**WorkSpace 名称**框中，输入名称 WorkSpace。

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

1. 选择**保存**。

### 3.x 和 4.x 客户端
<a name="w2aab9c14c13b5b3"></a>

**管理您的登录信息 WorkSpace**

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

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

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

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

1. 在**WorkSpace 名称**框中，输入名称 WorkSpace。

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

1. 选择**保存**。

## 客户端视图
<a name="linux_views"></a>

### 适用于 2023.x 客户端的全屏模式
<a name="w2aab9c14c15b3b1"></a>

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

### 适用于 3.x 和 4.x 客户端的全屏模式
<a name="w2aab9c14c15b3b3"></a>

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

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

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

## 客户端语言
<a name="linux_client_lang"></a>

### 2023.x 客户端
<a name="w2aab9c14c17b3b1"></a>

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

### 3.x 和 4.x 客户端
<a name="w2aab9c14c17b3b3"></a>

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

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

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

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

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

1. 重新启动客户端。

## 显示器支持
<a name="linux-display-support"></a>

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


| 显示器 | 解决方案 | 
| --- | --- | 
|  2  |  3840x2160  | 
|  4  |  1920x1200  | 

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

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

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

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

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

1. 根据您使用的客户端，执行以下操作之一。
**注意**  
如果您使用的是带有 DCV 的 2023.x 客户端版本 WorkSpaces，并且连接了三台或更多显示器，则 WorkSpace 还可以将全屏模式扩展到部分可用显示器。在您的显示设置中，所选显示器必须设置为相邻显示器或彼此共享一侧。DCV 多显示器支持是使用 DCV 技术构建的。有关要求和故障排除的更多信息，请参阅[在选定显示器上扩展全屏模式](https://docs.aws.amazon.com/dcv/latest/userguide/full-screen-selected-monitors.html)。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html)

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

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

## 代理服务器
<a name="linux_proxy_server"></a>

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

**注意**  
台式机流媒体连接 WorkSpace 需要启用端口 4172 和 4195，并且不通过代理服务器。
不支持需要使用登录凭证进行身份验证的代理服务器。

### 使用代理服务器
<a name="w2aab9c14c21b7"></a>

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

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

#### 2023.x 客户端
<a name="w2aab9c14c21b7b7b1"></a>

#### 使用代理服务器


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

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

#### 3.x 和 4.x 客户端
<a name="w2aab9c14c21b7b7b3"></a>

#### 使用代理服务器


1. 在 WorkSpaces 客户端应用程序中，前往 **“设置”、“****管理代理服务器**”。

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

## 命令快捷方式
<a name="linux_shortcuts"></a>

 PCoIP WorkSpaces Linux 客户端支持以下命令快捷方式：
+ Ctrl\$1Alt\$1Enter — 切换全屏显示（仅限 IP）PCo

## 剪贴板重定向
<a name="linux_clipboard"></a>

剪贴板支持的最大未压缩对象大小为 20 MB。有关更多信息，请参阅[我在复制和粘贴时遇到问题](https://docs.aws.amazon.com/workspaces/latest/userguide/client_troubleshooting.html)。

## Disconnect
<a name="linux_disconnect"></a>

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

### 2023.x 客户端
<a name="w2aab9c14c27b5b1"></a>
+ 在 theWorkSpaces 直播会话中，通过关闭窗口来结束 WorkSpace 会话。在对话框中，选择 “**断开连接**” 以结束会 WorkSpace 话。如果您想再次登录，客户端应用程序将继续运行。
+ 在 WorkSpaces 直播会话中，点击三行菜单图标并选择**断开连接**，结束 WorkSpace 会话。客户端应用程序将继续运行，允许您再次登录。

### 3.x 和 4.x 客户端
<a name="w2aab9c14c27b5b3"></a>
+ 在亚马逊 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并关闭客户端应用程序。

### 诊断日志上传
<a name="linux-disconnect-diagnostic-log-upload"></a>

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

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

**发送日志文件**

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

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

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

1. 通过选择**日志级别**下的单选按钮，可以选择要在会话日志中提供的数据量。您可以选择**标准日志记录（默认）**或**高级日志记录**。
**重要**  
向报告问题时 支持，请务必跟踪遇到问题的客户端的设备 ID。输入注册码后，可以在客户端登录页面的设置诊断日志记录菜单中找到设备 ID。这可以帮助支持团队识别与您的特定设备相关的日志。请务必在针对特定问题创建的工单中包含设备 ID。

## 发行说明
<a name="linux-release-notes"></a>

### WorkSpaces 适用于 Ubuntu 24.04 的客户端应用程序发行说明
<a name="linux-2404-client-release-notes"></a>

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


| 发布版本 | 日期 | 更改 | 
| --- | --- | --- | 
| 2025.1 | 2025 年 12 月 12 日 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 

### WorkSpaces 适用于 Ubuntu 的客户端应用程序 22.04 版本说明
<a name="linux-2204-client-release-notes"></a>

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


| 发布版本 | 日期 | 更改 | 
| --- | --- | --- | 
| 2025.1 | 2025 年 12 月 12 日 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2025.0 | 2025 年 5 月 28 日 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2024.8 | 2024 年 12 月 11 日 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2024.7 | 2024 年 10 月 10 日 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2024.5 | 2024 年 8 月 26 日 |  错误修复和增强功能。  | 
| 2024.4 | 2024 年 8 月 15 日 |  错误修复和增强功能。  | 
| 2024.3 | 2024 年 8 月 8 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2024.2 | 2024 年 7 月 3 日 |  错误修复和增强功能。  | 
| 2024.1 | 2024 年 6 月 11 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2024.0 | 2024 年 2 月 28 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2023.2 | 2023 年 12 月 19 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2023.1 | 2023 年 11 月 12 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2023.0.4395 | 2023 年 8 月 24 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) 此版本不支持统一资源标识符（URI）。有关更多信息，请参阅[自定义用户如何登录他们](https://docs.aws.amazon.com/workspaces/latest/adminguide/customize-workspaces-user-login.html)的 WorkSpaces | 

### WorkSpaces 适用于 Ubuntu 20.04 的客户端应用程序发行说明
<a name="linux-2004-client-release-notes"></a>

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


| 发布版本 | 日期 | 更改 | 
| --- | --- | --- | 
| 2025.1 | 2025 年 12 月 12 日 |  错误修复和增强功能。  | 
| 2025.0 | 2025 年 5 月 28 日 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2024.8 | 2024 年 12 月 11 日 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2024.7 | 2024 年 10 月 10 日 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2024.6 | 2024 年 9 月 5 日 | 错误修复和增强功能。 | 
| 2024.5 | 2024 年 8 月 26 日 |  错误修复和增强功能。  | 
| 2024.4 | 2024 年 8 月 15 日 |  错误修复和增强功能。  | 
| 2024.3 | 2024 年 8 月 8 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2024.2 | 2024 年 7 月 3 日 |  错误修复和增强功能。  | 
| 2024.1 | 2024 年 6 月 11 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2024.0 | 2024 年 2 月 28 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2023.2 | 2023 年 12 月 19 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2023.1 | 2023 年 11 月 12 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 4.7.0 | 2023 年 11 月 1 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2023.0.4430 | 2023 年 8 月 24 日 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html) 此版本不支持统一资源标识符（URI）。有关更多信息，请参阅[自定义用户如何登录他们](https://docs.aws.amazon.com/workspaces/latest/adminguide/customize-workspaces-user-login.html)的 WorkSpaces | 
| 4.6.0 | 2023 年 6 月 21 日 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 4.5.0 | 2022 年 12 月 27 日 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 4.4.0 | 2022 年 10 月 27 日 |  Ubuntu 20.04 支持。  |