lssh

ls + ssh = lssh

lssh est une suite d'accès à distance native en terminal pour les workflows SSH, les inventaires cloud et les connecteurs basés sur des fournisseurs.

Il vous permet de sélectionner des hôtes depuis la configuration OpenSSH, la configuration lssh, ou des inventaires de fournisseurs, puis de les opérer via SSH natif ou des backends de connecteurs tels que AWS SSM, EC2 Instance Connect Endpoint, WinRM, Telnet, et des fournisseurs personnalisés.

Utilisez-le pour des shells interactifs, des commandes parallèles, des espaces de travail mux, le transfert de fichiers, la synchronisation, le montage et la supervision. Les hôtes basés sur des connecteurs n'exposent que les opérations que leur connecteur supporte.

• fonctionne avec votre configuration SSH existante
• sélection interactive d'hôtes
• exécution de commandes en parallèle

Installation

Homebrew

brew install blacknon/lssh/lssh

Go

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

Les fonctionnalités d'inventaire et de connecteur basées sur des fournisseurs utilisent des exécutables de fournisseurs séparés. Si vous installez seulement cmd/lssh, ces binaires de fournisseurs ne sont pas installés automatiquement.

Pour le développement local, installez les fournisseurs inclus avec :

mise run provider_install

Pour les builds de release, installez soit l'archive tout-en-un lssh-complete_*, soit ajoutez l'archive correspondante lssh-providers_* depuis GitHub Releases.

Pour plus de détails d'installation, y compris d'autres options et des notes spécifiques à la plateforme, voir docs/install.md.

Démarrage rapide

Vous utilisez déjà ~/.ssh/config ?

Exécutez simplement :

lssh

Vous souhaitez générer une configuration lssh à partir de votre configuration SSH existante ?

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

Workflow de base

lssh est conçu pour un workflow simple :

1. lister les hôtes depuis la configuration SSH
2. sélectionner un ou plusieurs hôtes
3. ouvrir un shell ou exécuter une commande

Exemples

Vous pouvez toujours cibler un seul hôte directement lorsque vous savez déjà où vous connecter :

lssh -H my-server

Pour plus de détails sur les formats de configuration et les paramètres, voir cmd/lssh/README.md.

Démo

Vous voulez essayer lssh rapidement avec un environnement de jeu local prêt à l'emploi ? Commencez par demo/README.md. Pour le flux connecteur telnet + fournisseur multi-saut, utilisez demo-telnet-provider/README.md.

Configuration OpenSSH et configuration lssh

lssh prend en charge à la fois votre configuration OpenSSH existante et son propre format de configuration.

Si vous voulez commencer rapidement, vous pouvez continuer à utiliser ~/.ssh/config tel quel. Si vous voulez des métadonnées d'hôte plus riches et des paramètres orientés workflow, vous pouvez plutôt passer à une configuration lssh.

Vous pouvez également générer une configuration lssh à partir de votre configuration SSH existante :

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

Même après être passé à la configuration lssh, vous pouvez toujours la pointer vers votre configuration OpenSSH existante et charger les hôtes depuis celle-ci :

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

Pour plus de détails sur les formats de configuration et les paramètres, voir docs/configuration.md.

Fournisseurs

lssh peut fonctionner avec plus que des entrées de configuration SSH statiques. Les fournisseurs lui permettent de récupérer des hôtes depuis des sources d'inventaire externes, de résoudre les secrets juste avant la connexion, et d'utiliser des backends de connexion non-SSH tels que des connecteurs gérés dans le cloud.

Dans v0.10.0, les workflows d'inventaire et de secrets basés sur des fournisseurs sont mieux traités comme beta. L'accès basé sur des connecteurs au-delà du SSH natif est encore expérimental, en particulier pour les environnements d'exécution gérés dans le cloud et les backends non-SSH.

Si vous voulez essayer les flux orientés fournisseurs localement, commencez par ces démos :

• demo/README.md : SSH de base, chaînes de proxy et exemples de workflow multi-hôtes généraux
• demo-telnet-provider/README.md : flux connecteur telnet géré par fournisseur, incluant l'accès telnet direct et telnet derrière un double saut SSH

Pour un aperçu de l'architecture et du protocole des fournisseurs, commencez par provider/README.md. Les détails par catégorie sont également documentés sous inventory, connector, secret et mixed.

Fournisseurs inclus

Ces implémentations de fournisseurs sont actuellement incluses dans ce dépôt.

Inventory

Connector

Mixed

Secret

Outils de la suite lssh

Le projet lssh inclut plusieurs outils pour des workflows centrés sur SSH.

Documentation

• docs/README.md : index de la documentation
• cmd/lssh/README.md : détails de la commande lssh, transfert et utilisation du rc local
• cmd/README.md : aperçu des commandes
• CONTRIBUTING.md : directives de développement et de contribution

Projets connexes

• go-sshlib : bibliothèque Go pour les connexions SSH, l'exécution de commandes et les shells interactifs
• tvxterm : tvxterm fournit des widgets de terminal pour tview
• boco : chercheur flou de fonctions shell Bash

Alternatives

Si vous évaluez lssh, ces projets méritent également un coup d'œil. Ils chevauchent certaines parties de la suite, mais chacun couvre généralement une partie plus restreinte du workflow global.

En quoi la suite lssh est différente

• lssh combine la sélection d'hôtes, le SSH interactif, l'exécution de commandes parallèles, le transfert et les cibles basées sur des connecteurs/fournisseurs.
• lsshell se concentre sur les workflows shell interactifs parallèles plutôt que de simplement lancer plusieurs terminaux.
• lscp, lsftp et lssync couvrent le transfert de fichiers et la synchronisation en tant que commandes de première classe dans la même suite.
• lsmux fournit un espace de travail SSH basé sur des panneaux plutôt que seulement un templating de sessions.
• lspipe rend les hôtes sélectionnés réutilisables depuis des pipelines locaux et de l'automatisation.

Licence

MIT

Auteur

blacknon