termal.in

← Blog

Conecte-se a um banco de dados atrás de um firewall — por um túnel SSH, sem expor a porta

· Termalin Team sshport-forwardingdatabasetunnelingsecurity

Você tem um banco de dados em um servidor em algum lugar, e quer alcançá-lo do seu notebook — rodar uma query, apontar uma GUI para ele, deixar uma ferramenta de migração conectar. Ele escuta na 5432 (Postgres) ou na 3306 (MySQL) e, agora, o seu notebook não consegue chegar nele, porque o banco está em uma rede privada sem rota a partir de fora. Então você sai atrás da ponte mais rápida, e a internet oferece um atalho que funciona na hora e, silenciosamente, custa a você justamente o que a rede privada estava protegendo.

O erro: abrir a porta do banco para o mundo

O atalho é tornar o banco alcançável: faça-o escutar em 0.0.0.0 em vez de 127.0.0.1, abra um buraco no security group para a porta 5432, e pronto, você consegue conectar de qualquer lugar. Funciona de primeira, que é exatamente por que é perigoso.

Uma porta de banco de dados na internet pública é um alvo permanente. O Postgres e o MySQL falam em portas bem conhecidas, e a internet inteira é varrida atrás delas continuamente — um serviço escutando na 5432 começa a juntar tentativas de login minutos depois de subir. A única coisa entre a internet e os seus dados passa a ser a senha do próprio banco, uma peculiaridade de protocolo ou uma CVE. Bancos gerenciados não deixam você fazer isso por acidente: o RDS, o Cloud SQL e os demais vêm por padrão em uma sub-rede privada, sem IP público, justamente porque um banco de dados é a última coisa que você quer de cara para a internet. Abri-lo mesmo assim — uma regra 0.0.0.0/0 “só por enquanto” — troca todo o projeto por alguns minutos economizados. A correção custa quase o mesmo e não abre mão de nada.

O que um túnel SSH para um banco de dados realmente faz

Você quase com certeza já tem um jeito de entrar nessa rede: um login SSH em um servidor que consegue enxergar o banco — o servidor de aplicação, um bastion, qualquer máquina na mesma sub-rede. O encaminhamento de portas do SSH deixa você pegar esse alcance emprestado sem expor nada novo.

ssh -L 5432:db.internal:5432 deploy@bastion.example.com

Leia da esquerda para a direita: abra a porta 5432 no meu notebook e encaminhe tudo que chegar ali para db.internal:5432 conforme resolvido a partir do bastion. Depois você aponta o seu cliente para localhost:

psql -h 127.0.0.1 -p 5432 -U app appdb

O psql conecta na sua própria máquina; o SSH carrega os bytes, criptografados, pela conexão que você já tinha; o bastion abre uma conexão comum para db.internal de dentro da rede privada, onde isso é permitido. Do ponto de vista do banco, nada mudou — ele continua aceitando conexões apenas da sua própria rede. E nenhuma porta nova foi aberta em lugar nenhum da internet. Você ganhou alcançabilidade sem exposição.

O único detalhe que pega todo mundo: db.internal é resolvido do outro lado, pelo bastion, não pelo seu notebook. Pode ser um nome que só a rede privada conhece, ou um endereço cru para o qual o seu notebook não tem rota:

# o banco que só o bastion enxerga, por IP privado
ssh -L 5432:10.0.0.9:5432 deploy@bastion.example.com

É esse o truque inteiro, coberto em profundidade — local, remoto e dinâmico — em encaminhamento de portas SSH explicado. Aqui só precisamos do caso local (-L).

O bastion é onde o túnel começa

A máquina pela qual você faz o túnel costuma ser o mesmo gateway pelo qual você já salta para conseguir um shell na rede privada. Se você alcança os seus servidores internos com ProxyJump, já tem a peça de que um túnel de banco de dados precisa. Os dois são complementares: o ProxyJump leva o seu shell até um host atrás do gateway, e o -L traz a porta de um serviço do outro lado de volta para o seu localhost. Se você tiver que pular por dois gateways, encadeie-os:

ssh -J bastion.example.com -L 5432:db.internal:5432 deploy@app.internal

Por que as pessoas ainda erram o túnel

