Voltar às atualizações
New releaseAug 20, 2026

sshroute v0.2.11

Roteador SSH consciente da rede - roteia conexões para diferentes IPs/portas/chaves/hosts de salto com base na VPN ou rede ativa

Compartilhar

sshroute

CI Código OpenSpec Segurança
CI
Release
OpenSpec Badge
Scorecard
Latest Release
codecov
Go Report Card
Go Reference
Specs
Requirements
Tasks
Open Changes
OpenSSF Scorecard
CII Best Practices
License: Apache 2.0

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.

Como funciona

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

Por que sshroute?

Para homelabbers

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.

Para ambientes corporativos

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.

Como se compara

Recurso~/.ssh/configApenas WireGuardTeleport / Boundarysshroute
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.

Instalação

Download do binário

Baixe a versão mais recente em GitHub Releases. Binários estão disponíveis para Linux, macOS e Android em AMD64 e ARM64.

Instalação via Go

go install github.com/thereisnotime/sshroute@latest

Android (Termux)

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:

Categorias