Ir para o conteúdo principal
Atendimento (62) 3142-5255

Como criar sua chave SSH e acessar seu Cloud Server MVO

Guia da base de conhecimento43 visualizações

Guia para Windows 10/11 e servidor Linux. Ao final, há comandos equivalentes para macOS e Linux.

Como funciona no painel

Você cria a chave no seu computador e cola somente a parte pública no gerenciamento do seu Cloud Server, em Configurações → Chave pública SSH.

O painel aplica a chave ao usuário de acesso configurado no servidor Linux e a salva também no Cloud-Init. O cadastro não exige reiniciar e mantém as outras chaves autorizadas. A máquina precisa estar ligada e com o QEMU Guest Agent ativo; se o painel informar que o agente está indisponível, solicite a ativação ao suporte.

1. Separe as informações do seu servidor

Você precisará de:

  • Acesso à sua conta em https://mvo.host.
  • IP público do seu Cloud Server.
  • Usuário do sistema operacional. Neste guia, usamos root para o servidor Debian entregue com esse usuário.
  • Senha do servidor para o primeiro login pelo console. Ela não é necessariamente igual à senha da sua conta MVO.
  • Seu computador Windows, com acesso ao PowerShell.

Os comandos de conexão usam IP_DO_SERVIDOR. Substitua esse texto pelo IP exibido no seu serviço. Não use o IP do painel ou do host Proxmox.

2. Entenda quais arquivos serão criados

Arquivo Para que serve Onde fica
mvo_cliente_ed25519 Chave privada: comprova sua identidade ao conectar Somente no seu computador
mvo_cliente_ed25519.pub Chave pública: autoriza sua chave privada no servidor Pode ser cadastrada no seu servidor

Envie somente o arquivo com final .pub ou seu conteúdo. Nunca envie a chave privada.

A senha de proteção da chave, chamada passphrase, é escolhida na criação. Ela protege o arquivo privado e é diferente da senha do servidor.

3. Crie a chave no Windows

3.1 Abra o PowerShell

Abra o menu Iniciar, procure PowerShell e abra o aplicativo. A geração da chave não precisa de uma janela como administrador.

Digite:

ssh -V

Se aparecer uma versão do OpenSSH, prossiga.

Se o Windows informar que ssh não foi encontrado, instale o Cliente OpenSSH nos Recursos Opcionais do Windows. Em computadores de empresa, peça ao responsável de TI para instalar. Depois, feche e reabra o PowerShell.

3.2 Prepare o local dos arquivos

No PowerShell:

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.ssh" | Out-Null
Test-Path "$env:USERPROFILE\.ssh\mvo_cliente_ed25519"

Se retornar False, o nome está disponível. Se retornar True, já existe uma chave com esse nome: use outro nome, como mvo_notebook_ed25519, em todos os comandos seguintes. Não sobrescreva uma chave existente.

3.3 Gere a chave

ssh-keygen -t ed25519 -C "meu-pc-mvo" -f "$env:USERPROFILE\.ssh\mvo_cliente_ed25519"

O texto meu-pc-mvo é uma identificação. Você pode usar notebook-pessoal, por exemplo.

Quando aparecer Enter passphrase, digite uma senha de proteção para a chave e pressione Enter. Digite a mesma senha novamente quando solicitado. É normal não aparecerem caracteres enquanto você digita.

Ao terminar, os dois arquivos estarão na pasta .ssh do seu usuário do Windows. A criação e o uso de Ed25519 são documentados pelo OpenSSH.

3.4 Veja e copie a parte pública

Para mostrar a chave pública:

Get-Content "$env:USERPROFILE\.ssh\mvo_cliente_ed25519.pub"

Para copiá-la:

Get-Content "$env:USERPROFILE\.ssh\mvo_cliente_ed25519.pub" | Set-Clipboard

O conteúdo começa com ssh-ed25519, seguido de uma sequência longa e da identificação. Copie a linha inteira. Não substitua parte dela por ... e não acrescente quebras de linha no meio.

Se aparecer BEGIN OPENSSH PRIVATE KEY, você abriu o arquivo errado. Feche-o e abra o arquivo terminado em .pub. Consulte também a orientação da Microsoft sobre chaves OpenSSH.

4. Cadastre a chave pela área do cliente

  1. Entre em https://mvo.host com sua conta MVO.
  2. Abra Serviços e selecione o Cloud Server que deseja acessar.
  3. Confira o nome e o IP para não cadastrar a chave em outro servidor.
  4. No gerenciamento Proxmox, abra a aba Configurações.
  5. Localize a seção Chave pública SSH.
  6. No campo Cole sua chave pública (.pub), cole a linha copiada na etapa 3.4.
  7. Clique em Adicionar chave SSH e aguarde a resposta do painel.

O campo recebe o conteúdo do arquivo .pub. Não é preciso anexar um arquivo. A chave deve começar com ssh-ed25519 ou ssh-rsa; informe uma chave por vez. São aceitas Ed25519 e RSA de 2048 a 8192 bits.

A confirmação informa que a chave foi autorizada e identifica o usuário Linux. No servidor deste exemplo, o usuário é root. Se o painel indicar outro usuário, use esse nome no comando SSH da etapa 6.

Você não precisa abrir o console, editar arquivos Linux ou reiniciar o servidor para cadastrar a chave por esse formulário.

5. Confira a confirmação antes de conectar