O mecanismo é limpo. O dia a dia de rodar túneis na mão é onde a coisa se desgasta:

  • O comando apodrece no histórico do shell. Na semana seguinte você está reconstruindo qual porta local mapeava para qual banco, em qual bastion, em qual ambiente. Staging e produção querem os dois a 5432; você consegue um de cada vez no seu notebook.
  • A porta local fica aberta para todo processo na sua máquina. O -L 5432 escuta em 127.0.0.1:5432 — qualquer programa no seu notebook agora consegue alcançar o banco de produção por ela, sem exigir autenticação SSH, enquanto o túnel estiver de pé. (E o -L 0.0.0.0:5432:... silenciosamente o expõe para toda a sua LAN.)
  • O túnel morre no meio da sessão e leva a query junto. Um notebook que dorme, uma troca de Wi-Fi, um timeout de ociosidade, e o encaminhamento cai em silêncio — normalmente resolvido com -N, -f e ServerAliveInterval 30, nada do que você lembrou na primeira vez.
  • Um ssh -L por banco. Um primário, uma réplica de leitura, uma máquina MySQL, um Redis — são quatro comandos de túnel em quatro portas locais, cada um rodado de novo depois de toda desconexão, nenhum dizendo de relance se ainda está de pé.

Um bloco salvo no ssh_config — LocalForward, um ProxyJump, keepalives — suaviza a maior parte disso. Mas você ainda está iniciando na mão, ainda vigiando, ainda apontando o seu cliente para a porta de loopback certa por conta própria.

Como o cliente de banco de dados do Termalin faz isso

O Termalin é um cliente SSH multiplataforma que ganhou há pouco um cliente de banco de dados — no app de desktop e no painel web em termal.in/account. Você adiciona um banco do mesmo jeito que adicionaria um servidor: escolha o engine, dê a ele um host, uma porta e credenciais, opcionalmente um banco padrão. Ele fala uma gama ampla de engines — PostgreSQL, MySQL, SQL Server, ClickHouse, MongoDB, Redis, Elasticsearch, Neo4j e mais. A parte de que este artigo trata é o que acontece quando esse banco está atrás de um firewall — você não abre uma porta e não roda ssh -L na mão:

  • Um banco em uma rede para a qual você já tem rota, você alcança direto. O Termalin disca o host e a porta que você informou.
  • Um banco atrás de um firewall, você alcança por um túnel. No desktop, anexe à conexão um host SSH salvo — o seu bastion, host de salto e tudo; o Termalin abre um encaminhamento local naquela sessão e aponta o driver para o 127.0.0.1:<port> resultante por você, então um banco que só escuta em localhost ou fica atrás de uma VPN chega como se fosse local. No painel web, o mesmo trabalho é feito por um Connector: o Termalin abre a sessão SSH do Connector, encaminha uma porta de loopback por ela e roda a query por ali. De um jeito ou de outro, a sessão SSH criptografada carrega o tráfego até uma máquina que enxerga o banco, e o próprio banco nunca fica de cara para a internet.

Assim você mantém o que a sub-rede privada estava ali para dar — um banco alcançável apenas de dentro da sua própria rede — enquanto ganha um editor de queries funcional no seu notebook. O túnel sobe com a conexão e cai quando você a fecha, junto com a porta de loopback que ele abriu. Não há comando para lembrar, nem encaminhamento para ficar babá, nem regra 0.0.0.0/0 esquecida em um security group.

Um túnel é alcançabilidade, não autorização

Vale dizer com clareza, porque é a única coisa que um túnel não faz: levar a conexão até o banco não é o mesmo que decidir o que ela pode fazer quando chega lá. Um túnel é um fio, e um fio é neutro — quem está do outro lado ainda conecta como o usuário de banco de dados que você entregou. Aponte a conexão para um papel de menor privilégio e, se um agente for ficar do outro lado dela, mantenha isso como uma decisão à parte — o assunto de dar a um agente de IA acesso somente leitura ao banco de dados (em inglês), não deste texto.

Onde o Termalin se encaixa

Todo desenvolvedor deveria saber ssh -L de cor — é o jeito honesto de alcançar um banco sem abri-lo para o mundo, e o modelo mental (abrir uma porta do meu lado, encaminhá-la para algo que o outro lado enxerga) é o jogo inteiro. O atrito nunca foi o conceito; foi a burocracia: os comandos no seu histórico, as portas que você faz malabarismo, os túneis que caem, o um encaminhamento por banco.

O Termalin mantém o túnel e a conexão de banco de dados como uma coisa só, salva. Anexe um host de salto ou um Connector, e alcançar um banco em uma sub-rede privada é um clique — o encaminhamento abre com a conexão, o driver aponta para a porta de loopback por você, e o banco fica exatamente onde deve: atrás do firewall, escutando apenas a sua própria rede.


O Termalin é um cliente SSH e de banco de dados gratuito e multiplataforma, com túneis, hosts de salto e um cliente de dados integrados — baixe o app, ou veja como ele lida com as suas chaves e credenciais com segurança.

Experimente em um host.

Termalin é um cliente SSH rápido para você — e para seus agentes.

Plano gratuito · 14 dias de Pro grátis · preços

Adicionar o Termalin como fonte preferida no Google