sshControl é um gerenciador de conexões SSH em um único binário. Você escolhe o host num menu,
passa por jump hosts, roda comandos em dezenas de máquinas de uma vez, copia arquivos
e abre túneis. Tudo a partir de um config.yaml.
$ curl -fsSL https://sshcontrol.alexeiev.me/install | bash
$ sc -j 1 -c "uptime" -l @web @production 🏷️ Tags: web, production 🚀 Executando comando em 3 host(s): uptime via Jump Host: production-jump (ubuntu@jump.prod:22) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ Host: web1 (Exit Code: 0) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 14:02:11 up 41 days, load average: 0.08, 0.11 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ Host: web2 (Exit Code: 0) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 14:02:11 up 41 days, load average: 0.21, 0.17 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ❌ Host: web3 (Exit Code: -1) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Erro: erro ao conectar: i/o timeout ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📊 Resumo: 2 sucesso(s), 1 falha(s), 3 total | ⏱️ Tempo: 1.42s $
Sem argumentos, o sc abre um menu com seus hosts. Com um nome, IP ou
user@host:porta, conecta na hora com uma sessão interativa completa,
que acompanha o redimensionamento do terminal.
Navegue pelas setas, tecle / para filtrar por nome, IP ou tag e
Enter para conectar. Vários termos se combinam:
@web @production mostra apenas quem tem as duas tags.
O cabeçalho mostra o usuário, o jump host e o proxy ativos, e muda conforme
-u, -j e -p.
Filtro: @web @production │ web1 │ 10.0.1.11 [web, production] web2 10.0.1.12 [web, production, nginx] web3 10.0.1.13 [web, production]
Use um host do config ou qualquer endereço. Com auto_create: true,
endereços novos são salvos no config com a tag autocreated após a primeira conexão.
Usuários e jump hosts são escolhidos por nome ou pelo índice que aparece no
sc -s: -u1, -j 2.
$ sc webserver $ sc 192.168.1.50 $ sc ubuntu@192.168.1.50:2222 $ sc -u deploy -j production-jump webserver $ sc -u1 -j 1 webserver # por índice $ sc -s # lista tudo $ sc -s @users # só usuários
Com -c, o sc executa o comando no host e sai:
sc -c "uptime" webserver. Com -l, o comando roda em todos os
hosts ao mesmo tempo. A saída de cada um vem separada, com o código de saída, e no final
aparece um resumo com sucessos, falhas e o tempo total.
O grupo @webservers tem três máquinas cadastradas no config.
Com -l @webservers, o comando roda nas três ao mesmo tempo.
Os resultados aparecem na ordem em que cada host termina, não na ordem do config.
# ~/.sshControl/config.yaml hosts: - name: webserver01 host: 10.10.0.200 port: 22 tags: [webservers] - name: webserver02 host: 10.10.0.201 port: 22 tags: [webservers] - name: webserver03 host: 10.10.0.202 port: 22 tags: [webservers]
$ sc -c 'date; uptime' -l @webservers 🏷️ Tags: webservers 🚀 Executando comando em 3 host(s): date; uptime ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ Host: webserver02 (Exit Code: 0) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Tue Sep 22 14:02:11 UTC 2026 14:02:11 up 63 days, 4:27, 0 users, load average: 0.12, 0.09, 0.08 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ Host: webserver01 (Exit Code: 0) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Tue Sep 22 14:02:11 UTC 2026 14:02:11 up 41 days, 3:12, 0 users, load average: 0.08, 0.11, 0.09 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ Host: webserver03 (Exit Code: 0) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Tue Sep 22 14:02:12 UTC 2026 14:02:12 up 12 days, 22:05, 0 users, load average: 0.31, 0.27, 0.22 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📊 Resumo: 3 sucesso(s), 0 falha(s), 3 total | ⏱️ Tempo: 0.84s ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ $
Hosts podem ter várias tags. Quando você informa mais de uma, só entram os hosts que têm todas. Hosts passados pelo nome ou IP entram sempre.
A regra vale para -s, -l, sc cp up -l,
para arquivos de lista e para o filtro da TUI.
| Host | Tags | Resultado |
|---|---|---|
| web1 | webproduction | Entra |
| web2 | webproductionnginx | Entra |
| staging-web | webstaging | Fica fora |
| database | dbproduction | Fica fora |
Apenas web1 e web2 têm as duas tags.
O -l aceita nomes do config, IPs, user@host:porta, tags
e arquivos texto. No arquivo, os hosts podem vir um por linha ou separados por
vírgula ou ponto e vírgula, e também podem ser tags.
$ sc -c "df -h" -l web1 web2 192.168.1.50 $ sc -c "uptime" -l @web $ sc -c "hostname" -l @production server1 $ sc -c "uptime" -l lista.txt @web $ sc -j 1 -u admin -c "systemctl status nginx" -l @web
O sshControl tem três formas de túnel sobre SSH. Todas funcionam através de jump hosts e com as mesmas opções de usuário e senha.
sc tunnel, proxy SOCKS5 v1.0
Abre uma conexão com o jump host e cria um proxy SOCKS5 em
localhost:4000. Aponte o navegador para ele e acesse painéis e APIs da
rede interna. Os nomes de domínio são resolvidos no jump host.
Roda em background por padrão. Use -v para acompanhar o tráfego em
foreground. A porta segue --port, depois local_port_socks, depois 4000.
Se o jump host só é alcançável por outro equipamento (uma VPN em outra máquina, por exemplo),
configure routes.gateway e routes.networks. O sc cria as rotas via
sudo antes de abrir o tunnel e as remove no stop.
$ sc tunnel -j 1 # background, SOCKS5 em localhost:4000 $ sc tunnel -j production-jump --port 5000 $ sc tunnel -j 1 -v # foreground mostrando o tráfego $ sc tunnel status # tunnels ativos e rotas pendentes $ sc tunnel stop -j 1 # ou sem -j para encerrar todos
Traz uma porta remota para a sua máquina, como o ssh -L. Cada conexão
aparece no log com origem e bytes transferidos. O Ctrl+C mostra as estatísticas da sessão.
$ sc port-forward db-server 3307:3306 $ sc port-forward -j 1 db-prod 5433:5432
O caminho contrário: o host remoto usa o proxy HTTP da sua rede. Configure
proxy e proxy_port e conecte com -p.
$ sc -j 1 -p app-server # no host remoto: export {https,http,ftp}_proxy=http://127.0.0.1:9999
sc cp down baixa arquivos para o dir_cp_default ou para o
destino informado. sc cp up envia para um host ou, com -l,
para vários em paralelo, aceitando tags e arquivos de lista. Use -r para
copiar diretórios e ~ para a home remota.
# download $ sc cp down webserver /var/log/app.log $ sc cp down -r webserver /etc/nginx/ ./nginx-backup/ $ sc cp down -j 1 db-prod /backup/dump.sql ./ # upload $ sc cp up ./config.yaml /etc/app/ webserver $ sc cp up -r ./dist/ /var/www/html/ webserver $ sc cp up -l @web ./deploy.sh /opt/ $ sc cp up -l app1 app2 -j prod-jump ./app.jar /opt/app/
Cada conexão tenta as formas de autenticação nesta ordem e para na primeira que funciona. Quando a senha resolve, sua chave pública é instalada no servidor via SFTP, e a próxima conexão já entra pela chave.
-a ou -Pauthorized_keys do servidor-a Pedir a senha antesPede a senha uma vez, antes de conectar. Em -l, a mesma senha vale para todos os hosts.
-P Senha por variável de ambienteLê a senha de SCPW, sem prompt. Serve para CI/CD e scripts, e tem precedência sobre -a.
-v Modo debugMostra os métodos de autenticação, o status de cada chave, o caminho via jump host e o PTY. Tudo vai para o stderr.
Valida servidores e jump hosts em ~/.ssh/known_hosts. Aceita e cadastra automaticamente a chave de um servidor novo, inclusive em lotes e tunnels em background.
Chaves divergentes bloqueiam a conexão. Após conferir o fingerprint, use -i, --ignore-host-key para continuar somente naquela execução, com aviso e sem substituir o cadastro, ou remova a entrada antiga para cadastrar a nova chave na próxima conexão. Chaves revogadas continuam bloqueadas.
Se o arquivo escolhido não existir, o sc cria seus diretórios e um template comentado. A cada nova versão,
as chaves que faltam no seu config são adicionadas com os valores padrão e comentários,
sem mexer no que já existe.
O sc update busca a última release no GitHub, mostra as novidades e
substitui o binário, guardando um backup do anterior.
config: default_user: ubuntu auto_create: false dir_cp_default: ~/sshControl proxy: "192.168.0.1:3128" proxy_port: 9999 users: - name: ubuntu ssh_keys: [~/.ssh/id_ed25519, ~/.ssh/id_rsa] jump_hosts: - name: production-jump host: jump.production.example.com user: ubuntu port: 22 local_port_socks: 4000 # sc tunnel routes: # opcional gateway: "192.168.0.10" networks: ["10.20.0.0/16"] hosts: - name: webserver host: 192.168.1.50 port: 22 tags: [web, production]
Defina SCCONFIG para escolher outro arquivo YAML em todos os comandos.
Se a variável estiver ausente ou vazia, o sc usa ~/.sshControl/config.yaml.
Caminhos relativos e iniciados por ~/ também são aceitos.
A migração e o salvamento de hosts com auto_create usam o arquivo escolhido.
Erros ao acessar o caminho informado são exibidos sem recorrer ao config padrão.
Os logs e o estado dos tunnels continuam em ~/.sshControl/tunnels,
independentemente de SCCONFIG.
# Use outro arquivo nas próximas execuções $ export SCCONFIG=/diretorio-local/config.yaml $ sc -s # Escolha um arquivo só para este comando $ SCCONFIG=/diretorio-local/producao.yaml sc -s # Volte ao arquivo padrão $ unset SCCONFIG
| Opção | O que faz |
|---|---|
| Flags | |
| -u, --user <nome|índice> | Usuário do config a usar |
| -j, --jump <nome|índice> | Conecta através de um jump host |
| -c, --command "…" | Executa um comando remoto e sai |
| -l, --list | Vários hosts: nomes, IPs, @tags e arquivos texto |
| -s, --servers [@tag…] | Lista usuários, jump hosts e servidores (@users mostra só os usuários) |
| -p, --proxy | Proxy reverso para o host remoto |
| -a, --ask-password | Pede a senha antes de conectar |
| -P, --env-password | Usa a senha da variável SCPW |
| -i, --ignore-host-key | Permite chave SSH divergente nesta execução, com aviso e sem alterar known_hosts |
| -v, --verbose | Modo debug (no tunnel, roda em foreground) |
| -V, --version | Versão, data do build e commit |
| Variáveis de ambiente | |
| SCCONFIG <caminho> | Arquivo YAML prioritário; ausente ou vazia, usa ~/.sshControl/config.yaml |
| Subcomandos | |
| sc tunnel -j <jump> | Proxy SOCKS5 local via jump host (status, stop) |
| sc port-forward <host> L:R | Encaminha uma porta local para uma porta remota |
| sc cp down | up | Transfere arquivos via SFTP (-r, -l) |
| sc update | Atualiza para a última release |
| sc man | Manual completo com exemplos |
Detecta o sistema e a arquitetura, baixa a última release e instala em /usr/local/bin.
$ curl -fsSL https://sshcontrol.alexeiev.me/install | bash
Use --dir para instalar sem sudo, por exemplo em ~/.local/bin.
$ curl -fsSL https://sshcontrol.alexeiev.me/install | bash -s -- --dir=$HOME/.local/bin
Requer Go. O make build grava a versão e o commit no binário.
$ git clone https://github.com/alexeiev/sshControl.git
$ cd sshControl
$ make build