Como configurar múltiplos aliases de conexão SSH no arquivo config local

Oi! Aqui é a Sensei da GeHost 🥋 Se você usa o terminal para acessar seus servidores com frequência, sabe como é chato ficar digitando o comando completo de SSH toda vez, com usuário, endereço e porta. Hoje vou te ensinar um truque simples que vai economizar seu tempo (e sua paciência): criar aliases de conexão no arquivo config do SSH, direto na sua máquina.

Com isso, em vez de digitar algo longo e chato, você digita só um apelido curto — tipo ssh meusite — e pronto, já conecta.

Quan trọng: a disponibilidade e a forma de acesso SSH podem variar de acordo com o seu plano e contrato. Se tiver dúvida sobre suas credenciais de acesso, confira no painel.gehost.com.br ou fale com o suporte antes de configurar.

O que você vai precisar

Um computador com terminal (Linux, macOS ou Windows com WSL/PowerShell + OpenSSH);
Os dados de acesso SSH da sua hospedagem (usuário, endereço e porta) — geralmente disponíveis no seu painel ou nas informações enviadas na entrega do serviço;
Alguns minutinhos de paciência. 😉

Passo 1 — Encontre (ou crie) o arquivo config

O arquivo que guarda os aliases fica sempre dentro da pasta oculta .ssh da sua conta de usuário. Abra o terminal e digite:

Verifique se a pasta existe: ls -la ~/.ssh
Se não existir, crie: mkdir -p ~/.ssh
Abra (ou crie) o arquivo config com o editor de sua preferência, por exemplo: nano ~/.ssh/config

Passo 2 — Entenda a estrutura de um alias

Cada apelido de conexão segue este modelo básico:

Host meusite
    HostName seuendereco.exemplo.com.br
    User seu_usuario
    Port 22

Host: é o apelido que você vai digitar no terminal (pode ser qualquer nome, sem espaços);
HostName: é o endereço real do servidor (domínio ou IP fornecido a você);
User: o usuário de acesso SSH da sua hospedagem;
Port: a porta de conexão (se for a padrão, esse item pode até ser omitido).

Passo 3 — Cadastre vários aliases no mesmo arquivo

A grande mágica é que você pode empilhar quantos blocos "Host" quiser, um embaixo do outro, um para cada site ou servidor que você administra:

Host site1
    HostName site1.exemplo.com.br
    User usuario1
    Port 22

Host site2
    HostName site2.exemplo.com.br
    User usuario2
    Port 22

Host servidorloja
    HostName loja.exemplo.com.br
    User usuarioloja
    Port 22

Salve o arquivo (no nano, use Ctrl+O para salvar e Ctrl+X para sair).

Passo 4 — Conecte usando o apelido

Agora, em vez do comando completo, é só usar o apelido que você escolheu:

ssh site1

Pronto! O SSH já sabe o endereço, o usuário e a porta certos, tudo automaticamente.

Dica de ouro: escolha nomes de aliases fáceis de lembrar e que façam sentido pra você, como o nome do projeto ou do cliente. Isso ajuda muito quando você administra vários sites ao mesmo tempo.

Passo 5 (opcional) — Ajuste as permissões do arquivo

Por segurança, é recomendado que o arquivo config (e a pasta .ssh) tenham permissões restritas, só para o seu usuário:

chmod 700 ~/.ssh
chmod 600 ~/.ssh/config

Erros comuns

"Permission denied": confira se o usuário e o endereço no bloco Host estão corretos, e se as permissões da pasta .ssh foram ajustadas como no Passo 5.
Alias não reconhecido: verifique se não há espaço ou erro de digitação no nome depois de Host, e se o arquivo foi salvo no caminho certo (~/.ssh/config).
Conexão recusada: confirme a porta e o endereço com os dados fornecidos na sua hospedagem — em caso de dúvida, consulte o painel ou o suporte.

Ficou com alguma dúvida sobre seus dados de acesso SSH? Dá uma olhadinha no seu painel em painel.gehost.com.br ou chama a gente no suporte — estamos aqui pra ajudar! 💚

Como configurar múltiplos aliases de conexão SSH no arquivo config local