lssh

ls + ssh = lssh

lssh è una suite di accesso remoto nativa per il terminale, progettata per flussi di lavoro SSH, inventari cloud e connettori basati su provider.

Permette di selezionare host dal file di configurazione OpenSSH, dalla configurazione di lssh o da inventari di provider, e di operare su di essi tramite SSH nativo o backend connettori come AWS SSM, EC2 Instance Connect Endpoint, WinRM, Telnet e provider personalizzati.

Usalo per shell interattive, comandi paralleli, ambienti di lavoro mux, trasferimento file, sincronizzazione, mount e monitoraggio. Gli host supportati dai connettori espongono solo le operazioni supportate dal rispettivo connettore.

• funziona con la tua configurazione SSH esistente
• selezione interattiva degli host
• esecuzione parallela di comandi

Installazione

Homebrew

brew install blacknon/lssh/lssh

Go

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

Le funzionalità di inventario e connettore basate su provider utilizzano eseguibili provider separati. Se installi solo cmd/lssh, questi binari provider non vengono installati automaticamente.

Per lo sviluppo locale, installa i provider inclusi con:

mise run provider_install

Per le build di rilascio, installa l'archivio lssh-complete_* tutto-in-uno o aggiungi l'archivio lssh-providers_* corrispondente dalle GitHub Releases.

Per maggiori dettagli sull'installazione, incluse altre opzioni e note specifiche per piattaforma, consulta docs/install.md.

Avvio rapido

Usi già ~/.ssh/config?

Basta eseguire:

lssh

Vuoi generare una configurazione lssh dalla tua configurazione SSH esistente?

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

Flusso di lavoro base

lssh è pensato per un flusso di lavoro semplice:

1. elencare gli host dalla configurazione SSH
2. scegliere uno o più host
3. aprire una shell o eseguire un comando

Esempi

Puoi comunque collegarti direttamente a un singolo host quando sai già dove connetterti:

lssh -H my-server

Per maggiori dettagli sui formati di configurazione e le impostazioni, consulta cmd/lssh/README.md.

Demo

Vuoi provare lssh rapidamente con un playground locale pronto all'uso? Inizia con demo/README.md. Per il flusso con connettore telnet e provider multi-hop, usa demo-telnet-provider/README.md.

Configurazione OpenSSH e configurazione lssh

lssh supporta sia la tua configurazione OpenSSH esistente che il proprio formato di configurazione.

Se vuoi iniziare velocemente, puoi continuare a usare ~/.ssh/config così com'è. Se desideri metadati host più ricchi e impostazioni orientate al flusso di lavoro, puoi passare invece a una configurazione lssh.

Puoi anche generare una configurazione lssh dalla tua configurazione SSH esistente:

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

Anche dopo essere passati alla configurazione lssh, puoi continuare a puntarla verso la tua configurazione OpenSSH esistente e caricare gli host da lì:

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

Per maggiori dettagli sui formati di configurazione e le impostazioni, consulta docs/configuration.md.

Provider

lssh può funzionare con più che semplici voci di configurazione SSH statiche. I provider permettono di estrarre host da fonti di inventario esterne, risolvere segreti appena prima della connessione e utilizzare backend di connessione non-SSH come connettori gestiti dal cloud.

In v0.10.0, i flussi di lavoro di inventario e segreti basati su provider sono da considerarsi in beta. L'accesso basato su connettori oltre lo SSH nativo è ancora sperimentale, specialmente per runtime gestiti dal cloud e backend non-SSH.

Se vuoi provare i flussi orientati ai provider localmente, inizia da queste demo:

• demo/README.md: SSH core, catene proxy ed esempi generali di flussi multi-host
• demo-telnet-provider/README.md: flusso del connettore telnet gestito dal provider, incluso l'accesso telnet diretto e telnet dietro un doppio hop SSH

Per una panoramica dell'architettura e del protocollo dei provider, inizia con provider/README.md. I dettagli delle categorie sono documentati anche in inventory, connector, secret e mixed.

Provider inclusi

Queste implementazioni di provider sono attualmente incluse in questo repository.

Inventario

Connettore

Misti

Segreto

Strumenti della suite lssh

Il progetto lssh include diversi strumenti per flussi di lavoro incentrati su SSH.

Documentazione

• docs/README.md: indice della documentazione
• cmd/lssh/README.md: dettagli del comando lssh, inoltro e utilizzo di rc locale
• cmd/README.md: panoramica dei comandi
• CONTRIBUTING.md: linee guida per sviluppo e contributi

Progetti correlati

• go-sshlib: libreria Go per connessioni SSH, esecuzione comandi e shell interattive
• tvxterm: tvxterm fornisce widget per terminale per tview
• boco: Fuzzy Finder per funzioni Shell Bash.

Alternative

Se stai valutando lssh, vale la pena dare un'occhiata anche a questi progetti. Si sovrappongono a parti della suite, ma di solito ciascuno copre una fetta più ristretta del flusso di lavoro complessivo.

In cosa la suite lssh è diversa

• lssh combina selezione host, SSH interattivo, esecuzione parallela di comandi, inoltro e destinazioni basate su connettore/provider.
• lsshell si concentra su flussi di lavoro di shell interattivi paralleli invece di lanciare semplicemente molti terminali.
• lscp, lsftp e lssync coprono il trasferimento file e la sincronizzazione come comandi di prima classe nella stessa suite.
• lsmux fornisce un'area di lavoro SSH basata su pannelli anziché solo modelli di sessione.
• lspipe mantiene gli host selezionati riutilizzabili da pipeline locali e automazione.

Licenza

MIT

Autore

blacknon