LABCDE · SSH & SFTP Manager

Введение

LABCDE решает простую задачу: держать все рабочие серверы в одном месте и давать к ним быстрый доступ. Вы один раз сохраняете параметры подключения, а дальше открываете терминал или файловый менеджер в пару кликов, не держа в голове адреса, порты, логины и ключи.

Всё работает в браузере. Не нужно ставить PuTTY, отдельный SFTP-клиент или настраивать туннели. Приложение можно установить как отдельное окно (режим приложения), и тогда оно открывается с рабочего стола без адресной строки.

Что умеет приложение

• Хранит SSH и SFTP подключения с авторизацией по паролю или по приватному ключу.
• Открывает полноценный терминал на сервере прямо во вкладке браузера.
• Показывает файлы сервера, позволяет загружать, скачивать, переименовывать и удалять их.
• Редактирует текстовые файлы и конфиги со встроенной подсветкой синтаксиса.
• Создаёт и распаковывает архивы на стороне сервера.
• Группирует серверы тегами и ищет их по имени и адресу.

Как устроен экран

Слева расположена панель навигации с разделами Хосты, Новый хост, Терминал, Файлы (SFTP) и Документация. В самом низу панели находится карточка вашего профиля, переключатель светлой и тёмной темы и кнопка выхода.

Сверху идёт строка вкладок. Каждый экран, будь то список серверов, терминал или файловый менеджер, открывается отдельной вкладкой, поэтому можно одновременно держать несколько сессий и переключаться между ними.

Учётная запись

Доступ к приложению защищён логином и паролем. Учётная запись личная: серверы, пароли и ключи одного пользователя недоступны другим.

Регистрация

1. На странице входа переключитесь на форму регистрации.
2. Придумайте логин. Допустимы латинские буквы, цифры, точка, дефис и подчёркивание, длина от 3 до 32 символов.
3. Задайте пароль длиной не менее 8 символов. Пробелы в начале и в конце не допускаются, слишком простые пароли отклоняются.
4. Нажмите кнопку регистрации. После успеха вы сразу попадаете в рабочее пространство.

Вход и сессия

В дальнейшем вы входите тем же логином и паролем. После входа выдаётся токен доступа со сроком жизни 24 часа. Когда срок истекает, приложение попросит войти заново. Если несколько раз подряд ввести неверный пароль, вход на короткое время блокируется, это защита от перебора. Просто подождите минуту и повторите попытку.

Выход

Кнопка выхода находится в левом нижнем углу, рядом с переключателем темы. Выход завершает текущую сессию на этом устройстве.

Рабочее пространство и вкладки

Главный экран это рабочее пространство с вкладками. Список серверов, форма нового хоста, терминалы и файловые менеджеры открываются вкладками в верхней строке. Набор открытых вкладок сохраняется и восстанавливается при следующем заходе, поэтому вы продолжаете с того места, где остановились.

Действия с вкладками

• Перетаскивайте вкладки мышью, чтобы изменить их порядок.
• Крестик на вкладке закрывает её.
• Кнопка с плюсом справа открывает меню новых вкладок: Список хостов, Новый хост, Терминал (SSH) и Файлы (SFTP).
• Если вкладок много и они не помещаются по ширине, слева появляются стрелки прокрутки списка.

Когда вы открываете терминал или файлы через меню вкладок, появляется окно выбора сервера из вашего списка. Если серверов ещё нет, приложение предложит создать первый через раздел Новый хост.

Список хостов

Хост это сохранённое подключение к серверу. Раздел Хосты показывает все ваши серверы карточками. На карточке видно название, адрес в формате пользователь и хост, а также метку способа входа: PWD для пароля или KEY для приватного ключа.

Поиск и фильтр по тегам

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

Быстрые действия на карточке

Наведите курсор на карточку, и в правом нижнем углу появятся три кнопки: подключиться, то есть открыть терминал, открыть файлы по SFTP и показать подробности. Двойной клик по карточке сразу открывает терминал, это самый быстрый способ подключиться.

Подробности, редактирование и удаление

Одиночный клик по карточке открывает панель подробностей. В ней собраны параметры сервера и кнопки Редактировать, Открыть файлы и Удалить. Удаление убирает только запись о подключении из LABCDE. Сам сервер и данные на нём не затрагиваются.

Добавление и редактирование подключения

Форма создания открывается из раздела Новый хост или кнопкой создания на странице со списком. Та же форма используется для редактирования существующего подключения.

Основные поля

1. Название. Любое понятное вам имя, например prod-web-01. Используется только в интерфейсе.
2. Адрес. Домен или IP-адрес сервера.
3. Порт. По умолчанию 22, измените, если SSH слушает другой порт.
4. Пользователь. Имя учётной записи на сервере, например root.

Способ входа