O simples preenchimento do campo não conclui o cadastro: aguarde a mensagem de sucesso após clicar em Adicionar chave SSH.

  • Sucesso: a chave foi aplicada ao usuário Linux e salva no Cloud-Init. Você pode conectar imediatamente.
  • Chave inválida: copie novamente todo o conteúdo do .pub. Não informe a chave privada, não use reticências e não misture duas chaves.
  • Servidor desligado: ligue a máquina, aguarde o Linux iniciar e repita o cadastro.
  • Agente indisponível: solicite ao suporte a ativação do QEMU Guest Agent.
  • Chave autorizada no Linux, mas não salva no Cloud-Init: tente novamente para concluir a persistência, conforme a mensagem exibida.

Adicionar novamente a mesma chave não cria uma cópia duplicada. Cadastrar outra chave acrescenta um acesso; não remove automaticamente a chave anterior. Esse comportamento evita que outro computador autorizado perca acesso durante uma troca de equipamento.

6. Faça o primeiro acesso pelo seu computador

6.1 Confira a identidade do servidor

Para conferir a identidade antes do primeiro acesso, abra Console no gerenciamento do serviço, faça login com o usuário e a senha do servidor e execute:

ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

Essa é a identidade do servidor, diferente da chave pessoal criada no seu computador.

6.2 Conecte pelo PowerShell

ssh -o IdentitiesOnly=yes -i "$env:USERPROFILE\.ssh\mvo_cliente_ed25519" root@IP_DO_SERVIDOR

Substitua IP_DO_SERVIDOR pelo IP real. O caminho após -i aponta para a chave privada, sem .pub; o SSH a usa localmente.

No primeiro acesso, pode aparecer uma pergunta sobre a autenticidade do host. Compare a impressão digital e o algoritmo apresentados com os consultados no console. Se forem iguais, digite yes. Se forem diferentes, não confirme antes de esclarecer com o suporte.

Quando aparecer Enter passphrase for key, digite a senha de proteção escolhida ao gerar a chave. Essa solicitação é normal. As opções de identidade e a verificação do host são descritas no manual do cliente SSH.

6.3 Confirme o acesso

Depois que aparecer o terminal Linux, execute:

whoami
hostname

O usuário deve corresponder ao informado na confirmação do painel (root neste exemplo), e o hostname deve corresponder ao seu servidor. Para encerrar a conexão SSH, digite exit.

Se você abriu o console do navegador para conferir a identidade do servidor, digite exit nele também e feche-o após o teste.

7. Como acessar nas próximas vezes

Abra o PowerShell e repita:

ssh -o IdentitiesOnly=yes -i "$env:USERPROFILE\.ssh\mvo_cliente_ed25519" root@IP_DO_SERVIDOR

Você não precisa criar uma chave nova a cada conexão. Para outro computador, gere um novo par e acrescente sua chave pública no servidor, com uma identificação diferente.

8. Problemas frequentes

Mensagem ou situação O que conferir
Permission denied (publickey) Confira IP, usuário, arquivo privado usado em -i e a mensagem de sucesso no cadastro. Se continuar, informe o erro ao suporte sem enviar sua chave privada.
Identity file ... not accessible Confira o nome do arquivo e a pasta .ssh do seu usuário Windows.
Enter passphrase for key Informe a passphrase da chave, não a senha da conta MVO ou do servidor.
Connection timed out Confira IP, VM ligada, conectividade e liberação da porta SSH. Não desative o firewall inteiro para testar.
Connection refused O endereço respondeu, mas o SSH pode estar parado ou em outra porta. Confira pelo console.
REMOTE HOST IDENTIFICATION HAS CHANGED A identidade do servidor mudou. Confirme se houve reinstalação e verifique a nova impressão pelo console/suporte antes de alterar seu registro local.
Não encontro o campo de chave Abra Configurações no gerenciamento Proxmox do serviço. O recurso é destinado a servidores Linux QEMU.
Esqueci a passphrase ou perdi a chave privada Use o console ou suporte para cadastrar uma nova chave pública; remova a antiga depois de validar o novo acesso.

Se sua porta SSH for diferente de 22, acrescente -p NUMERO_DA_PORTA ao comando de conexão.

9. Equivalente para macOS e Linux

Abra o Terminal. Confira se já existe o arquivo antes de gerar uma chave com o mesmo nome:

mkdir -p ~/.ssh
chmod 700 ~/.ssh
ls -l ~/.ssh/mvo_cliente_ed25519*

Se não existir, gere e visualize a chave pública:

ssh-keygen -t ed25519 -C "meu-pc-mvo" -f ~/.ssh/mvo_cliente_ed25519
cat ~/.ssh/mvo_cliente_ed25519.pub

Cadastre a parte pública no formulário da área do cliente, seguindo as etapas 4 e 5. Depois, conecte:

ssh -o IdentitiesOnly=yes -i ~/.ssh/mvo_cliente_ed25519 root@IP_DO_SERVIDOR

As etapas de conferência da identidade do servidor e de encerramento da sessão são as mesmas.

10. Quando trocar de computador ou remover um acesso

Cadastre primeiro a chave do computador novo e valide uma nova conexão. O formulário atual adiciona chaves; para revogar uma chave antiga, solicite ao suporte a remoção ou remova somente a linha correspondente em authorized_keys pelo console. Preserve as demais chaves e faça backup antes de editar. O OpenSSH utiliza uma chave por linha nesse arquivo, conforme o manual de authorized_keys.

Se o computador antigo foi perdido ou roubado, solicite a revogação da chave correspondente imediatamente. Excluir apenas o arquivo do seu PC não remove a autorização que ficou no servidor.

Continue aprendendo