lssh

ls + ssh = lssh

lssh — это нативный терминальный набор инструментов для удалённого доступа, предназначенный для работы с SSH, инвентаризацией в облаке и коннекторами от провайдеров.

Он позволяет выбирать хосты из конфигурации OpenSSH, конфигурации lssh или инвентаризации провайдеров, а затем управлять ими через собственный SSH или бэкенды коннекторов, такие как AWS SSM, EC2 Instance Connect Endpoint, WinRM, Telnet и пользовательские провайдеры.

Используйте его для интерактивных оболочек, параллельных команд, mux-рабочих пространств, передачи файлов, синхронизации, монтирования и мониторинга. Хосты, работающие через коннектор, предоставляют только те операции, которые поддерживает их коннектор.

• работает с вашей существующей конфигурацией SSH
• интерактивный выбор хостов
• параллельное выполнение команд

Установка

Homebrew

brew install blacknon/lssh/lssh

Go

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

Функции инвентаризации и коннекторов от провайдеров используют отдельные исполняемые файлы провайдеров. Если вы устанавливаете только cmd/lssh, эти бинарные файлы провайдеров не устанавливаются автоматически.

Для локальной разработки установите встроенные провайдеры с помощью:

mise run provider_install

Для сборок релиза установите либо комплексный архив lssh-complete_*, либо добавьте соответствующий архив lssh-providers_* из GitHub Releases.

Дополнительные сведения об установке, включая другие варианты и платформенные особенности, см. в docs/install.md.

Быстрый старт

Уже используете ~/.ssh/config?

Просто выполните:

lssh

Хотите сгенерировать конфигурацию lssh из существующей конфигурации SSH?

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

Базовый рабочий процесс

lssh построен на простом рабочем процессе:

1. список хостов из конфигурации SSH
2. выбор одного или нескольких хостов
3. открытие оболочки или выполнение команды

Примеры

Вы также можете напрямую указать один хост, если уже знаете, куда подключаться:

lssh -H my-server

Подробнее о форматах конфигурации и настройках см. в cmd/lssh/README.md.

Демонстрация

Хотите быстро попробовать lssh с готовой к запуску локальной средой? Начните с demo/README.md. Для сценария с коннектором telnet и многоволновым провайдером используйте demo-telnet-provider/README.md.

Конфигурация OpenSSH и конфигурация lssh

lssh поддерживает как вашу существующую конфигурацию OpenSSH, так и собственный формат конфигурации.

Если вы хотите быстро начать работу, можете продолжать использовать ~/.ssh/config как есть. Если вам нужно больше метаданных о хостах и настроек, ориентированных на рабочий процесс, вы можете перейти на конфигурацию lssh.

Вы также можете сгенерировать конфигурацию lssh из существующей конфигурации SSH:

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

Даже после перехода на конфигурацию lssh вы можете по-прежнему указывать на существующую конфигурацию OpenSSH и загружать хосты оттуда:

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

Подробнее о форматах конфигурации и настройках см. в docs/configuration.md.

Провайдеры

lssh может работать не только со статическими записями конфигурации SSH. Провайдеры позволяют получать хосты из внешних источников инвентаризации, разрешать секреты непосредственно перед подключением и использовать не-SSH бэкенды подключения, такие как облачные управляемые коннекторы.

В версии v0.10.0 рабочие процессы с инвентаризацией через провайдеров и секретами считаются beta. Доступ через коннекторы, отличный от собственного SSH, остаётся экспериментальным, особенно для облачных управляемых сред выполнения и не-SSH бэкендов.

Если вы хотите попробовать потоки, ориентированные на провайдеров, локально, начните с этих демонстраций:

• demo/README.md: основные примеры SSH, цепочек прокси и многопользовательских рабочих процессов
• demo-telnet-provider/README.md: поток с управляемым провайдером коннектором telnet, включая прямой доступ по telnet и telnet за двойным SSH-прыжком

Обзор архитектуры и протокола провайдера начните с provider/README.md. Подробности по категориям также описаны в inventory, connector, secret и mixed.

Встроенные провайдеры

В данный репозиторий включены следующие реализации провайдеров.

Инвентаризация

Коннектор

Смешанные

Секрет

Инструменты в наборе lssh

Проект lssh включает несколько инструментов для рабочих процессов, ориентированных на SSH.

Документация

• docs/README.md: индекс документации
• cmd/lssh/README.md: подробности команды lssh, переадресация и использование локального rc
• cmd/README.md: обзор команд
• CONTRIBUTING.md: рекомендации по разработке и внесению вклада

Связанные проекты

• go-sshlib: библиотека Go для SSH-подключений, выполнения команд и интерактивных оболочек
• tvxterm: tvxterm предоставляет терминальные виджеты для tview
• boco: средство нечёткого поиска для функций bash.

Альтернативы

Если вы оцениваете lssh, стоит также взглянуть на эти проекты. Они пересекаются с частями набора, но каждый обычно охватывает более узкую часть общего рабочего процесса.

Чем набор lssh отличается

• lssh объединяет выбор хостов, интерактивный SSH, параллельное выполнение команд, переадресацию и цели, поддерживаемые коннекторами и провайдерами.
• lsshell фокусируется на параллельных интерактивных рабочих процессах оболочки, а не просто на запуске множества терминалов.
• lscp, lsftp и lssync охватывают передачу файлов и синхронизацию как команды первого уровня в том же наборе.
• lsmux предоставляет панельное рабочее пространство SSH, а не только шаблонизацию сессий.
• lspipe позволяет повторно использовать выбранные хосты из локальных конвейеров и автоматизации.

Лицензия

MIT

Автор

blacknon