Переключатель предлагает два варианта: Пароль и Приватный ключ. Для входа по паролю достаточно указать пароль пользователя сервера. Для входа по ключу вставьте приватный ключ в формате PEM или OpenSSH в соответствующее поле, а если ключ защищён, заполните поле Парольная фраза.

Описание и теги

Поле описания подходит для заметок: назначение сервера, ответственный, любая полезная информация. Теги это короткие метки, например prod, web или eu. По ним удобно фильтровать список. Тег добавляется вводом и подтверждается клавишей Enter или запятой.

Терминал

Терминал это полноценная интерактивная SSH-сессия в браузере. Откройте его кнопкой подключения на карточке хоста, двойным кликом по карточке или через раздел Терминал с выбором сервера из списка.

Строка состояния

Рядом с именем сервера находится цветная точка состояния. Она показывает, идёт ли подключение, установлена ли связь или возникла ошибка. В строке также есть кнопка переподключения, которая сбрасывает сессию и открывает её заново, и кнопка перехода к файлам того же сервера.

Завершение сессии

Сессия закрывается автоматически после длительного простоя, по умолчанию это 30 минут без активности. Если соединение оборвалось или было закрыто, нажмите переподключение, чтобы начать заново.

Файлы: обзор и навигация

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

Перемещение по папкам

• Хлебные крошки в адресной строке показывают текущий путь. По любому сегменту можно кликнуть и перейти на этот уровень.
• Кнопка с домиком возвращает в корневую папку, стрелка ведёт на уровень выше.
• Двойной клик по папке открывает её, строка Назад в начале списка поднимает на уровень выше.
• Кнопка копирования пути кладёт текущий путь в буфер обмена.

Вид, сортировка и фильтр

• Переключатель вида меняет отображение между списком и плиткой.
• Клик по заголовку колонки сортирует файлы по имени, размеру или дате изменения, повторный клик меняет направление сортировки.
• Поле фильтра отбирает в текущей папке файлы, имя которых содержит введённый текст.

Создание файлов и папок

Кнопка Создать в панели инструментов открывает меню с двумя пунктами: Файл и Папка. Те же команды доступны в контекстном меню по клику правой кнопкой на пустом месте списка.

1. Нажмите Создать и выберите Файл или Папка.
2. Введите имя в появившемся окне.
3. Подтвердите создание.

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

Если вы создали текстовый файл, он сразу открывается в редакторе, чтобы можно было наполнить его содержимым.

Загрузка файлов

Загрузка собрана в отдельном меню у кнопки Загрузить. В нём есть кнопка выбора файлов, список текущих загрузок с прогрессом и возможность отменить любую из них. На самой кнопке отображается счётчик активных загрузок.

Способы добавить файлы

• Нажмите Загрузить, затем Выбрать файлы и отметьте нужные в окне выбора.
• Перетащите файлы прямо в окно браузера. Появится подсвеченная зона, отпустите файлы над ней.

Как идёт загрузка

• Файлы загружаются по очереди, один за другим. Вся очередь видна сразу.
• Полоса прогресса показывает процент отправки на сервер приложения, затем короткую фазу записи файла на удалённый хост.
• Любую загрузку можно отменить кнопкой рядом с ней, остальные продолжатся.

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

Скачивание и архивы

Скачать один файл

Команда Скачать есть в контекстном меню файла. Двойной клик по файлу, который нельзя показать в браузере, также предложит его скачать.

Скачать несколько объектов архивом

Выделите несколько файлов или папок, и появится панель групповых действий с кнопкой Скачать архивом. Можно выбрать формат: tar.gz, zip, tar.bz2 или tar. Архив собирается на сервере и скачивается одним файлом, на самом сервере он не остаётся.

Создать архив на сервере

Команда Сжать на сервере упаковывает выбранные объекты в архив прямо в текущей папке. Доступны форматы ZIP, tar.gz, tar.bz2 и tar. Это удобно, когда архив нужен на самом сервере, а не у вас на устройстве.

Распаковать архив

Для существующего архива в контекстном меню есть команда Распаковать сюда. Содержимое разворачивается в текущую папку.

Просмотр и редактирование

Двойной клик по файлу открывает встроенный просмотрщик. Он сам выбирает режим в зависимости от типа файла.

• Изображения показываются предпросмотром.
• Текстовые файлы, код и конфиги открываются в редакторе с подсветкой синтаксиса для распространённых форматов.
• Файлы, которые нельзя отобразить, предлагается скачать.

Редактор

В редакторе работают нумерация строк, перенос длинных строк и поиск по тексту. Изменения сохраняются кнопкой Сохранить или сочетанием клавиш Ctrl и S, а на Mac Command и S. После сохранения список обновляется.

Переименование, копирование и удаление

Эти команды находятся в контекстном меню по правому клику на файле или папке: Переименовать, Дублировать, Копировать путь, Свойства и Переместить в корзину.

Мгновенный отклик

