Servidores

Conectar uma VPS

Cadastrar o servidor é a única parte do Zé Preguiça que pede um pouco de terminal — e é feita uma vez só. Este guia explica cada comando: o que ele faz, onde rodar e o que copiar pra onde.

O que você precisa antes de começar

Uma VPSUbuntu 22.04 ou mais novo, de qualquer provedor (a partir de ~R$20/mês)
O IP da VPSAparece no painel do seu provedor, na página do servidor
O usuário SSHGeralmente "root" ou "ubuntu" — o provedor informa ao criar a VPS
Um terminal no seu computadorTerminal no macOS/Linux, ou PowerShell no Windows 10+
Nota
Não entendeu algum desses itens? Sem problema — os passos abaixo mostram exatamente onde encontrar cada um.

Antes de tudo: o que é uma chave SSH?

Uma chave SSH é um par de arquivos que funciona como uma fechadura e sua chave: a chave pública (arquivo terminado em .pub) fica instalada na VPS e funciona como a fechadura; a chave privada (arquivo sem .pub) fica com você e é o que abre essa fechadura. O Zé Preguiça usa a chave privada pra se conectar na sua VPS de forma segura, sem senha.

Passo 1 — Gere um par de chaves no seu computador

Abra o terminal do seu computador (não o da VPS) e rode o comando abaixo. Ele cria os dois arquivos da chave dentro da pasta .ssh do seu usuário, com o nome zepreguica_key:

Rode no terminal do SEU computador (macOS, Linux ou PowerShell no Windows)
ssh-keygen -t ed25519 -f ~/.ssh/zepreguica_key -N ""
-t ed25519 — o tipo da chave (moderno e seguro, pode confiar).-f ~/.ssh/zepreguica_key — onde salvar e com qual nome.-N "" — sem senha extra na chave, pra conexão automática funcionar.
Nota
É uma boa prática criar uma chave só pro Zé Preguiça em vez de reaproveitar a chave pessoal que você já usa — se um dia quiser revogar o acesso, é só remover essa chave da VPS.

Passo 2 — Autorize a chave pública na VPS

Agora a VPS precisa conhecer a sua chave pública (a "fechadura"). No macOS e Linux, um comando resolve — troque "usuario" e "ip-da-vps" pelos seus dados reais (ele vai pedir a senha da VPS uma última vez):

macOS / Linux
ssh-copy-id -i ~/.ssh/zepreguica_key.pub usuario@ip-da-vps

No Windows (PowerShell), o ssh-copy-id não existe — use este comando equivalente, que envia a chave pública e a adiciona à lista de chaves autorizadas da VPS:

Windows (PowerShell)
type $env:USERPROFILE\.ssh\zepreguica_key.pub | ssh usuario@ip-da-vps "cat >> ~/.ssh/authorized_keys"
Nota
Alguns provedores permitem colar a chave pública direto no painel deles na hora de criar a VPS (procure por "SSH Keys"). Se você fez isso, este passo já está resolvido.

Passo 3 — Copie a chave privada

O painel precisa da chave privada pra se conectar. Mostre o conteúdo dela no terminal e copie tudo — incluindo as linhas "-----BEGIN..." e "-----END..." do início e do fim:

Mostra a chave privada pra você copiar
cat ~/.ssh/zepreguica_key
Atenção
Atenção pra não confundir: o painel recebe a chave privada (arquivo zepreguica_key, sem .pub). A pública (.pub) é a que fica na VPS. E nunca envie a chave privada por WhatsApp, e-mail ou qualquer outro canal.

Passo 4 — Cadastre o servidor no painel

1
Abra "Servidores" e clique em "Novo servidor"
Na navegação principal do painel.
2
Preencha os campos
Cada campo explicado na tabela logo abaixo.
3
Clique em "Testar conexão"
O painel tenta se conectar na hora e diz exatamente o que está errado, se algo estiver.
4
Salve
Com a conexão validada, o servidor aparece na sua lista pronto pra ser provisionado.
NomeUm apelido só seu, ex: "VPS Principal"
IP / HostO endereço público da VPS (está no painel do provedor)
Usuário SSHroot, ubuntu, ou o usuário administrador que você usa
Porta SSH22, a menos que você tenha mudado de propósito
Chave privadaO conteúdo completo que você copiou no Passo 3
Cuidado
Deu "Connection refused" ou timeout no teste? As causas mais comuns: IP digitado errado, porta bloqueada no firewall do provedor (AWS e Oracle bloqueiam por padrão), ou a chave privada não corresponde à pública autorizada. Veja a página Problemas comuns pra resolver cada caso.

Próximo passo

Com a conexão validada, o próximo passo é o provisionamento — um clique que instala tudo que o servidor precisa pra rodar projetos. É a próxima página desta documentação.