SSH no navegador

É possível se conectar a instâncias do Compute Engine no console Google Cloud usando a ferramenta SSH no navegador. O SSH no navegador não exige nenhuma extensão ou software adicional. O SSH no navegador oferece suporte a conexõescom instâncias que armazenam chaves SSH em metadados, instâncias que usam o Login do SO eque usam o IAP para encaminhamento de TCP.

Cada vez que você se conecta a uma instância usando SSH no navegador, o Compute Engine cria um par de chaves SSH temporário e define um nome de usuário para a conexão. O nome de usuário e o local onde o Compute Engine armazena as chaves SSH dependem do uso de chaves SSH armazenadas nos metadados ou do login do SO. Para mais informações, consulte Sobre conexões SSH.

Requisitos

Para usar o SSH no navegador, seu ambiente precisa atender aos seguintes requisitos:

  • O console doGoogle Cloud precisa estar em execução em um navegador da Web compatível.
  • A instância a que você está se conectando precisa ter o ambiente convidado instalado e em execução. O ambiente convidado é pré-instalado nas instâncias criadas a partir de imagens públicas fornecidas pelo Google.

  • A rede precisa atender aos requisitos a seguir.

    • Os proxies HTTPS e os dispositivos de segurança não podem descriptografar e recriptografar o tráfego usando o próprio certificado TLS. Por exemplo, para realizar a inspeção TLS.
    • A rede precisa permitir o tráfego de e para nomes de host terminados em google.com, gstatic.com ou googleapis.com.
    • A rede precisa permitir que os pacotes sejam enviados para os endereços IP dos domínios padrão.
    • Para se conectar às instâncias por meio do endereço IP externo, a nuvem privada virtual (VPC) precisa permitir o tráfego de entrada TCP para o intervalo de IP 0.0.0.0/0.
    • Para se conectar a instâncias que têm apenas endereços IP internos, é preciso configurar regras de firewall para permitir o IAP para encaminhamento de TCP.

Limitações

  • Indisponível em perímetros do VPC Service Controls. O SSH no navegador não é compatível com os perímetros do VPC Service Controls. Em vez disso, use a CLI gcloud. Para mais informações, consulte Conectar-se a VMs do Linux ou Como se conectar a um console serial, dependendo do seu caso de uso.
  • Tempos de transferência de chave SSH lentos. O tempo de transferência de chave SSH no navegador varia de 2 a 25 segundos.
  • Desconexões intermitentes. No momento, não oferecemos um contrato de nível de serviço (SLA) específico para ciclos de vida da conexão. Se você pretende manter a janela do terminal aberta por um período prolongado, use multiplexadores de terminal, como tmux ou screen.
  • A transferência de arquivos grandes pode ser lenta. Se você tiver tempos de transferência de arquivos lentos, use o comando gcloud compute scp em vez do SSH no navegador.

Usar SSH no navegador

As seções a seguir descrevem como usar o SSH no navegador para se conectar, desconectar e gerenciar arquivos nas suas instâncias.

Conectar a instâncias

Para se conectar a uma instância usando SSH no navegador, faça o seguinte:

  1. No console do Google Cloud , acesse a página Instâncias de VM.

    Acessar instâncias de VM

  2. Na lista de instâncias, clique no botão SSH na linha da instância a que você quer se conectar.

Depois de clicar em SSH, o SSH no navegador será aberto em uma nova janela.

Se a instância tiver uma das seguintes configurações, consulte a seção dela para mais informações sobre como se conectar:

Conectar-se a instâncias que não têm endereços IP públicos

Quando você usa o SSH no navegador para se conectar a uma instância que tem apenas um endereço IP interno, o SSH no navegador usa o encaminhamento de TCP do IAP.

Conectar-se a instâncias com chaves SSH enviadas pelo usuário

O SSH no navegador aceita conexões com chaves SSH ECDSA enviadas pelo usuário para instâncias que usam o Login do SO.

Para se conectar a uma instância com uma chave SSH enviada pelo usuário, faça o seguinte:

  1. No console do Google Cloud , acesse a página Instâncias de VM.

    Acessar instâncias de VM

  2. Na lista de instâncias, clique no menu suspenso ao lado do botão SSH da instância a que você quer se conectar.

  3. Clique em Abrir na janela do navegador usando a chave SSH privada fornecida.

    A janela SSH no navegador será aberta.

  4. Clique em Conectar com o arquivo de chave SSH e escolha a chave privada associada à chave pública no perfil do Login do SO.

Conectar-se a instâncias do Cloud TPU

Para se conectar a uma Cloud TPU, consulte Conectar-se a uma instância do Cloud TPU.

Desconectar-se de instâncias

Para se desconectar de uma instância e encerrar uma sessão SSH no navegador, execute o comando exit.

A janela SSH no navegador também será fechada se você usar o atalho de teclado da estação de trabalho para fechar janelas:

Windows e Linux

Ctrl+W

macOS

Cmd+W

Chrome OS

Ctrl+Shift+W

Rolar pelo terminal

É possível rolar o terminal usando a roda do mouse ou o trackpad. Também é possível usar os atalhos de teclado adequados ao sistema operacional da estação de trabalho.

Windows e Linux

Para rolar para cima, use Ctrl+Shift+PageUp. Para rolar para baixo, use Ctrl+Shift+PageDn.

macOS

Para rolar para cima, use Fn+Shift+Up. Para rolar para baixo, use Fn+Shift+Down.

Chrome OS

Para rolar para cima, use Alt+Shift+Up. Para rolar para baixo, use Alt+Shift+Down.

Copiar e colar texto

A opção de cópia padrão para SSH no navegador é Copiar ao selecionar. Qualquer texto destacado no SSH no navegador será copiado. Como alternativa, você pode copiar e colar o texto usando os atalhos de teclado do sistema operacional da sua estação de trabalho.

Windows e Linux

Para copiar o texto, use Ctrl+C. Para colar o texto, use Ctrl+V.

macOS

Para copiar o texto, use Cmd+C. Para colar o texto, use Cmd+V.

Chrome OS

Não há atalho de teclado para copiar arquivos. Para colar o texto, use Ctrl+Shift+V.

Se você tiver problemas para copiar e colar grandes blocos de texto, use a transferência de arquivos.

Transferir arquivos

Para saber como transferir arquivos de e para instâncias usando SSH no navegador, consulte Transferir arquivos usando SSH no navegador.

Resolver problemas

Para depurar métodos e resolver erros comuns de SSH, principalmente se o console da Web SSH não se conectar ou ficar preso em uma tela de carregamento, consulte as orientações dedicadas de Solução de problemas do SSH no navegador.

Para diagnósticos abrangentes, consulte Solução de problemas de SSH.