lssh

ls + ssh = lssh

lssh é um conjunto de ferramentas de acesso remoto nativo do terminal para fluxos de trabalho SSH, inventários em nuvem e conectores baseados em provedores.

Ele permite selecionar hosts do arquivo de configuração do OpenSSH, do próprio config lssh ou de inventários de provedores, e então operá-los através de SSH nativo ou backends de conector, como AWS SSM, EC2 Instance Connect Endpoint, WinRM, Telnet e provedores personalizados.

Use-o para shells interativos, comandos paralelos, workspaces mux, transferência de arquivos, sincronização, montagem e monitoramento. Hosts baseados em conectores expõem apenas as operações suportadas por seu conector.

• funciona com sua configuração SSH existente
• seleção interativa de hosts
• execução paralela de comandos

Instalação

Homebrew

brew install blacknon/lssh/lssh

Go

go install github.com/blacknon/lssh/cmd/lssh@latest

Os recursos de inventário e conector baseados em provedores usam executáveis de provedor separados. Se você instalar apenas cmd/lssh, esses binários de provedor não são instalados automaticamente.

Para desenvolvimento local, instale os provedores incluídos com:

mise run provider_install

Para builds de lançamento, instale o arquivo all-in-one lssh-complete_* ou adicione o arquivo lssh-providers_* correspondente dos GitHub Releases.

Para mais detalhes de instalação, incluindo outras opções e notas específicas de plataforma, veja docs/install.md.

Início rápido

Já usa o ~/.ssh/config?

Basta executar:

lssh

Quer gerar um config lssh a partir do seu config SSH existente?

lssh --generate-lssh-conf > ~/.lssh.toml

Fluxo de trabalho básico

lssh é construído para um fluxo de trabalho simples:

1. listar hosts do config SSH
2. escolher um ou mais hosts
3. abrir um shell ou executar um comando

Exemplos

Você ainda pode direcionar um único host diretamente quando já souber onde conectar:

lssh -H my-server

Para mais detalhes sobre formatos de configuração e ajustes, veja cmd/lssh/README.md.

Demonstração

Quer testar o lssh rapidamente com um playground local pronto para uso? Comece por demo/README.md. Para o fluxo do conector telnet + provedor multi-hop, use demo-telnet-provider/README.md.

Configuração OpenSSH e configuração lssh

O lssh suporta tanto seu arquivo de configuração OpenSSH existente quanto seu próprio formato de configuração.

Se você quiser começar rapidamente, pode continuar usando o ~/.ssh/config como está. Se quiser metadados de host mais ricos e configurações orientadas a fluxo de trabalho, pode migrar para um config lssh.

Você também pode gerar um config lssh a partir do seu config SSH existente:

lssh --generate-lssh-conf > ~/.lssh.toml

Mesmo após migrar para o config lssh, você ainda pode apontá-lo para seu arquivo OpenSSH existente e carregar hosts de lá:

[sshconfig.default]
path = "~/.ssh/config"

Para mais detalhes sobre formatos de configuração e ajustes, veja docs/configuration.md.

Provedores

O lssh pode trabalhar com mais do que entradas estáticas de config SSH. Os provedores permitem buscar hosts de fontes externas de inventário, resolver segredos momentos antes da conexão e usar backends de conexão não-SSH, como conectores gerenciados em nuvem.

Na v0.10.0, os fluxos de trabalho de inventário e segredos baseados em provedores são melhor tratados como beta. O acesso baseado em conector além do SSH nativo ainda é experimental, especialmente para ambientes de execução gerenciados em nuvem e backends não-SSH.

Se quiser experimentar fluxos orientados a provedores localmente, comece por estas demonstrações:

• demo/README.md: SSH principal, cadeias de proxy e exemplos gerais de fluxo de trabalho multi-host
• demo-telnet-provider/README.md: fluxo do conector telnet gerenciado por provedor, incluindo acesso telnet direto e telnet atrás de um salto SSH duplo

Para a visão geral da arquitetura e protocolo dos provedores, comece por provider/README.md. Detalhes de categoria também são documentados em inventory, connector, secret e mixed.

Provedores incluídos

Estas implementações de provedor estão atualmente incluídas neste repositório.

Inventário (Inventory)

Conector (Connector)

Misto (Mixed)

Segredo (Secret)

Ferramentas do conjunto lssh

O projeto lssh inclui múltiplas ferramentas para fluxos de trabalho centrados em SSH.

Documentação

• docs/README.md: índice da documentação
• cmd/lssh/README.md: detalhes do comando lssh, encaminhamento e uso de rc local
• cmd/README.md: visão geral dos comandos
• CONTRIBUTING.md: diretrizes de desenvolvimento e contribuição

Projetos relacionados

• go-sshlib: Biblioteca Go para conexões SSH, execução de comandos e shells interativos
• tvxterm: tvxterm fornece widgets de terminal para tview
• boco: Bash Shell Function's Fuzzy Finder.

Alternativas

Se você está avaliando o lssh, estes projetos também merecem uma olhada. Eles se sobrepõem a partes do conjunto, mas cada um geralmente cobre uma fatia mais estreita do fluxo de trabalho geral.

Como o conjunto lssh é diferente

• lssh combina seleção de hosts, SSH interativo, execução paralela de comandos, encaminhamento e destinos baseados em conector/provedor.
• lsshell foca em fluxos de shell interativos paralelos em vez de apenas abrir vários terminais.
• lscp, lsftp e lssync cobrem transferência e sincronização de arquivos como comandos de primeira classe no mesmo conjunto.
• lsmux fornece um workspace SSH baseado em painéis em vez de apenas modelagem de sessões.
• lspipe mantém hosts selecionados reutilizáveis a partir de pipelines e automação locais.

Licença

MIT

Autor

blacknon