Aplicação cliente do WorkSpaces para Linux

As informações a seguir ajudarão você a começar a usar a aplicação cliente do WorkSpaces para Linux.

Requisitos

Para que a versão 2023.x do cliente do WorkSpaces para Linux possa acessar o serviço WorkSpaces, você deve adicionar o domínio do Acesso via Web do WorkSpaces (https://webclient.amazonworkspaces.com/) à lista de permissões na rede da qual o cliente está tentando acessar o serviço.

nota

• Por padrão, o acesso ao cliente do Linux está desabilitado. Para usar esse cliente com o WorkSpace, o administrador do Amazon WorkSpaces deve habilitar o acesso ao cliente do Linux para o diretório do WorkSpaces. Para obter mais informações, consulte Controlar o acesso do dispositivo no Guia de administração do Amazon WorkSpaces.

• Se o WorkSpace estiver localizado na região Ásia-Pacífico (Mumbai), você deverá usar a versão 3.1.3 ou posterior da aplicação cliente do Amazon WorkSpaces para Linux.

• A versão 2023.0.4395 do cliente do WorkSpaces para Linux para Ubuntu 22.04 está disponível somente para o DCV.

Configuração e instalação

Baixe e instale a aplicação cliente do WorkSpaces para Linux em Amazon WorkSpaces Client Downloads. Instruções de instalação detalhadas estão incluídas na página do cliente Linux no site Downloads do cliente.

Clientes 2023.x

Para iniciar o cliente Linux na linha de comando, use:

workspacesclient

nota

Ao executar uma nova aplicação cliente, você deverá informar seu código de registro, que pode ser encontrado em seu e-mail de boas-vindas. Para clientes existentes, o código de registro está em /home/UserName/.local/share/Amazon Web Services/Amazon WorkSpaces/RegisterationList.json.

Clientes 3.x e 4.x

Para iniciar o cliente Linux na linha de comando, use:

/opt/workspacesclient/workspacesclient

Conexão ao WorkSpace

Para se conectar ao seu WorkSpace, siga o procedimento a seguir.

Como se conectar a um WorkSpace

1. Na primeira vez que você executar a aplicação cliente, será solicitado seu código de registro, que está informado no e-mail de boas-vindas. A aplicação cliente do WorkSpaces usa o código de registro e o nome de usuário para identificar a qual WorkSpace se conectar. Quando você inicia a aplicação cliente posteriormente, o mesmo código de registro é usado. Para inserir um código de registro diferente, inicialize a aplicação cliente e escolha Alterar o código de registro na parte inferior da página de login.

2. Insira as credenciais na tela de login e escolha Fazer login. Se o administrador do WorkSpaces tiver habilitado a autenticação multifator para WorkSpaces da sua organização, você precisará fornecer uma senha para concluir o login. O administrador do WorkSpaces fornecerá mais informações sobre como obter a senha.

3. Se o administrador do WorkSpaces não tiver desabilitado o recurso Mantenha-me conectado, você poderá marcar a caixa de seleção Mantenha-me conectado na parte inferior da tela de login para salvar suas credenciais com segurança a fim de se conectar facilmente ao WorkSpace enquanto a aplicação cliente permanece em execução. Suas credenciais são armazenadas em cache com segurança até o máximo tempo de vida do seu tíquete Kerberos.

   Depois que a aplicação cliente se conecta ao WorkSpace, seu desktop do WorkSpace é exibido.

Uma interrupção de conectividade de rede causa a desconexão de uma sessão ativa. Isso pode ser causado por eventos como o fechamento a tampa do notebook ou a perda da conexão de rede sem fio. A aplicação cliente do WorkSpaces para Linux tentará reconectar a sessão automaticamente se a conectividade de rede for restabelecida dentro de determinado período. O tempo limite padrão para retomar a sessão é de 20 minutos, mas esse tempo limite pode ser modificado pelo administrador da rede.

Gerencie suas informações de login

É possível visualizar o código de registro e em qual região o WorkSpace está. É possível especificar se deseja que a aplicação cliente do WorkSpaces salve o código de registro atual, e você pode atribuir um nome ao WorkSpace. Também é possível especificar se deseja que o Amazon WorkSpaces mantenha você conectado a um WorkSpace até você sair ou até o período de login expirar.

Clientes 2023.x

Como gerenciar as informações de login do WorkSpace

1. Na aplicação cliente do WorkSpaces, acesse Configurações e Gerenciar informações de login.

2. Na caixa de diálogo Configurações, é possível ver o código de registro e as informações da região do WorkSpace.

3. (Opcional) Se quiser que o cliente do WorkSpaces lembre o código de registro atual, habilite a opção Salvar código de registro.

4. Em Saved registration codes (Códigos de registro salvos), selecione o WorkSpace que deseja nomear.

5. Na caixa WorkSpace name (Nome do WorkSpace), insira um nome para o WorkSpace.

6. (Opcional) Se quiser que o WorkSpaces mantenha você conectado até você sair ou até o período de login expirar, marque a caixa de seleção Keep me logged in (Mantenha-me conectado).

7. Selecione Salvar.

Clientes 3.x e 4.x

Como gerenciar as informações de login do WorkSpace

1. Na aplicação cliente do WorkSpaces, acesse Configurações e Gerenciar informações de login.

2. Na caixa de diálogo Manage Login Information (Gerenciar informações de login) é possível ver o código de registro e as informações da região do WorkSpace.

3. (Opcional) Se quiser que o cliente do WorkSpaces lembre o código de registro atual, marque a caixa de seleção Remember Registration Code (Lembrar código de registro).

4. Em Saved registration codes (Códigos de registro salvos), selecione o WorkSpace que deseja nomear.

5. Na caixa WorkSpace name (Nome do WorkSpace), insira um nome para o WorkSpace.

6. (Opcional) Se quiser que o WorkSpaces mantenha você conectado até você sair ou até o período de login expirar, marque a caixa de seleção Keep me logged in (Mantenha-me conectado).

7. Selecione Salvar.

Visualizações de cliente

Modo de tela cheia para clientes 2023.x

É possível alternar para o modo de tela cheia selecionando o ícone de tela cheia no menu da aplicação cliente. Enquanto estiver no modo de tela cheia, você poderá voltar ao modo de janela movendo o ponteiro na parte superior da tela. O menu da aplicação cliente é exibido, e você poderá selecionar Sair do modo de tela cheia nesse menu.

Modo de tela cheia para clientes 3.x e 4.x

É possível alternar para o modo de tela cheia selecionando View (Visualizar), Enter Full Screen (Entrar no modo de tela cheia) no menu da aplicação cliente.

Enquanto estiver no modo de tela cheia, você poderá voltar ao modo de janela movendo o ponteiro na parte superior da tela. O menu da aplicação cliente é exibido, e você poderá selecionar View (Visualizar), Leave Full Screen (Sair do modo de tela cheia) nesse menu.

Também é possível alternar o modo de tela cheia pressionando Ctrl+Alt+Enter.

Idioma do cliente

Clientes 2023.x

O cliente do WorkSpaces seleciona automaticamente o idioma de exibição padrão usado pelo sistema operacional do computador.

Clientes 3.x e 4.x

Você pode selecionar o idioma exibido pelo cliente, seguindo estas etapas.

nota

No cliente, o idioma japonês está disponível em todas as regiões. No entanto, japonês somente está disponível em Tóquio para WorkSpaces individuais.

Para selecionar o idioma do cliente

1. Na aplicação cliente do WorkSpaces, acesse Configurações e Alterar idioma.

2. Insira o idioma desejado na lista Select a language (Selecionar um idioma) e selecione Salvar.

3. Reinicie o cliente.

Suporte a telas

Os pacotes Value, Standard, Performance, Power, PowerPro e GraphicsPro do WorkSpaces oferecem suporte a até quatro telas e uma resolução máxima de 3840x2160 (ultra-alta definição, ou UHD). A resolução máxima compatível depende do número de monitores, conforme exibido na tabela a seguir.

Telas	Resolução
2	3840x2160
4	1920x1200

nota

• Você só pode ampliar a exibição. Você não pode duplicar a exibição. Duplicar a exibição fará com que a sessão seja desconectada.

• Os pacotes Graphics só oferecem suporte a uma configuração de monitor com uma resolução máxima de 2560x1600.

A aplicação cliente do WorkSpaces extrai Extended Display Information Data (EDID) de todas as telas anexadas e determina a melhor correspondência de compatibilidade antes de iniciar a sessão. Se você tiver uma tela de alto DPI, a aplicação cliente dimensionará automaticamente a janela de streaming de acordo com suas configurações locais de DPI. Para obter uma melhor resolução máxima com monitores de alto DPI, consulte Habilitando a exibição de alto DPI para WorkSpaces.

Como usar vários monitores com WorkSpaces

1. Configure sua máquina local para usar vários monitores.

2. Inicie o aplicativo cliente WorkSpaces e faça login no seu WorkSpace.

3. Dependendo do cliente que você estiver usando, siga um destes procedimentos:

   nota

   Se você estiver usando a versão do cliente 2023.x com WorkSpaces que utilizam DCV e houver três ou mais monitores conectados, o WorkSpace também poderá se estender para tela cheia em uma seleção desses monitores disponíveis. Os monitores selecionados devem ser colocados adjacentes ou compartilhando um lado com o outro, em sua configuração de exibição. O suporte para vários monitores DCV é construído usando a tecnologia DCV. Para obter mais informações sobre requisitos e solução de problemas, consulte Estendendo a tela cheia em monitores selecionados.

   Se você estiver usando...	Faça o seguinte
   Cliente 2023.x+	Escolha Em um único monitor para entrar no modo de tela cheia em um único monitor (somente DCV) Escolha Em monitores selecionados para entrar no modo de tela cheia em monitores selecionados (somente DCV) Escolha Em todos os monitores para estender o modo de tela cheia em todos os monitores (tanto para PCoIP quanto para DCV) Também é possível alternar o modo de tela cheia pressionando Ctrl+Alt+Enter (somente PCoIP).
   Cliente 3.0+ e 4.0+	Escolha View (Exibir), Enter Full Screen On All Displays (Inserir tela cheia em todos os monitores). Também é possível alternar o modo de tela cheia pressionando Ctrl+Alt+Enter.
   Cliente 2.0+	Escolha View (Exibir), Show Fullscreen (Mostrar em tela cheia). Também é possível alternar o modo de tela cheia pressionando Ctrl+Alt+Enter.

Seu WorkSpace agora deve ser estendido nos monitores. Qualquer monitor que você tiver designado como principal também será a tela principal no WorkSpaces quando você entrar no modo de tela cheia.

nota

Não é possível usar o modo de tela cheia em apenas alguns monitores em uma configuração de vários monitores. No entanto, é possível pressionar Alt+F10 ou clicar duas vezes na barra de título para maximizar a janela do cliente do WorkSpaces em um monitor, sem estender o WorkSpace para os outros monitores.

Servidores de proxy

Se a rede requer que você use um servidor proxy para acessar a internet, habilite a aplicação cliente do WorkSpaces a fim de usar um proxy para tráfego HTTPS (porta 443). As aplicações cliente do WorkSpaces usam a porta HTTPS para atualizações, registro e autenticação.

nota

• As conexões de streaming da área de trabalho com o WorkSpace exigem a habilitação das portas 4172 e 4195, e não passam pelo servidor proxy.

• Servidores proxy que exigem autenticação com credenciais de login não são compatíveis.

Usar um servidor proxy

Por padrão, o cliente Linux usa o servidor proxy especificado nas configurações do sistema operacional do dispositivo. Na primeira vez que o cliente é inicializado, a configuração do servidor proxy do sistema operacional do dispositivo é usada. Se você selecionar outra opção para o servidor proxy, essa configuração será usada para inicializações subsequentes do cliente.

nota

Nas versões 3.0.0 a 3.1.4, se você especificar um servidor proxy personalizado, um erro “Sem rede” poderá aparecer quando você tentar fazer login no WorkSpace. Se você quiser usar um servidor proxy personalizado com o cliente para Linux, recomendamos atualizar para a versão 3.1.5. Se não conseguir atualizar, você poderá contornar o problema usando o servidor proxy padrão do sistema operacional em vez de especificar um servidor proxy personalizado no cliente para Linux.

Clientes 2023.x

Para usar um servidor de proxy

1. Na aplicação cliente do WorkSpaces, na página de login, escolha o ícone do menu de três linhas, Configurações de conexão.

2. Na caixa de diálogo Configurações de conexão, escolha Personalizar servidor proxy para o WorkSpaces, insira o URL ou o endereço IP do servidor proxy e a porta, depois selecione Salvar.

Clientes 3.x e 4.x

Para usar um servidor de proxy

1. Na aplicação cliente do WorkSpaces, acesse Configurações e Gerenciar servidor proxy.

2. Na caixa de diálogo Definir proxy, selecione Usar servidor de proxy, insira o URL ou o endereço IP do servidor proxy e a porta, depois selecione Salvar.

Atalhos de comando

O cliente do WorkSpaces com PCoIP para Linux é compatível com os seguintes atalhos de comando:

• Ctrl+Alt+Enter: alterna exibição em tela cheia (somente PCoIP)

Redirecionamento da área transferência

A área de transferência suporta um tamanho máximo de objeto não compactado de 20 MB. Para obter mais informações, consulte Estou tendo problemas para copiar e colar.

Desconectar

Para desconectar a aplicação cliente Linux, você tem várias opções.

Clientes 2023.x

• Na sessão de streaming do WorkSpaces, encerre a sessão do WorkSpace fechando a janela. Na caixa de diálogo, escolha Desconectar para encerrar a sessão do WorkSpace. A aplicação cliente continuará em execução se você quiser fazer login novamente.

• Na sessão de streaming do WorkSpaces, encerre a sessão do WorkSpace clicando no ícone do menu de três linhas e escolhendo Desconectar. A aplicação cliente continuará em execução, o que permite que você faça login novamente.

Clientes 3.x e 4.x

• Na aplicação cliente Amazon WorkSpaces, acesse Amazon WorkSpaces e escolha Desconectar WorkSpace. A sessão do WorkSpace é encerrada, mas a aplicação cliente continua em execução caso queira fazer login novamente.

• Na aplicação cliente do Amazon WorkSpaces, acesse Amazon WorkSpaces e escolha Sair do Amazon WorkSpaces. A sessão do WorkSpace é encerrada, e a aplicação cliente é fechado.

• Na aplicação cliente do Amazon WorkSpaces, feche a janela do cliente do WorkSpaces clicando no botão de fechar (X) no canto superior direito.

• Na aplicação cliente do Amazon WorkSpaces, acesse Amazon WorkSpaces e escolha Desconectar o WorkSpace. A sessão do WorkSpace é encerrada, mas a aplicação cliente continua em execução caso queira fazer login novamente.

• Na aplicação cliente do Amazon WorkSpaces, acesse Amazon WorkSpaces e escolha Sair do Amazon WorkSpaces. A sessão do WorkSpace é encerrada, e a aplicação cliente é fechado.

• Na aplicação cliente do Amazon WorkSpaces, feche a janela do cliente do WorkSpaces clicando no botão de fechar (X) no canto superior direito. No prompt, escolha Encerrar sessão, isso desconecta você do Amazon WorkSpaces e fecha o aplicativo cliente.

Upload de log de diagnóstico

Para solucionar problemas com o cliente do WorkSpaces, você pode habilitar o registro em log de diagnóstico. Os arquivos de log que são enviados para o WorkSpaces incluem informações detalhadas sobre o dispositivo e conexão com a rede da AWS. Você pode habilitar os uploads de log de diagnóstico antes ou durante as sessões de streaming do WorkSpace para que esses arquivos sejam enviados automaticamente para o WorkSpaces.

nota

Você pode enviar arquivos de log antes e durante as sessões de streaming do WorkSpaces. O upload de registros é suportado apenas nos clientes Linux Ubuntu 20.04 e Ubuntu 22.04.

Como enviar arquivos de log

1. Abra o cliente do Amazon WorkSpaces.

2. No canto superior direito da página de login do WorkSpaces após o registro, escolha Configurações e, em seguida, Registro de diagnóstico.

3. Na caixa de diálogo pop-up, defina a opção em Registro de diagnóstico de acordo com a preferência desejada e escolha Salvar.

4. Você pode escolher a quantidade de dados que deseja fornecer em seus registros de sessão selecionando um botão de opção em Nível de registro. Você pode escolher o Registro padrão (padrão) ou Registro avançado.

   Importante

   Ao relatar um problema ao suporte da Suporte, garanta acompanhar o ID do dispositivo do cliente que está enfrentando o problema. O ID do dispositivo pode ser encontrado no menu de registro de diagnóstico de configurações na página de login do cliente após inserir um código de registro. Isso ajuda a equipe de suporte a identificar registros associados ao seu dispositivo específico. Garanta incluir o ID do dispositivo nos tíquetes que criar em relação a esse problema específico.

Notas da versão

Notas de versão da aplicação cliente do WorkSpaces para Ubuntu 22.04

A tabela a seguir descreve as alterações em cada versão da aplicação cliente Ubuntu 22.04.

Versão	Data	Alterações
2025.0	28 de maio de 2025	Atualização do SDK da DCV. Correções de bugs e melhorias.
2024.8	11 de dezembro de 2024	Foram adicionadas configurações persistentes de webcam e microfone que são salvas entre as sessões do DCV WorkSpaces. Correções de bugs e melhorias.
2024.7	10 de outubro de 2024	Protocolo DCV renomeado para protocolo Amazon DCV. Foi adicionado suporte para streaming pela porta 443 para protocolos TCP e UDP no DCV WorkSpaces. Adicionado suporte para autenticação baseada em certificado que permite uma experiência de autenticação única com menos prompts do usuário. Correções de bugs e melhorias.
2024.5	26 de agosto de 2024	Correções de bugs e melhorias.
2024.4	15 de agosto de 2024	Correções de bugs e melhorias.
2024.3	8 de agosto de 2024	SDK DCV atualizado. Atualização do SDK do PCoIP. Foi adicionado suporte para streaming pela porta TCP/UDP 443.
2024.2	3 de julho de 2024	Correções de bugs e melhorias.
2024.1	11 de junho de 2024	SDK DCV atualizado. Foi adicionado suporte à integração com SAML 2.0. Foi adicionado suporte à autenticação de cartões inteligentes pré-sessão.
2024.0	28 de fevereiro de 2024	SDK DCV atualizado. Corrigido o problema de captura do teclado Foi adicionado suporte ao WebAuthn para autenticação na sessão Pequenas correções de bugs e melhorias.
2023.2	19 de dezembro de 2023	Leitor de tela e navegação pelo teclado foram adicionados para melhorar a acessibilidade. Foi adicionado suporte para AWS GovCloud (Leste dos EUA) e AWS GovCloud (Oeste dos EUA).
2023.1	12 de novembro de 2023	Foi adicionado suporte para Uniform Resource Identifier (URI). Corrigido o problema de mapeamento do teclado japonês para a tecla tilde. Foi adicionado suporte para upload de registros de diagnóstico.
2023.0.4395	24 de agosto de 2023	Adição de suporte à conexão de WorkSpaces com DCV, incluindo WorkSpaces BYOL, para Windows e para Ubuntu. Adição de suporte à expansão para o modo de tela cheia em monitores selecionados, se houver mais de dois monitores conectados. Adição de suporte ao redirecionamento de webcam e áudio/vídeo bidirecional a fim de melhorar a experiência de conferências. Adição de opções para exibir métricas de streaming, incluindo taxa de quadros, latência de rede e largura de banda de download nos WorkSpaces. nota O Uniform Resource Identifier (URI) não é compatível com esta versão. Para obter mais informações, consulte Personalizar como os usuários fazem login em seus WorkSpaces

Notas de versão da aplicação cliente do WorkSpaces para Ubuntu 20.04

A tabela a seguir descreve as alterações em cada versão da aplicação cliente Ubuntu 20.04.

Versão	Data	Alterações
2025.0	28 de maio de 2025	Atualização do SDK da DCV. Correções de bugs e melhorias.
2024.8	11 de dezembro de 2024	Foram adicionadas configurações persistentes de webcam e microfone que são salvas entre as sessões do DCV WorkSpaces. Correções de bugs e melhorias.
2024.7	10 de outubro de 2024	Protocolo DCV renomeado para protocolo Amazon DCV. Foi adicionado suporte para streaming pela porta 443 para protocolos TCP e UDP no DCV WorkSpaces. Adicionado suporte para autenticação baseada em certificado que permite uma experiência de autenticação única com menos prompts do usuário. Atualização do SDK do PCoIP. Correções de bugs e melhorias.
2024.6	5 de setembro de 2024	Correções de bugs e melhorias.
2024.5	26 de agosto de 2024	Correções de bugs e melhorias.
2024.4	15 de agosto de 2024	Correções de bugs e melhorias.
2024.3	8 de agosto de 2024	SDK DCV atualizado. Atualização do SDK do PCoIP. Foi adicionado suporte para streaming pela porta TCP/UDP 443.
2024.2	3 de julho de 2024	Correções de bugs e melhorias.
2024.1	11 de junho de 2024	SDK DCV atualizado. Foi adicionado suporte à integração com SAML 2.0.
2024.0	28 de fevereiro de 2024	SDK DCV atualizado. SDK PCoIP atualizado. Corrigido o problema de captura do teclado Foi adicionado suporte ao WebAuthn para autenticação na sessão Pequenas correções de bugs e melhorias.
2023.2	19 de dezembro de 2023	Leitor de tela e navegação pelo teclado foram adicionados para melhorar a acessibilidade. Foi adicionado suporte para AWS GovCloud (Leste dos EUA) e AWS GovCloud (Oeste dos EUA).
2023.1	12 de novembro de 2023	Foi adicionado suporte para Uniform Resource Identifier (URI). Corrigido o problema de mapeamento do teclado japonês para a tecla tilde. Foi adicionado suporte para upload de registros de diagnóstico
4.7.0	1.º de novembro de 2023	Adição de suporte à região Israel (Tel Aviv). Corrigido o problema de mapeamento do teclado japonês para a tecla tilde. SDK PCoIP atualizado para Linux.
2023.0.4430	24 de agosto de 2023	Adição de suporte à conexão de WorkSpaces com DCV, incluindo WorkSpaces BYOL, para Windows e para Ubuntu. (Somente DCV) Adição de suporte à expansão para o modo de tela cheia em monitores selecionados, se houver mais de dois monitores conectados. (Somente DCV) Adição de suporte ao redirecionamento de webcam e áudio/vídeo bidirecional a fim de melhorar a experiência de conferências. (Somente DCV) Adição de opções para exibir métricas de streaming, incluindo taxa de quadros, latência de rede e largura de banda de download nos WorkSpaces. nota O Uniform Resource Identifier (URI) não é compatível com esta versão. Para obter mais informações, consulte Personalizar como os usuários fazem login em seus WorkSpaces
4.6.0	21 de junho de 2023	Melhoria da personalização da marca do cliente ao armazenar ativos nas mesmas regiões AWS em que os WorkSpaces foram provisionados. Resolução de um problema de ajuste de escala automático de imagens com arquivos personalizados de logotipo de marca do cliente. Problemas de mapeamento do teclado japonês corrigidos.
4.5.0	27 de dezembro de 2022	Resolução de um problema em que os usuários não conseguiam se desconectar do WorkSpaces quando a conectividade de rede era perdida ou ficava indisponível. Atualização do SDK do PCoIP para o cliente do WorkSpaces para Linux.
4.4.0	27 de outubro de 2022	Compatibilidade com Ubuntu 20.04.