Изменения применяются сразу, без ожидания ответа сервера. Список обновляется на месте, а если сервер вернёт ошибку, элемент возвращается в прежнее состояние и появляется сообщение о причине. Так интерфейс остаётся отзывчивым даже при медленном соединении.

Удаление

Команда Переместить в корзину удаляет файл, а для папок работает рекурсивно вместе со всем содержимым. Действие требует подтверждения. Будьте внимательны с системными каталогами.

Свойства и права

Окно Свойства показывает путь, тип, размер, дату изменения и права доступа. Пункты меню, на которые у вас нет прав, остаются неактивными и подсказывают причину. Например, редактирование требует права на запись, а вход в папку требует права на исполнение.

Выделение и горячие клавиши

Файлы можно выделять по одному, диапазоном с зажатой клавишей Shift или рамкой при протягивании мышью по пустому месту. Для выделенной группы доступна панель действий с командами Скачать архивом, Сжать в ZIP, Копировать пути и Удалить.

Сочетания клавиш

• Enter открывает выбранный элемент.
• F2 переименовывает выбранный элемент.
• Delete или Backspace удаляет выделенное.
• Ctrl и A, на Mac Command и A, выделяет всё в текущей папке.
• Esc снимает выделение.
• Ctrl и R, на Mac Command и R, обновляет содержимое папки.
• Ctrl и S, на Mac Command и S, сохраняет файл в редакторе.

Сохранение состояния

Приложение старается возвращать вас туда, где вы были. Набор открытых вкладок сохраняется между сеансами. Файловый менеджер запоминает папку, в которой вы находитесь, и открытый файл, поэтому обновление страницы возвращает вас на то же место, а ссылку на конкретную папку можно сохранить в закладках.

Выбор светлой или тёмной темы тоже запоминается и применяется при следующих входах.

Тема и установка приложения

Светлая и тёмная тема

В левом нижнем углу есть переключатель темы. Выбор сохраняется. Тёмная тема удобна при работе в условиях слабого освещения и снижает нагрузку на глаза.

Установка как приложение

LABCDE можно установить как отдельное приложение. В браузере, который это поддерживает, появится предложение установки. После установки сервис открывается в собственном окне без адресной строки и доступен с рабочего стола, как обычная программа.

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

Безопасность и хранение данных

Безопасность учётных данных это основа сервиса, поэтому стоит понимать, как именно хранятся секреты.

• Пароль вашей учётной записи хранится в виде криптографического хэша. В исходном виде он нигде не сохраняется и не может быть восстановлен.
• Пароли, приватные ключи и парольные фразы от серверов шифруются перед записью в базу данных. Без ключа шифрования их нельзя прочитать, даже имея доступ к базе.
• Доступ к подключениям есть только у их владельца. Чужие серверы и секреты не видны другим пользователям.
• Сессия защищена токеном с ограниченным сроком жизни.

Для доступа из интернета сервис размещают за HTTPS, чтобы трафик между браузером и сервером был зашифрован. Это задача администратора при развёртывании.

Решение проблем

Не удаётся подключиться к серверу

Вместо пустого экрана приложение показывает конкретную причину. Чаще всего это одна из трёх ситуаций:

• Сервер недоступен. Проверьте адрес, порт и наличие сети до сервера.
• Не удалось авторизоваться. Проверьте логин, пароль или приватный ключ в параметрах хоста.
• Не совпал ключ сервера. Такое бывает после переустановки сервера.

На экране ошибки есть кнопки Повторить, Параметры сервера и возврат к списку хостов, чтобы быстро проверить настройки и попробовать снова.

Папка выглядит пустой

Если папка действительно пуста, приложение предложит создать файл или папку либо загрузить данные. Если же доступ к папке запрещён, будет показано сообщение об ошибке, а не ложная надпись о пустой папке.

Архивация завершается ошибкой

Скорее всего, на сервере нет нужной утилиты. Установите её вручную или выберите формат tar.gz. Текст ошибки подскажет, какой именно команды не хватает.

Сессия неожиданно завершилась

Терминал и соединения закрываются после долгого простоя. Это нормальное поведение. Откройте сессию заново кнопкой переподключения.

Частые вопросы

Видит ли кто-то ещё мои серверы и пароли

Нет. Подключения привязаны к вашей учётной записи, секреты хранятся в зашифрованном виде, другие пользователи к ним доступа не имеют.

Что произойдёт с сервером, если удалить хост

Ничего. Удаляется только запись о подключении в LABCDE. Сервер и его данные остаются нетронутыми.

Можно ли работать с нескольких устройств

Да. Достаточно войти под своей учётной записью. Подключения хранятся на сервере приложения и доступны после входа с любого устройства.

Почему документация открывается отдельной страницей

Так удобнее читать руководство рядом с рабочим окном и держать его открытым, пока вы выполняете описанные шаги. Со страницы документации руководство можно скачать в формате Word.