Este documento descreve como se conectar a instâncias de máquinas virtuais (VM) Linux que possuem endereços IP externos. Para saber como se conectar a VMs que não possuem endereços IP externos, consulte Opções de conexão para VMs somente internas .
Para obter informações sobre como as conexões SSH funcionam no Compute Engine, incluindo configuração e armazenamento de chaves SSH, consulte Conexões SSH com VMs Linux .
Antes de começar
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
- In the Google Cloud console, go to the VM instances page.
-
In the list of virtual machine instances, click SSH in the row of
the instance that you want to connect to.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Execute o seguinte comando:
gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME
Substitua o seguinte:
-
PROJECT_ID
: o ID do projeto que contém a VM -
ZONE
: o nome da zona em que a VM está localizada -
VM_NAME
: o nome da VM
Se você definiu propriedades padrão para a CLI do Google Cloud, poderá omitir as sinalizações
--project
e--zone
deste comando. Por exemplo:gcloud compute ssh VM_NAME
-
- Adicione uma chave SSH à VM, caso ainda não o tenha feito.
No console do Google Cloud, acesse a página Instâncias de VM e encontre o endereço IP externo da VM à qual você deseja se conectar.
- Abra um terminal em sua estação de trabalho.
Conecte-se à VM executando o seguinte comando:
ssh -i PATH_TO_PRIVATE_KEY USERNAME@EXTERNAL_IP
Substitua o seguinte:
-
PATH_TO_PRIVATE_KEY
: o caminho para o arquivo de chave SSH privada que corresponde à chave pública que você adicionou à VM. -
USERNAME
: seu nome de usuário. Se você gerencia suas chaves SSH em metadados, o nome de usuário é o que você especificou quando criou a chave SSH . Para contas de login do sistema operacional, o nome de usuário é definido no seu perfil do Google . Por exemplo,cloudysanfrancisco_example_com
oucloudysanfrancisco
. -
EXTERNAL_IP
: o endereço IP externo da VM.
-
- Adicione uma chave SSH à VM, caso ainda não o tenha feito.
- Se sua estação de trabalho ainda não tiver o aplicativo PuTTY instalado, baixe os arquivos do pacote PuTTY .
No console do Google Cloud, acesse a página Instâncias de VM e encontre o endereço IP externo da VM à qual você deseja se conectar.
- Abra o aplicativo PuTTY. Uma janela de configuração de conexão é aberta.
No campo
Host Name
, insira o nome de usuário associado à chave SSH e o endereço IP externo da VM à qual você deseja se conectar. Use o seguinte formato:USERNAME@EXTERNAL_IP
Substitua o seguinte:
-
USERNAME
: seu nome de usuário. Se você gerencia suas chaves SSH em metadados, o nome de usuário é o que você especificou quando criou a chave SSH . Para contas de login do sistema operacional, o nome de usuário é definido no seu perfil do Google . Por exemplo,cloudysanfrancisco_example_com
oucloudysanfrancisco
. -
EXTERNAL_IP
: o endereço IP externo da VM.
-
- No menu Categoria , navegue até Connection > SSH > Auth .
- No campo Arquivo de chave privada para autenticação , selecione o arquivo de chave SSH privada que corresponde à chave pública que você adicionou à VM.
- Clique em Abrir para se conectar à VM.
Adicione uma chave SSH à VM, caso ainda não o tenha feito.
Instale o Secure Shell em seu Chromebook ou navegador Chrome, caso ainda não tenha feito isso.
No console do Google Cloud, acesse a página Instâncias de VM e encontre o endereço IP externo da VM à qual você deseja se conectar.
Abra o Secure Shell na barra de endereços da guia do navegador Chrome, fazendo o seguinte:
- Digite
ssh
. - Pressione
Space
. - Pressione
Enter
.
- Digite
Clique em [Nova conexão] .
No campo nome de usuário , digite seu nome de usuário. Se você gerencia suas chaves SSH em metadados, o nome de usuário é o que você especificou quando criou a chave SSH . Para contas de login do sistema operacional, o nome de usuário é definido no seu perfil do Google . Por exemplo,
cloudysanfrancisco_example_com
oucloudysanfrancisco
.No campo hostname , insira o endereço IP externo da VM.
No campo Identidade , clique em Importar... e selecione o caminho para o arquivo de chave SSH privada que corresponde à chave pública que você adicionou à VM.
Clique em [ENTER] Conectar para conectar-se à VM.
- Saiba como gerenciar o acesso às VMs .
- Aprenda como transferir arquivos para VMs .
- Saiba como as conexões SSH com VMs Linux funcionam no Compute Engine.
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
- In the Google Cloud console, go to the VM instances page.
-
In the list of virtual machine instances, click SSH in the row of
the instance that you want to connect to.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Execute o seguinte comando:
gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME
Substitua o seguinte:
-
PROJECT_ID
: o ID do projeto que contém a VM -
ZONE
: o nome da zona em que a VM está localizada -
VM_NAME
: o nome da VM
Se você definiu propriedades padrão para a CLI do Google Cloud, poderá omitir as sinalizações
--project
e--zone
deste comando. Por exemplo:gcloud compute ssh VM_NAME
-
- Adicione uma chave SSH à VM, caso ainda não o tenha feito.
No console do Google Cloud, acesse a página Instâncias de VM e encontre o endereço IP externo da VM à qual você deseja se conectar.
- Abra um terminal em sua estação de trabalho.
Conecte-se à VM executando o seguinte comando:
ssh -i PATH_TO_PRIVATE_KEY USERNAME@EXTERNAL_IP
Substitua o seguinte:
-
PATH_TO_PRIVATE_KEY
: o caminho para o arquivo de chave SSH privada que corresponde à chave pública que você adicionou à VM. -
USERNAME
: seu nome de usuário. Se você gerencia suas chaves SSH em metadados, o nome de usuário é o que você especificou quando criou a chave SSH . Para contas de login do sistema operacional, o nome de usuário é definido no seu perfil do Google . Por exemplo,cloudysanfrancisco_example_com
oucloudysanfrancisco
. -
EXTERNAL_IP
: o endereço IP externo da VM.
-
- Adicione uma chave SSH à VM, caso ainda não o tenha feito.
- Se sua estação de trabalho ainda não tiver o aplicativo PuTTY instalado, baixe os arquivos do pacote PuTTY .
No console do Google Cloud, acesse a página Instâncias de VM e encontre o endereço IP externo da VM à qual você deseja se conectar.
- Abra o aplicativo PuTTY. Uma janela de configuração de conexão é aberta.
No campo
Host Name
, insira o nome de usuário associado à chave SSH e o endereço IP externo da VM à qual você deseja se conectar. Use o seguinte formato:USERNAME@EXTERNAL_IP
Substitua o seguinte:
-
USERNAME
: seu nome de usuário. Se você gerencia suas chaves SSH em metadados, o nome de usuário é o que você especificou quando criou a chave SSH . Para contas de login do sistema operacional, o nome de usuário é definido no seu perfil do Google . Por exemplo,cloudysanfrancisco_example_com
oucloudysanfrancisco
. -
EXTERNAL_IP
: o endereço IP externo da VM.
-
- No menu Categoria , navegue até Connection > SSH > Auth .
- No campo Arquivo de chave privada para autenticação , selecione o arquivo de chave SSH privada que corresponde à chave pública que você adicionou à VM.
- Clique em Abrir para se conectar à VM.
Adicione uma chave SSH à VM, caso ainda não o tenha feito.
Instale o Secure Shell em seu Chromebook ou navegador Chrome, caso ainda não tenha feito isso.
No console do Google Cloud, acesse a página Instâncias de VM e encontre o endereço IP externo da VM à qual você deseja se conectar.
Abra o Secure Shell na barra de endereços da guia do navegador Chrome, fazendo o seguinte:
- Digite
ssh
. - Pressione
Space
. - Pressione
Enter
.
- Digite
Clique em [Nova conexão] .
No campo nome de usuário , digite seu nome de usuário. Se você gerencia suas chaves SSH em metadados, o nome de usuário é o que você especificou quando criou a chave SSH . Para contas de login do sistema operacional, o nome de usuário é definido no seu perfil do Google . Por exemplo,
cloudysanfrancisco_example_com
oucloudysanfrancisco
.No campo hostname , insira o endereço IP externo da VM.
No campo Identidade , clique em Importar... e selecione o caminho para o arquivo de chave SSH privada que corresponde à chave pública que você adicionou à VM.
Clique em [ENTER] Conectar para conectar-se à VM.
- Saiba como gerenciar o acesso às VMs .
- Aprenda como transferir arquivos para VMs .
- Saiba como as conexões SSH com VMs Linux funcionam no Compute Engine.
Sistemas operacionais suportados
Esses métodos de conexão são compatíveis com todas as imagens públicas do Linux disponíveis no Compute Engine. Para imagens do Fedora CoreOS, você deve configurar o acesso SSH antes de poder usar esses métodos.
Conectar-se a VMs
Para se conectar a uma VM, conclua as etapas em uma das guias a seguir.
Console
Conecte-se às VMs usando SSH-in-Browser no console do Google Cloud fazendo o seguinte:
gcloud
Conecte-se a uma VM usando SSH executando o comando
gcloud compute ssh
:Cliente OpenSSH
Conecte-se a uma VM usando SSH de um cliente OpenSSH, faça o seguinte:
Aplicativo PuTTY
Conecte-se a uma VM usando SSH do aplicativo Windows PuTTY, fazendo o seguinte:
Aplicativo Secure Shell do Chrome
Para se conectar a uma VM usando SSH do aplicativo Secure Shell Chrome, faça o seguinte:
Solução de problemas
Para encontrar métodos para diagnosticar e resolver conexões SSH com falha, consulte Solução de problemas de SSH .
O que vem a seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-04-21 UTC.
-
Sistemas operacionais suportados
Esses métodos de conexão são compatíveis com todas as imagens públicas do Linux disponíveis no Compute Engine. Para imagens do Fedora CoreOS, você deve configurar o acesso SSH antes de poder usar esses métodos.
Conectar-se a VMs
Para se conectar a uma VM, conclua as etapas em uma das guias a seguir.
Console
Conecte-se às VMs usando SSH-in-Browser no console do Google Cloud fazendo o seguinte:
gcloud
Conecte-se a uma VM usando SSH executando o comando
gcloud compute ssh
:Cliente OpenSSH
Conecte-se a uma VM usando SSH de um cliente OpenSSH, faça o seguinte:
Aplicativo PuTTY
Conecte-se a uma VM usando SSH do aplicativo Windows PuTTY, fazendo o seguinte:
Aplicativo Secure Shell do Chrome
Para se conectar a uma VM usando SSH do aplicativo Secure Shell Chrome, faça o seguinte:
Solução de problemas
Para encontrar métodos para diagnosticar e resolver conexões SSH com falha, consulte Solução de problemas de SSH .
O que vem a seguir
Este documento descreve como se conectar a instâncias de máquinas virtuais (VM) Linux que possuem endereços IP externos. Para saber como se conectar a VMs que não possuem endereços IP externos, consulte Opções de conexão para VMs somente internas .
Para obter informações sobre como as conexões SSH funcionam no Compute Engine, incluindo configuração e armazenamento de chaves SSH, consulte Conexões SSH com VMs Linux .
Antes de começar
-