matthart1983/esshРасширенный SSH-клиент с TUI — управление подключениями, ключами и сессиями
<h1 align="center">ESSH</h1>
<p align="center">
<strong>SSH-рабочее пространство с постоянными сессиями и живыми панелями состояния.</strong>
</p>
<p align="center">
<a href="https://github.com/matthart1983/essh/releases/latest"><img src="https://img.shields.io/github/v/release/matthart1983/essh" alt="Latest release"></a>
<a href="https://github.com/matthart1983/essh/releases"><img src="https://img.shields.io/github/downloads/matthart1983/essh/total" alt="Release downloads"></a>
<a href="https://github.com/matthart1983/essh/actions/workflows/ci.yml"><img src="https://github.com/matthart1983/essh/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI status"></a>
<a href="#install"><img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-blue" alt="Platforms: macOS and Linux"></a>
<a href="https://github.com/matthart1983/essh/releases/latest"><img src="https://img.shields.io/badge/architecture-x86__64%20%7C%20ARM64-blue" alt="Architectures: x86_64 and ARM64"></a>
<a href="https://github.com/matthart1983/essh/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"></a>
</p>
Поддерживайте удалённые оболочки работающими при обрывах соединения, переключайтесь между хостами с помощью клавиш или мыши и проверяйте состояние системы, не покидая терминал.
ESSH использует OpenSSH для подключений и tmux, чтобы ваша работа продолжалась.
## Посмотрите в действии
[](https://github.com/matthart1983/essh/releases/download/v0.4.1/essh-v3-demo.mp4)
**[Смотрите 42-секундное демо](https://github.com/matthart1983/essh/releases/download/v0.4.1/essh-v3-demo.mp4)** ·
[Скачать запись для браузера](https://github.com/matthart1983/essh/releases/download/v0.4.1/essh-v3-replay.html)
Изучайте диски с помощью `df` и `lsblk`, находите занятые процессы с помощью `ps`, отслеживайте активность системы с помощью `vmstat`, проверяйте сокеты и интерфейсы с помощью `ss` и `ip`.
В демо показаны переключение темы терминала, боковой, половинный и полный виды состояния, переключение сессий, справка
и восстановление того же удалённого шелла после обрыва соединения.
## Установка
Скачайте бинарный файл для **Linux или macOS**, на **x86_64 или ARM64**, со страницы
[Releases](https://github.com/matthart1983/essh/releases/latest). Распакуйте архив
и поместите `essh` куда-нибудь в ваш `PATH`.
Вам нужны **tmux 3.3+ и OpenSSH локально**, а также **tmux на каждом удалённом хосте**.
Подробные метрики состояния доступны для хостов Linux.
Или соберите из исходников с помощью Rust:
```sh
git clone https://github.com/matthart1983/essh.git
cd essh
cargo build --release
./target/release/essh
```
## Подключение к хосту
ESSH читает хосты из `~/.ssh/config`, своей собственной конфигурации и своего кэша хостов.
Например:
```sshconfig
Host web-01
HostName 192.168.1.20
User deploy
IdentityFile ~/.ssh/id_ed25519
```
Запустите `essh`, выберите хост и нажмите **Enter**. Используйте **/** для фильтрации хостов и
**Esc** для очистки фильтра. Нажмите **a**, чтобы добавить хост, или **e**, чтобы отредактировать его.
OpenSSH выполняет аутентификацию и проверку ключей хоста.
## Ориентирование в интерфейсе
| Клавиша | Действие |
| --- | --- |
| **F1** | Открыть или закрыть справку |
| **F2** | Циклически переключать терминал → боковое состояние → половинное состояние → полное состояние → терминал |
| **F3** | Открыть сессии; выберите сессию или нажмите **n**, чтобы запустить ещё одну |
| **F4** | Вернуться в главное меню, пока сессии продолжают работать |
| **F5 / F6** | Переключиться на предыдущую / следующую сессию |
| **h** на экране хостов | Открыть состояние для выбранного хоста |
| **r** после обрыва соединения | Переподключиться |
| **q** на экране хостов | Выйти из ESSH, пока удалённая работа продолжается |
Щёлкайте по вкладкам сессий и элементам навигации для переключения видов. Щёлкните по строке, чтобы выбрать
её; двойной щелчок — чтобы подключиться или переключиться. Используйте колесо мыши для прокрутки, щёлкайте по панелям,
чтобы сфокусировать их, и перетаскивайте разделители, чтобы изменять их размер.
Если ваша клавиатура использует ряд функциональных клавиш для яркости или громкости, удерживайте **Fn**
при нажатии F-клавиши или включите стандартные функциональные клавиши в настройках клавиатуры.
Элементы навигации также кликабельны, а **F1** перечисляет доступные клавиши.
## Ваша оболочка и тема
Удалённые сессии запускают настроенную оболочку входа удалённой учётной записи и загружают её
обычные файлы запуска — zsh, bash, fish или любую другую оболочку, которую использует эта учётная запись.
Ваше приглашение, псевдонимы и привязки клавиш оболочки берутся из этой удалённой учётной записи.
Существующие оболочки сохраняют своё рабочее состояние при переподключении.
По умолчанию ESSH использует цвета вашего терминала. Выберите тему, чтобы изменить цвет переднего плана и фона оболочки
вместе с панелью:
```sh
essh --theme terminal
essh --theme netwatch
essh --theme light
```
Нажмите **t** в меню или видах состояния, или **Ctrl+A**, затем **t** из оболочки,
чтобы открыть выбор темы. Стрелки предпросматривают каждую палитру; **Enter** или щелчок
применяет и сохраняет её. **Esc** отменяет без изменения ваших предпочтений.
Выберите **Terminal**, **Netwatch**, **Light**, **Solarized**, **Dracula**,
**Nord**, **Ocean** или **Sky**. Netwatch использует угольно-серый фон с бирюзовыми
заголовками и зелёными индикаторами. Выбранная тема применяется к меню, видам состояния,
панелям навигации и панелям терминала. Выберите **Terminal**, чтобы восстановить
родные цвета вашего терминала. Программы и приглашения всё ещё могут задавать свои собственные цвета.
Чтобы сохранить предпочтение, задайте `theme = "terminal"` (или другое имя темы) в начале
`~/.essh/config.toml`. Примените его к открытому рабочему пространству с помощью
`essh tmux refresh`; SSH-сессии продолжают работать. Ваш эмулятор терминала управляет
шрифтом и размером шрифта.
## Выбор вида состояния
Нажимайте **F2** для циклического переключения между:
| Вид | Что вы видите |
| --- | --- |
| Терминал | Ваша оболочка с панелями сессий и навигации |
| Боковое состояние | Узкая полоса с трафиком, CPU, памятью, диском и задержкой |
| Половинное состояние | Ваша оболочка и панель, совместно использующие терминал |
| Полное состояние | Сетевой трафик, ядра CPU, память, хранилище, пиры и процессы |
Панели используют тонкие индикаторы и живые показания. Недоступные показания отображаются как **—**;
отключённые хосты чётко помечены. Узкие терминалы пропускают боковые макеты.
На панели:
- **Tab** выбирает панель; **стрелки** и **колесо мыши** прокручивают.
- **i** выбирает сетевой интерфейс; **c / m** сортируют процессы по CPU или памяти.
- **Left / Right** просматривает хосты, включая хосты без подключённой сессии.
- **Esc** закрывает полное состояние и восстанавливает предыдущий боковой вид.
- **F2** из полного состояния возвращает к терминалу с выключенным боковым состоянием.
Для прямого доступа нажмите **Ctrl+A**, отпустите его, затем **h** для полного состояния или
**m** для циклического переключения боковое состояние → половинное состояние → выключено.
## Работа с сессиями и панелями
Используйте **F3**, затем **n**, чтобы открыть ещё одну независимую сессию. Переключайтесь с помощью
**F5 / F6**, выбора сессий или мыши. **F4** возвращает к списку хостов
без завершения ваших сессий.
Идентификаторы сессий переживают локальные перезапуски. Переподключение заново присоединяет удалённую оболочку,
когда она всё ещё существует; если она завершилась, ESSH запускает новую оболочку. Удалённое состояние отключённой
сессии остаётся непроверенным, пока вы не переподключитесь.
**Ctrl+A** управляет локальным tmux. **Ctrl+B** управляет tmux на удалённом хосте.
Нажмите префикс, отпустите его, затем нажмите следующую клавишу:
| Клавиши | Действие |
| --- | --- |
| **Ctrl+B**, затем **%** | Разделить удалённый терминал бок о бок |
| **Ctrl+B**, затем **"** | Разделить удалённый терминал сверху и снизу |
| **Ctrl+B**, затем **стрелка** | Перемещаться между удалёнными панелями |
| **Ctrl+A**, затем **v** | Отправить следующую клавишу напрямую удалённому приложению |
| **Ctrl+A**, затем **x** | Завершить удалённую сессию после подтверждения |
F1–F6 зарезервированы для ESSH. Используйте **Ctrl+A**, затем **v**, когда удалённому приложению
нужна одна из этих клавиш.
## Разработка
```sh
cargo fmt --check
cargo test
cargo clippy --all-targets --all-features -- -D warnings
cargo build --release
ESSH_BIN=target/release/essh python3 scripts/test-tmux-v3.py
```
Проверка живой регрессии использует изолированный SSH-сервер и сокеты tmux.
[Запись демо и проверка](https://github.com/matthart1983/essh/blob/main/docs/demo-v3.md) объясняет, как воспроизвести тур.
Чтобы внести вклад, создайте ветку, внесите изменения, запустите проверки и откройте pull request.
## Лицензия
[MIT](https://github.com/matthart1983/essh/blob/main/LICENSE)