Ir para o conteúdo
Promovaweb

Acesse um serviço por túnel SSH

Revisado em

Antes de começar

Configure um túnel local para um serviço HTTP de estudo.

  • Termius instalado e acesso autorizado à infraestrutura.
  • VPS de estudo e console do provedor disponíveis.

Um túnel local permite alcançar pelo seu computador um serviço acessível a partir da VPS. Neste exemplo, um serviço HTTP de estudo já responde na porta 8080 do endereço 127.0.0.1 da VPS. No computador, você vai usar a porta 18080.

Confira o serviço e a conexão

Abra uma sessão SSH normal e confirme que o serviço está disponível no servidor. Se ele não responder a partir da VPS, o túnel também não conseguirá alcançá-lo. Confira com o responsável qual protocolo e porta o serviço usa.

Configure o encaminhamento local

No Termius, abra Port Forwarding e crie New Port Forwarding do tipo Local. Configure a interface de escuta local como 127.0.0.1 e a porta local como 18080. Selecione o host da VPS. Para o destino, informe 127.0.0.1 e porta 8080.

O endereço de destino é interpretado a partir do servidor SSH. Nesse exemplo, ele aponta para a própria VPS. A interface de escuta local restringe o acesso ao seu computador. Evite usar 0.0.0.0 para este exercício.

Inicie e encerre o acesso

Ative o encaminhamento e acesse http://127.0.0.1:18080 no navegador local. O resultado deve ser o serviço da VPS. Se o encaminhamento não iniciar, confira se a porta 18080 já está ocupada e escolha outra porta livre.

Ao terminar, pare o encaminhamento e confirme que o endereço local deixou de responder por esse túnel. Port forwarding depende da conexão SSH e das permissões configuradas no servidor. Não é necessário abrir a porta 8080 da VPS para toda a internet.

Separe os dois endereços de loopback

O endereço 127.0.0.1 sempre aponta para a própria máquina que o interpreta. No campo de escuta local, ele representa seu computador. No campo de destino do túnel, ele representa o servidor alcançado por SSH. Os números são iguais, mas as máquinas são diferentes.

Posição Endereço e porta Função no exercício
Navegador no computador 127.0.0.1:18080 Entrada do túnel
Conexão SSH Endereço e porta da sua VPS Transporte até o servidor
Serviço na VPS 127.0.0.1:8080 Destino que recebe a requisição

A porta local não precisa ser igual à remota. Usar 18080 no computador permite encaminhar para 8080 na VPS sem ocupar a porta 8080 local. Se outro programa já estiver usando 18080, escolha uma porta local livre e atualize o endereço do navegador.

Teste o serviço antes de testar o túnel

Se a VPS tiver curl instalado e o serviço do exercício usar HTTP, consulte no terminal remoto:

Terminal
curl -I http://127.0.0.1:8080

O comando solicita os cabeçalhos HTTP. Uma resposta HTTP mostra que houve comunicação com um serviço, embora uma resposta 4xx ou 5xx ainda possa indicar um problema da aplicação. Alguns serviços não aceitam a requisição HEAD usada por -I. Interprete o código retornado conforme o serviço que você está testando.

Se houver recusa de conexão, confira se o serviço está iniciado e se a porta está correta antes de modificar o túnel. Se funcionar na VPS, mas não no navegador local, confira a ativação do encaminhamento, a porta local e as permissões de port forwarding do servidor SSH.

Um túnel transporta a conexão, mas não converte protocolos. Para um serviço HTTPS, use o protocolo apropriado e confira o certificado apresentado. Não desative a verificação de certificados apenas para fazer o exercício responder.

Confira o resultado

O navegador acessa o serviço apenas enquanto o encaminhamento está ativo.

Fontes consultadas

Conteúdo conferido na documentação oficial. As ações no aplicativo e no servidor não foram executadas nesta revisão.