
Roteador SSH consciente da rede - roteia conexões para diferentes IPs/portas/chaves/hosts de salto com base na VPN ou rede ativa
| CI | Código | OpenSpec | Segurança |
|---|---|---|---|
|
|
|
|
|
Roteador SSH ciente da rede. Detecta sua rede ativa ou VPN e seleciona automaticamente o host, a porta, o arquivo de identidade e o jump host corretos para cada conexão SSH — sem tocar em ~/.ssh/config.
Defina cada host lógico uma única vez com um perfil default e substituições opcionais por rede. A cada conexão, o sshroute detecta em qual rede você está (VPN, LAN do escritório, peer WireGuard, etc.) e resolve os parâmetros SSH corretos antes de repassar ao /usr/bin/ssh real.
ssh myserver
→ sshroute detects: corp-vpn is active
→ resolves: 10.100.0.50:2222 via bastion.corp.internal
→ exec /usr/bin/ssh -p 2222 -i ~/.ssh/corp_key -J bastion.corp.internal 10.100.0.50
Seu lab provavelmente tem pelo menos duas realidades: você está sentado em casa na LAN, ou está fora e entrando via WireGuard ou outra VPN. O problema é que o ~/.ssh/config não sabe em qual delas você está — então você acaba com aliases separados (server-lan, server-vpn), ou um jump host que só funciona metade das vezes, ou simplesmente memoriza IPs.
O sshroute resolve isso detectando sua rede atual antes de cada conexão. Quando a interface WireGuard está ativa e a rota do peer existe, ele conecta diretamente ao IP do túnel. Quando você está na LAN, ele usa o endereço local. Quando nenhum dos dois está acessível, ele recorre ao hostname público. Um alias, três realidades, zero troca manual.
Ele também intercepta o SSH de forma transparente — git push, rsync, scp passam por ele automaticamente depois que você configura o shadow mode. Sem wrappers, sem funções de shell, sem precisar pensar.
Redes corporativas são piores. Você tem a internet pública, talvez uma VPN site-to-site, talvez uma VPN pessoal split-tunnel, e dentro disso você tem jump hosts diferentes dependendo do ambiente que está acessando — dev, staging, prod, cada um com seu próprio bastion e chave. Manter isso organizado no ~/.ssh/config significa ou um config enorme que quebra sempre que a infraestrutura muda, ou um script que cada pessoa do time mantém de forma diferente.
O sshroute permite definir a lógica de roteamento de forma declarativa, mantê-la em um arquivo YAML versionado e compartilhá-la com o time. O mesmo config funciona para todos — a rede correta é detectada automaticamente com base em quais interfaces ou rotas estão ativas em cada máquina. Chaves, portas, usuários e jump hosts são resolvidos sem que o usuário precise pensar nisso.
| Recurso | ~/.ssh/config | Apenas WireGuard | Teleport / Boundary | sshroute |
|---|---|---|---|---|
| Detecta sua rede atual | ❌ | ❌ | ❌ | ✅ |
| Escolhe o melhor caminho automaticamente | ❌ | ❌ | ❌ | ✅ |
| Recorre a alternativa em caso de falha de conexão | ❌ | ❌ | ✅ | ✅ |
| Reconexão automática + re-roteamento em queda | ❌ | ⚠️ túnel roaming | ⚠️ via proxy fixo | ✅ |
| Um comando por host, em qualquer local | ❌ | ⚠️ VPN precisa estar ativa | ✅ | ✅ |
| Tamanho do config para 10 hosts × 4 caminhos | 📄 ~600 linhas | 📄 ~600 linhas + config de VPN | 📄 config no lado do servidor | 📄 ~60 linhas |
| Dispositivos móveis em roaming | ⚠️ aliases manuais | ⚠️ VPN necessária | ✅ | ✅ |
| Encadeamento automático de jump host | ⚠️ -J manual | ➖ n/a | ✅ | ✅ |
| Funciona com scp / rsync / git / Ansible | ✅ | ✅ | ⚠️ parcial | ✅ |
| Sem instalação no lado do servidor nos alvos | ✅ | ❌ | ❌ | ✅ |
| Sem servidor de autenticação ou daemon para executar | ✅ | ❌ | ❌ | ✅ |
| Sem agente no cliente | ✅ | ❌ | ❌ | ✅ |
| Código aberto, totalmente auto-hospedado | ✅ | ✅ | ⚠️ open-core | ✅ |
Teleport e Boundary são uma categoria diferente — eles adicionam controle de acesso, logs de auditoria e autenticação baseada em certificados por cima do roteamento. Se é disso que você precisa, use-os. O sshroute é para quando você quer a inteligência de roteamento sem a sobrecarga operacional de executar um servidor de autenticação central.
Baixe a versão mais recente em GitHub Releases. Binários estão disponíveis para Linux, macOS e Android em AMD64 e ARM64.
go install github.com/thereisnotime/sshroute@latest
Baixe o tarball android_arm64 em GitHub Releases, extraia e coloque o binário em ~/.local/bin:
mkdir -p ~/.local/bin
curl -Lo "$TMPDIR/sshroute.tar.gz" \
https://github.com/thereisnotime/sshroute/releases/latest/download/sshroute_android_arm64.tar.gz
tar -xzf "$TMPDIR/sshroute.tar.gz" -C ~/.local/bin sshroute
chmod +x ~/.local/bin/sshroute
Adicione ~/.local/bin ao seu PATH em ~/.bashrc ou ~/.profile, caso ainda não esteja: