A maioria das redes de produção coloca um único gateway na frente de tudo. Um bastion, um host de salto, uma jump box — uma máquina que aceita SSH do mundo externo, com os servidores que de fato importam para você numa rede privada atrás dela, sem endereço público próprio. A questão é como atravessar esse gateway até a máquina de trás sem fazer uma bagunça com as suas chaves. A resposta limpa é o ProxyJump.
O comando de SSH por host de salto, se é só isso que você veio buscar:
ssh -J user@jump-host user@target
Isso alcança o target através do jump-host, autenticando de ponta a ponta, sem que a sua chave jamais aterrisse no host de salto. O resto desta página é o porquê de essa única flag ser o jeito certo — e como torná-la permanente para você nunca mais digitá-la.
O padrão de host de salto, em resumo
Um host de salto — também chamado de bastion — é a única máquina exposta à internet, então é a única que vale endurecer; os servidores atrás dela não têm endereço público nenhum e não podem ser alcançados diretamente. É esse o projeto inteiro, e é bom — ele só quebra quando a forma como as pessoas atravessam o host de salto desfaz, em silêncio, a contenção. (A ideia é nova para você? O que é um host de salto? é a explicação completa.)
Há três formas comuns de passar. Duas delas fazem exatamente isso.
As duas formas erradas
Copiar a sua chave privada para o bastion. O mais tentador e o pior: scp da sua chave para lá, depois ssh adiante a partir do bastion. Agora a sua chave privada mora em uma máquina compartilhada e voltada para a internet que você não controla por completo — a máquina com maior probabilidade de ser comprometida. Se o bastion cai, a sua chave cai junto, o que anula a razão inteira de o bastion existir. Nunca, jamais, coloque chaves privadas em hosts de salto.
Encaminhar o seu agente (ssh -A). Melhor, porque a chave fica no seu notebook — mas isso expõe o socket do seu agente no bastion, onde qualquer um com root pode pegar a sua identidade emprestada enquanto a sua sessão estiver aberta. Tudo bem para uma máquina que é inteiramente sua, arriscado em um gateway compartilhado, que é exatamente o que um bastion é. A versão completa desse argumento está em o encaminhamento do agente é conveniente e perigoso (em inglês).
ProxyJump — a forma certa
O ProxyJump faz o que essas duas tentam alcançar às cegas, sem a desvantagem:
ssh -J bastion.example.com db.internal
Veja o que de fato acontece. O seu ssh abre uma conexão até o bastion, depois usa essa conexão puramente como transporte para abrir uma segunda conexão SSH direto até db.internal. A parte crucial: a autenticação com db.internal acontece de ponta a ponta, a partir do seu notebook. O bastion só transporta bytes criptografados de um lado para o outro — ele nunca vê a sua chave, o seu agente não fica exposto nele e ele não consegue ler a sessão interna. É um túnel, não um logar-e-relançar.
Então você ganha o alcance de passar pelo bastion, com a chave nunca deixando a sua máquina e nada que possa ser pego emprestado deixado para trás no gateway. É esse o ganho inteiro.
Mais de um salto
Redes reais às vezes aninham gateways. O ProxyJump encadeia — liste os saltos em ordem, separados por vírgula:
ssh -J bastion.example.com,jump2.internal db.deep.internal
Cada salto é tunelado pelo anterior, e a autenticação com o alvo final continua de ponta a ponta. Você pode empilhar quantos a topologia precisar.
Torne-o permanente no ssh_config
Digitar -J toda vez cansa, e o sentido de uma configuração salva é que o roteamento se torna invisível. Dê ao bastion a própria entrada, depois aponte os hosts internos para ele:
Host bastion
HostName bastion.example.com
User jump
Host db
HostName 10.0.0.9
User deploy
ProxyJump bastion
Agora ssh db roteia de forma transparente pelo bastion — sem flags para lembrar, e 10.0.0.9 é um endereço privado que o seu notebook nem consegue rotear diretamente. As configurações do próprio bastion (a chave dele, uma porta fora do padrão, keepalives) vivem no bloco dele e são reaproveitadas para todo host que salta por ele. Mais sobre estruturar o arquivo no guia do ssh_config (em inglês).
ProxyJump vs o antigo ProxyCommand
Se você já viu isso antes, provavelmente foi na forma mais antiga, usando o ProxyCommand com tunelamento no estilo netcat:
Host db
ProxyCommand ssh -W %h:%p bastion
O ProxyJump (OpenSSH 7.3, 2016) é a abreviação limpa para exatamente isso — -W %h:%p é o mesmo truque de “usar esta conexão como transporte”, embrulhado em uma única diretiva. O ProxyCommand ainda se justifica para casos que o -J não consegue expressar — o wrapper de um gerenciador de sessões de um provedor de nuvem, um binário connector personalizado — mas, para um host de salto simples, o ProxyJump é o que você quer.
Duas coisas para acertar
- O host de salto precisa ter a própria autenticação resolvida. O ProxyJump não faz o primeiro login desaparecer por mágica — o bastion ainda te autentica normalmente, com a própria chave ou entrada de agente. Um bloco
Hostsalvo para o bastion mantém isso organizado e reutilizável. - A verificação de chave de host acontece em cada salto. Você vai ser solicitado a confiar em cada novo host na primeira vez que o alcançar — o bastion e o alvo. Isso é um recurso, não um incômodo: é como o SSH prova que cada servidor é aquele que você pretendia. Aceite uma vez por host, de propósito, não por reflexo.
E uma distinção que vale manter clara: ProxyJump não é encaminhamento de portas. O ProxyJump leva o seu shell até um host atrás do bastion; o encaminhamento de portas (-L) traz a porta de um serviço do lado de lá até o seu localhost. Eles resolvem problemas diferentes e você costuma usar os dois — saltar até a máquina e encaminhar a porta do banco de dados dela de volta para o seu notebook.
Como o Termalin faz isso
O Termalin trata o host de salto como parte da configuração de um servidor salvo: anexe um bastion a um host, e conectar àquela máquina interna roteia pelo gateway automaticamente. A chave fica na sua máquina — nada é copiado para o bastion, nenhum socket de agente fica exposto lá — e a identidade do servidor em cada salto é verificada na primeira conexão, então você percebe se um host alguma vez mudar por baixo de você. A lista de hosts inteira, com os hosts de salto, as chaves e os keepalives, sincroniza entre as suas máquinas, criptografada de ponta a ponta, então a mesma máquina privada fica a um clique de distância onde quer que você esteja trabalhando. Um host de salto salvo funciona no app de desktop no Windows, no macOS e no Linux — configure o bastion uma vez em um host e nada na forma de alcançar a máquina por trás dele muda no dia a dia.
Resumindo
O bastion existe para ser a única máquina exposta, e todo o resto existe para ficar atrás dele. O ProxyJump respeita esse acordo: você alcança qualquer coisa do lado privado, e a sua chave nunca deixa o seu notebook para chegar lá.
O Termalin é um cliente SSH gratuito e multiplataforma, com suporte a host de salto, túneis integrados e um gerenciador de chaves — baixe o Termalin, ou veja como ele cuida das suas chaves com segurança.